このページは Cloud Translation API によって翻訳されました。

ヘルスケア検索データストアを管理する

ヘルスケアデータストアを作成して FHIR R4 データをインポートしたら、次のオペレーションを実行して管理できます。

バッチインポートをキャンセルします。
ストリーミングを一時停止または再開する。
ストリーミングデータの手動同期:
[ストリーミングを削除] をタップします。

バッチインポートをキャンセルする

進行中のバッチインポートオペレーションをキャンセルするには、次の操作を行います。

REST

バッチインポートオペレーションのオペレーション ID を確認します。このオペレーション ID は、データストアにデータをインポートしたときに返された ID と同じです。オペレーション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
2. インポートをキャンセルするデータストアをクリックします。
3. データストアの詳細ページで、[詳細を表示] をクリックします。この操作は、インポートオペレーションが作成され、処理中になってからのみ使用できます。
4. [アクティビティログの詳細] パネルで、オペレーション ID を取得します。
進行中のバッチインポートをキャンセルします。
```
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 オブジェクトが返されます。

ストリーミングを一時停止または再開する

ストリーミングオペレーションを一時停止または再開するには、次の操作を行います。

Console

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
ナビゲーションメニューで [データストア] をクリックします。

[データストア] ページには、プロジェクト内のデータストアのリストと詳細が表示されます。 Google Cloud
ストリーミングを一時停止または再開するデータストアをクリックします。
データコネクタの [データ] ページで、 [データストリーミングを一時停止] をクリックしてストリーミングを一時停止するか、 [データストリーミングを再開] をクリックしてデータストリーミングを再開します。

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
2. ストリーミングを一時停止または再開するデータコネクタの名前をクリックします。
3. データコネクタの [データ] ページで、コレクション ID を取得します。

データコネクタ内でストリーミングを一時停止または再開する。

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 ストアと最新の状態に保つことができます。データの同期は、ストリーミングデータストアでのみ可能です。

ストリーミングデータストア内のすべてのドキュメントを同期するには、次の操作を行います。

Console

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
ナビゲーションメニューで [データストア] をクリックします。

[データストア] ページには、プロジェクト内のデータストアのリストと詳細が表示されます。 Google Cloud
同期するデータコネクタを選択します。
データストアの詳細ページで、 [再インポート] をクリックします。
[データを再インポート] ペインでをクリックし、データを同期する日付を選択して、[閉じる] をクリックします。
[再インポートするリソース] セクションで、すべての FHIR リソースタイプを選択します。これにより、サポートされている FHIR リソースタイプですべてのドキュメントがバックフィルされます。
[再インポート] をクリックします。

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
2. ストリーミングを一時停止または再開するデータコネクタの名前をクリックします。
3. データコネクタの [データ] ページで、コレクション ID を取得します。
サポートされている 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 データストアを更新する場合に便利です。データの同期は、ストリーミングデータストアでのみ可能です。

ストリーミングデータストア内の選択したドキュメントを同期するには、次の操作を行います。

Console

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
ナビゲーションメニューで [データストア] をクリックします。

[データストア] ページには、プロジェクト内のデータストアのリストと詳細が表示されます。 Google Cloud
同期するデータコネクタを選択します。
データストアの詳細ページで、 [再インポート] をクリックします。
[データを再インポートする] ペインでをクリックし、データを同期する日付を選択して、[閉じる] をクリックします。
[再インポートするリソース] セクションで、インポートする FHIR リソースタイプをすべて選択します。これにより、選択した FHIR リソースタイプのすべてのドキュメントがインポートされます。
[再インポート] をクリックします。

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
2. ストリーミングを一時停止または再開するデータコネクタの名前をクリックします。
3. データコネクタの [データ] ページで、コレクション ID を取得します。
サポートされている 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 リソースタイプを含むドキュメントを選択してインポートできます。データの同期は、ストリーミングデータストアでのみ可能です。

特定のタイムスタンプ以降のドキュメントを同期するには、次の操作を行います。

Console

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
ナビゲーションメニューで [データストア] をクリックします。

[データストア] ページには、プロジェクト内のデータストアのリストと詳細が表示されます。 Google Cloud
同期するデータコネクタを選択します。
データストアの詳細ページで、 [再インポート] をクリックします。
[データを再インポートする] ペインでをクリックし、データを同期する日付を選択して、[閉じる] をクリックします。
[再インポートするリソース] セクションで、インポートする FHIR リソースタイプをすべて選択します。これにより、選択した FHIR リソースタイプのすべてのドキュメントがインポートされます。
[再インポート] をクリックします。

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
2. ストリーミングを一時停止または再開するデータコネクタの名前をクリックします。
3. データコネクタの [データ] ページで、コレクション ID を取得します。
サポートされている 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 メソッドを再度呼び出すと、エラーが発生することがあります。

ストリーミングを削除する

ストリーミングオペレーションを削除するには、次の操作を行います。

Console

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
ナビゲーションメニューで [データストア] をクリックします。

[データストア] ページには、プロジェクト内のデータストアのリストと詳細が表示されます。 Google Cloud
データストアのリストで、削除するデータコネクタの [その他のオプション] をクリックします。
[削除] をクリックします。
表示されたダイアログで「yes」と入力し、[確認] をクリックして削除を確定します。

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
2. ストリーミングを一時停止または再開するデータコネクタの名前をクリックします。
3. データコネクタの [データ] ページで、コレクション ID を取得します。
サポートされている 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 メソッドを再度呼び出すと、エラーが発生することがあります。

ヘルスケア検索データストアを管理する

バッチ インポートをキャンセルする

REST

ストリーミングを一時停止または再開する

Console

REST

レスポンス

ストリーミング データストア内のすべてのドキュメントを同期する

Console

REST

レスポンス

ストリーミング データストア内の一部のドキュメントを同期する

Console

REST

レスポンス

ストリーミング データストアで指定されたタイムスタンプ以降のドキュメントを同期する

Console

REST

レスポンス

ストリーミングを削除する

Console

REST

レスポンス

バッチインポートをキャンセルする

ストリーミングデータストア内のすべてのドキュメントを同期する

ストリーミングデータストア内の一部のドキュメントを同期する

ストリーミングデータストアで指定されたタイムスタンプ以降のドキュメントを同期する