의료 검색 데이터 스토어 관리

의료 데이터 스토어를 만들고 FHIR R4 데이터를 가져온 후 다음 작업을 실행하여 데이터 스토어를 관리할 수 있습니다.

• 일괄 가져오기 취소
• 스트리밍 일시중지 또는 재개
• 스트리밍된 데이터의 수동 동기화:
  • 모든 문서 동기화
  • 선택한 문서 동기화하기
  • 지정된 타임스탬프 이후의 문서 동기화
• 스트리밍 삭제

일괄 가져오기 취소

진행 중인 일괄 가져오기 작업을 취소하려면 다음 단계를 따르세요.

REST

1. 일괄 가져오기 작업의 작업 ID를 찾습니다. 이 작업 ID는 데이터 스토어에 데이터를 가져올 때 반환된 ID와 동일합니다. 작업 ID를 이미 알고 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 가져오기를 취소할 데이터 스토어를 클릭합니다.

   3. 데이터 스토어 세부정보 페이지에서 세부정보 보기를 클릭합니다. 이 작업은 가져오기 작업이 생성되고 진행 중인 후에만 사용할 수 있습니다.

   4. 활동 로그 세부정보 패널에서 작업 ID를 가져옵니다.

2. 진행 중인 일괄 가져오기를 취소합니다.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/OPERATION_ID:cancel" \
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • DATA_STORE_ID: 진행 중인 일괄 가져오기를 취소하려는 데이터 스토어의 ID입니다.
   • IMPORT_OPERATION_ID: 취소하려는 진행 중인 일괄 가져오기 작업의 ID입니다.

   작업이 취소되면 빈 JSON 객체가 반환됩니다.

스트리밍 일시중지 또는 재개

스트리밍 작업을 일시중지하거나 재개하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder

2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

   데이터 스토어 페이지에는 세부정보와 함께 Google Cloud프로젝트에 있는 데이터 스토어 목록이 표시됩니다.

3. 스트리밍을 일시중지하거나 재개할 데이터 스토어를 클릭합니다.

4. 데이터 커넥터의 데이터 페이지에서 데이터 스트리밍 일시중지를 클릭하여 스트리밍을 일시중지하거나 데이터 스트리밍 재개를 클릭하여 데이터 스트리밍을 재개합니다.

REST

1. 컬렉션 ID를 찾습니다. 컬렉션 ID가 이미 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 스트리밍을 일시중지하거나 재개하려는 데이터 커넥터의 이름을 클릭합니다.

   3. 데이터 커넥터의 데이터 페이지에서 컬렉션 ID를 가져옵니다.

2. 데이터 커넥터 내에서 스트리밍을 일시중지하거나 재개합니다.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector?updateMask=auto_run_disabled" \
   -d ' {
     "name":"projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector",
     "autoRunDisabled": PAUSE_STREAM_TRUE|FALSE
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • COLLECTION_ID: 스트리밍을 일시중지하거나 재개하려는 데이터 커넥터의 ID입니다.
   • PAUSE_STREAM_TRUE|FALSE: true로 설정하면 스트리밍을 일시중지하고 false로 설정하면 일시중지된 스트리밍을 재개하는 불리언입니다.

   응답

   다음과 비슷한 JSON 응답이 수신됩니다. autoRunDisabled 필드는 데이터 스트리밍을 일시중지할 때만 반환됩니다.

   {
     "name": "projects/PROJECT_NUMBER/locations/us/collections/COLLECTION_ID/dataConnector",
     "state": "ACTIVE",
     "dataSource": "gcp_fhir",
     "params": {
       "instance_uri": "projects/PROJECT_ID/locations/us-central1/datasets/synthea-mock"
     },
     "refreshInterval": "0s",
     "entities": [
       {
         "entityName": "DATA_STORE_NAME",
         "dataStore": "projects/PROJECT_NUMBER/locations/us/collections/default_collection/dataStores/DATA_STORE_ID"
       }
     ],
     "createTime": "DATA_STORE_CREATE_TIMESTAMP",
     "syncMode": "STREAMING",
     "autoRunDisabled": true,
     "actionConfig": {},
     "latestPauseTime": "PAUSE_TIMESTAMP",
     "lastSyncTime": "LAST_SYNC_TIMESTAMP",
     "updateTime": "UPDATE_TIMESTAMP",
     "identityScheduleConfig": {}
   }
   

스트리밍 데이터 스토어의 모든 문서 동기화

