안내서
데이터 더하기
이미 만든 작업공간에 데이터를 더하는 세 가지 길(화면에서, Claude에게 맡겨서, 동료의 결과로)과 더한 데이터를 뺄 수 없는 까닭.
개발 중인 화면
이 페이지에서
포털 화면은 개발 중입니다. 화면의 낱말과 배치는 바뀔 수 있고, 단추가 실행하는 명령은 이미 만들어져 있습니다.
작업하다 보면 데이터가 더 필요해집니다. 이미 만든 작업공간에 데이터를 더할 수 있습니다. 더하기 전에 이 작업공간의 결과를 볼 수 있는 사람이 어떻게 바뀌는지 꼭 보세요. 아이디, 경로, 수는 예시입니다.
화면에서 더하기
-
1단계: [데이터 더하기] 누르기
작업공간에서 [데이터 더하기]를 누릅니다. 새 작업공간을 만들 때와 같은 「이 작업공간에서 쓸 데이터」가 열립니다. 「이미 이 작업공간에 있는 데이터는 회색으로 표시됩니다.」
-
2단계: 더할 데이터 고르기
더할 데이터를 체크합니다. 체크할 때마다 「이 작업공간의 결과를 볼 수 있는 사람」이 바로 바뀌고, 항목마다 「더하면 4개」처럼 보이는 파일 수가 나옵니다.
-
3단계: [데이터 더하기] 누르기
대화 상자 아래의 [데이터 더하기]를 누릅니다. 「데이터를 더했습니다: /tables/labs」가 나옵니다.
ws add-data ws-0012 /tables/labs Added data: /tables/labs (1,256 visible files)Who can see this workspace's results: 2 of 31 people. Admins can always see.Condition: ehr_full and one of ct_research or imaging_all 켜져 있는 작업공간이면 다시 시작하지 않아도 /data에 바로 나타납니다. 표를 더하면 DuckDB 파일도 다시 만들어집니다.
[내 데이터]의 항목이나 동료의 공유 화면에서도 [작업공간에 더하기]로 내 작업공간 하나에 바로 더할 수 있습니다.
Claude에게 맡기기
Claude에게 필요한 데이터를 말하면 Claude는 이렇게 합니다.
- 더할 수 있는 데이터를 찾습니다. 데이터의 이름만 보고, 파일은 승인 전에 읽을 수 없습니다.
- 더하면 결과를 볼 수 있는 사람이 어떻게 바뀌는지 미리 확인해 알려 줍니다.
- 데이터 더하기 요청을 만들고 승인 링크를 줍니다.
데이터는 내가 승인한 다음에야 /data에 나타납니다. Claude가 차례로 쓰는 도구: list_data, preview_add_data, request_add_data.
터미널에서 요청하기
작업공간 터미널에서도 같은 요청을 만들 수 있습니다. 요청이라서, 승인하기 전에는 아무것도 바뀌지 않습니다.
작업공간 터미널에서
synapse ws request add-data /tables/labs 출력 (예시)
Requested approval: a-0031Data to add: /tables/labsVisible files: from 1,252 to 1,256Who can see this workspace's results: from 4 to 2 of 31 people. Admins can always see.It runs after the researcher approves it in the portal: https://app.example.org/approve/a-0031 동료의 결과를 데이터로
동료가 내보낸 결과도 데이터로 더할 수 있습니다. 볼 수 있는 결과만 더할 수 있습니다.
- 공유 링크를 Claude에게. 동료가 보낸 공유 링크를 Claude에게 붙여 넣으면, 그 결과를 이 작업공간에 더하는 요청이 됩니다.
- 공유 화면에서. 공유 링크를 열고 [작업공간에 더하기]를 누른 다음 더할 작업공간을 고릅니다.
- 명령으로. 데이터 경로 자리에 결과 ID나 공유 링크를 그대로 씁니다.
ws add-data ws-0012 r-0137더한 결과는 /data/releases/ 아래에 결과 ID 이름의 폴더로, 읽기 전용으로 나타납니다. 더한 결과는 다음에 내보내는 결과의 출처로 이어집니다.
더한 데이터는 뺄 수 없습니다
작업공간은 한 번이라도 볼 수 있었던 데이터를 기억합니다. 그 데이터로 만든 중간 파일이 작업 폴더에 남아 있을 수 있기 때문입니다. 그래서 더한 데이터는 뺄 수 없고, 이 작업공간의 결과를 볼 수 있는 사람도 좁아진 채로 남습니다. 빼고 싶으면 새 작업공간을 만드세요.
관리자가 권한을 회수해 /data에서 파일이 사라져도, 이 작업공간이 그 데이터를 썼다는 기록은 남습니다.
더하지 못할 때
| 화면에 나오는 말 | 뜻과 할 일 |
|---|---|
| 이미 이 작업공간에 있는 데이터입니다. | 새 데이터만 더할 수 있습니다. |
| 같은 요청이 이미 기다리고 있습니다: a-0031 | 그 요청을 승인하거나 거절하세요. |
| 기다리는 요청 상한에 닿았습니다. | 작업공간마다 기다리는 요청은 기본 10개까지입니다. 기다리는 요청을 먼저 처리하세요. |
| 보관한 작업공간입니다: ws-0012 | 보관을 푼 다음 더하세요. |
| 주인이 볼 수 없는 결과입니다: r-0137 | 작업공간 주인이 볼 수 있는 결과만 더할 수 있습니다. |