管理醫療照護搜尋資料儲存庫

建立醫療照護資料儲存庫並匯入 FHIR R4 資料後,即可執行下列作業來管理這些資料:

取消批次匯入

如要取消進行中的批次匯入作業,請按照下列步驟操作:

REST

  1. 找出批次匯入作業的作業 ID。這個作業 ID 與您將資料匯入資料存放區時傳回的 ID 相同。如果已有作業 ID,請跳到下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面,然後在導覽選單中點選「Data Stores」

      前往「資料儲存庫」頁面

    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 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在導覽選單中,按一下「資料儲存庫」

    「資料儲存庫」頁面會顯示專案中的資料儲存庫清單及其詳細資料。 Google Cloud

  3. 按一下要暫停或繼續串流的資料儲存庫。

  4. 在資料連接器的「資料」頁面上,按一下 「暫停串流資料」即可暫停串流,按一下 「繼續串流資料」即可繼續串流。

REST

  1. 找出集合 ID。如果已有收藏內容 ID,請跳至下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面,然後在導覽選單中點選「Data Stores」

      前往「資料儲存庫」頁面

    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 時則會繼續播放暫停的串流。

同步處理串流資料存放區中的所有文件

您可以手動為所有支援的 FHIR 資源類型文件觸發補充作業。這樣一來,您就能讓 Vertex AI Search 資料儲存庫與 Cloud Healthcare API FHIR 儲存庫保持同步。資料同步處理只能在串流資料儲存庫中進行。

如要同步處理串流資料儲存庫中的所有文件,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在導覽選單中,按一下「資料儲存庫」

    「資料儲存庫」頁面會顯示專案中的資料儲存庫清單及其詳細資料。 Google Cloud

  3. 選取要同步處理的資料連接器。

  4. 在資料儲存庫詳細資料頁面,按一下 「重新匯入」

  5. 在「重新匯入資料」窗格中,按一下 ,選取要同步處理資料的日期,然後按一下「關閉」

  6. 在「Resources to re-import」(要重新匯入的資源) 專區中,選取所有 FHIR 資源類型。這麼做會以支援的 FHIR 資源類型回填所有文件。

  7. 按一下「重新匯入」

REST

  1. 找出集合 ID。如果已有收藏內容 ID,請跳至下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面,然後在導覽選單中點選「Data Stores」

      前往「資料儲存庫」頁面

    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/v1alpha/projects/PROJECT_ID/locations/us/collections/COLLECTION_ID/dataConnector:startConnectorRun" \
    -d ' {
      "syncSinceTimestamp": {}
    }'
    

    更改下列內容:

    • PROJECT_ID:您的 Google Cloud 專案 ID。
    • COLLECTION_ID:要暫停或繼續串流播放的收藏內容 ID。

    如果在 startConnectorRun 方法仍在執行時再次呼叫該方法,可能會發生錯誤。

在串流資料儲存庫中同步處理所選文件

您可以匯入特定文件,但須使用支援的 FHIR 資源類型。如果您想使用特定 FHIR 資源類型的文件更新 Vertex AI Search 資料儲存庫,這項功能就非常實用。資料只能在串流資料儲存庫中同步。

如要同步處理串流資料儲存庫中的特定文件,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在導覽選單中,按一下「資料儲存庫」

    「資料儲存庫」頁面會顯示專案中的資料儲存庫清單及其詳細資料。 Google Cloud

  3. 選取要同步處理的資料連接器。

  4. 在資料儲存庫詳細資料頁面,按一下 「重新匯入」

  5. 在「重新匯入資料」窗格中,按一下 ,選取要同步處理資料的日期,然後按一下「關閉」

  6. 在「Resources to re-import」(要重新匯入的資源) 專區中,選取要匯入的所有 FHIR 資源類型。這樣做會匯入所選 FHIR 資源類型的所有文件。

  7. 按一下「重新匯入」

REST

  1. 找出集合 ID。如果已有收藏內容 ID,請跳至下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面,然後在導覽選單中點選「Data Stores」

      前往「資料儲存庫」頁面

    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/v1alpha/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 文件資源類型。

    如果在 startConnectorRun 方法仍在執行時再次呼叫該方法,可能會發生錯誤。

在串流資料存放區中,同步處理指定時間戳記之後的文件

您可以在特定時間戳記後匯入支援的 FHIR 資源類型,資料只能在串流資料儲存庫中同步。

如要在特定時間戳記後同步處理文件,請執行下列操作:

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在導覽選單中,按一下「資料儲存庫」

    「資料儲存庫」頁面會顯示專案中的資料儲存庫清單及其詳細資料。 Google Cloud

  3. 選取要同步處理的資料連接器。

  4. 在資料儲存庫詳細資料頁面,按一下 「重新匯入」

  5. 在「重新匯入資料」窗格中,按一下 ,選取要同步處理資料的日期,然後按一下「關閉」

  6. 在「Resources to re-import」(要重新匯入的資源) 專區中,選取要匯入的所有 FHIR 資源類型。這樣做會匯入所選 FHIR 資源類型的所有文件。

  7. 按一下「重新匯入」

REST

  1. 找出集合 ID。如果已有收藏內容 ID,請跳至下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面,然後在導覽選單中點選「Data Stores」

      前往「資料儲存庫」頁面

    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/v1alpha/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:時間戳記的值,以秒為單位,代表您要匯入文件的時間。請採用「時間戳記」格式。

    如果在 startConnectorRun 方法仍在執行時再次呼叫該方法,可能會發生錯誤。

刪除串流

如要刪除串流作業,請執行下列步驟:

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在導覽選單中,按一下「資料儲存庫」

    「資料儲存庫」頁面會顯示專案中的資料儲存庫清單及其詳細資料。 Google Cloud

  3. 在資料存放區清單中,按一下要刪除的資料連接器「更多選項」

  4. 按一下「刪除」圖示

  5. 在隨即顯示的對話方塊中輸入 yes,然後按一下「Confirm」(確認),確認要刪除。

REST

  1. 找出集合 ID。如果已有收藏內容 ID,請跳至下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面,然後在導覽選單中點選「Data Stores」

      前往「資料儲存庫」頁面

    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/v1alpha/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:時間戳記的值,以秒為單位,代表您要匯入文件的時間。請採用「時間戳記」格式。

    如果在 startConnectorRun 方法仍在執行時再次呼叫該方法,可能會發生錯誤。