지원되는 FHIR 리소스 유형이 있는 모든 문서의 백필을 수동으로 트리거할 수 있습니다. 이렇게 하면 Vertex AI Search 데이터 스토어를 Cloud Healthcare API FHIR 스토어와 최신 상태로 유지할 수 있습니다. 데이터 동기화는 스트리밍 데이터 스토어에서만 가능합니다.

스트리밍 데이터 스토어의 모든 문서를 동기화하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder

2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

   데이터 스토어 페이지에는 세부정보와 함께 Google Cloud프로젝트에 있는 데이터 스토어 목록이 표시됩니다.

3. 동기화할 데이터 커넥터의 데이터를 선택합니다.

4. 데이터 스토어 세부정보 페이지에서 다시 가져오기를 클릭합니다.

5. 데이터 다시 가져오기 창에서 아이콘을 클릭하고 데이터를 동기화할 이후 날짜를 선택한 다음 닫기를 클릭합니다.

6. 다시 가져올 리소스 섹션에서 모든 FHIR 리소스 유형을 선택합니다. 이렇게 하면 지원되는 FHIR 리소스 유형으로 모든 문서가 백필됩니다.

7. 다시 가져오기를 클릭합니다.

REST

1. 컬렉션 ID를 찾습니다. 컬렉션 ID가 이미 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 스트리밍을 일시중지하거나 재개하려는 데이터 커넥터의 이름을 클릭합니다.

   3. 데이터 커넥터의 데이터 페이지에서 컬렉션 ID를 가져옵니다.

2. 지원되는 FHIR 리소스 유형으로 모든 문서의 동기화 또는 백필을 트리거합니다.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {}
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • COLLECTION_ID: 스트리밍을 일시중지하거나 재개하려는 컬렉션의 ID입니다.

   응답

   다음과 비슷한 JSON 응답이 수신됩니다. 응답에는 커넥터 실행 ID가 포함됩니다. state 필드는 동기화 실행 상태 중 하나를 보여줍니다. 자세한 내용은 ConnectorRun을 참고하세요.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   startConnectorRun 메서드가 실행 중일 때 다시 호출하면 오류가 발생할 수 있습니다.

스트리밍 데이터 스토어에서 선택적 문서 동기화

지원되는 FHIR 리소스 유형으로 선택한 문서를 가져올 수 있습니다. 이는 특정 FHIR 리소스 유형의 문서로 Vertex AI Search 데이터 스토어를 업데이트하려는 경우에 유용합니다. 데이터 동기화는 스트리밍 데이터 스토어에서만 가능합니다.

스트리밍 데이터 스토어에서 선택한 문서를 동기화하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder

2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

   데이터 스토어 페이지에는 세부정보와 함께 Google Cloud프로젝트에 있는 데이터 스토어 목록이 표시됩니다.

3. 동기화할 데이터 커넥터의 데이터를 선택합니다.

4. 데이터 스토어 세부정보 페이지에서 다시 가져오기를 클릭합니다.

5. 데이터 다시 가져오기 창에서 아이콘을 클릭하고 데이터를 동기화할 이후 날짜를 선택한 다음 닫기를 클릭합니다.

6. 다시 가져올 리소스 섹션에서 가져올 FHIR 리소스 유형을 모두 선택합니다. 이렇게 하면 선택한 FHIR 리소스 유형의 모든 문서가 가져옵니다.

7. 다시 가져오기를 클릭합니다.

REST

1. 컬렉션 ID를 찾습니다. 컬렉션 ID가 이미 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 스트리밍을 일시중지하거나 재개하려는 데이터 커넥터의 이름을 클릭합니다.

   3. 데이터 커넥터의 데이터 페이지에서 컬렉션 ID를 가져옵니다.

2. 지원되는 FHIR 리소스 유형으로 선택적 문서의 동기화 또는 백필을 트리거합니다.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {},
     "healthcareFhirResourceTypes": "Patient",
     "healthcareFhirResourceTypes": "RESOURCE_TYPE"
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • COLLECTION_ID: 스트리밍을 일시중지하거나 재개하려는 컬렉션의 ID입니다.
   • RESOURCE_TYPE: 백필하려는 FHIR 문서의 리소스 유형입니다.

   응답

   다음과 비슷한 JSON 응답이 수신됩니다. 응답에는 커넥터 실행 ID가 포함됩니다. state 필드는 동기화 실행 상태 중 하나를 보여줍니다. 자세한 내용은 ConnectorRun을 참고하세요.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   startConnectorRun 메서드가 실행 중일 때 다시 호출하면 오류가 발생할 수 있습니다.

스트리밍 데이터 스토어에서 지정된 타임스탬프 이후의 문서 동기화

지정된 타임스탬프 이후 지원되는 FHIR 리소스 유형으로 선택적 문서를 가져올 수 있습니다. 데이터 동기화는 스트리밍 데이터 스토어에서만 가능합니다.

지정된 타임스탬프 이후의 문서를 동기화하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder

2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

   데이터 스토어 페이지에는 세부정보와 함께 Google Cloud프로젝트에 있는 데이터 스토어 목록이 표시됩니다.

3. 동기화할 데이터 커넥터의 데이터를 선택합니다.

4. 데이터 스토어 세부정보 페이지에서 다시 가져오기를 클릭합니다.

5. 데이터 다시 가져오기 창에서 아이콘을 클릭하고 데이터를 동기화할 이후 날짜를 선택한 다음 닫기를 클릭합니다.

6. 다시 가져올 리소스 섹션에서 가져올 FHIR 리소스 유형을 모두 선택합니다. 이렇게 하면 선택한 FHIR 리소스 유형의 모든 문서가 가져옵니다.

7. 다시 가져오기를 클릭합니다.

REST

1. 컬렉션 ID를 찾습니다. 컬렉션 ID가 이미 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 스트리밍을 일시중지하거나 재개하려는 데이터 커넥터의 이름을 클릭합니다.

   3. 데이터 커넥터의 데이터 페이지에서 컬렉션 ID를 가져옵니다.

2. 지원되는 FHIR 리소스 유형으로 모든 문서의 동기화 또는 백필을 트리거합니다.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {
       "seconds": TIMESTAMP_SECONDS,
       "nanos": TIMESTAMP_NANOS
     }
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • COLLECTION_ID: 스트리밍을 일시중지하거나 재개하려는 컬렉션의 ID입니다.
   • TIMESTAMP_SECONDS: 문서를 가져올 시점부터 경과된 시간(초)입니다. 타임스탬프 형식을 따릅니다.
   • TIMESTAMP_NANOS: 문서를 가져올 시점부터 경과된 시간(초)입니다. 타임스탬프 형식을 따릅니다.

   응답

   다음과 비슷한 JSON 응답이 수신됩니다. 응답에는 커넥터 실행 ID가 포함됩니다. state 필드는 동기화 실행 상태 중 하나를 보여줍니다. 자세한 내용은 ConnectorRun을 참고하세요.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   startConnectorRun 메서드가 실행 중일 때 다시 호출하면 오류가 발생할 수 있습니다.

스트리밍 삭제

스트리밍 작업을 삭제하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder

2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

   데이터 스토어 페이지에는 세부정보와 함께 Google Cloud프로젝트에 있는 데이터 스토어 목록이 표시됩니다.

3. 데이터 스토어 목록에서 삭제하려는 데이터 커넥터의 옵션 더보기를 클릭합니다.

4. 삭제를 클릭합니다.

5. 대화상자가 표시되면 예를 입력하고 확인을 클릭하여 삭제를 확인합니다.

REST

1. 컬렉션 ID를 찾습니다. 컬렉션 ID가 이미 있는 경우 다음 단계로 건너뜁니다.

   1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.

      데이터 스토어 페이지로 이동

   2. 스트리밍을 일시중지하거나 재개하려는 데이터 커넥터의 이름을 클릭합니다.

   3. 데이터 커넥터의 데이터 페이지에서 컬렉션 ID를 가져옵니다.

2. 지원되는 FHIR 리소스 유형으로 모든 문서의 동기화 또는 백필을 트리거합니다.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
   -d ' {
     "syncSinceTimestamp": {
       "seconds": TIMESTAMP_SECONDS,
       "nanos": TIMESTAMP_NANOS
     }
   }'
   

   다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
   • COLLECTION_ID: 스트리밍을 일시중지하거나 재개하려는 컬렉션의 ID입니다.
   • TIMESTAMP_SECONDS: 문서를 가져올 시점부터 경과된 시간(초)입니다. 타임스탬프 형식을 따릅니다.
   • TIMESTAMP_NANOS: 문서를 가져올 시점부터 경과된 시간(초)입니다. 타임스탬프 형식을 따릅니다.

   응답

   다음과 비슷한 JSON 응답이 수신됩니다. 응답에는 커넥터 실행 ID가 포함됩니다. state 필드는 동기화 실행 상태 중 하나를 보여줍니다. 자세한 내용은 ConnectorRun을 참고하세요.

   {
     "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
     "state": "CONNECTOR_RUN_STATE"
   }
   

   startConnectorRun 메서드가 실행 중일 때 다시 호출하면 오류가 발생할 수 있습니다.