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

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

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

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

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

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

REST

バッチインポートオペレーションのオペレーション ID を確認します。このオペレーション ID は、データストアにデータをインポートしたときに返される ID と同じです。オペレーション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
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 オブジェクトが返されます。

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

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

コンソール

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

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

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

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
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 ストアと同期できます。データの同期は、ストリーミングデータストアでのみ可能です。

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

コンソール

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

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

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

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
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/v1alpha/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 データストアを更新する場合に便利です。データの同期は、ストリーミングデータストアでのみ可能です。

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

コンソール

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

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

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

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
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/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 ドキュメントのリソースタイプ。
レスポンス

次のような JSON レスポンスが返されます。レスポンスにはコネクタ実行 ID が含まれます。state フィールドには、同期実行の状態のいずれかが表示されます。詳細については、ConnectorRun をご覧ください。
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
startConnectorRun メソッドが実行中に再度呼び出されると、エラーが発生する可能性があります。

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

特定のタイムスタンプ以降に、サポートされている FHIR リソースタイプを使用してドキュメントを選択的にインポートできます。データの同期は、ストリーミングデータストアでのみ可能です。

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

コンソール

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

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

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

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
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/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: ドキュメントのインポートを開始する時点からのタイムスタンプ値（秒単位）。タイムスタンプ形式に従います。
レスポンス

次のような JSON レスポンスが返されます。レスポンスにはコネクタ実行 ID が含まれます。state フィールドには、同期実行の状態のいずれかが表示されます。詳細については、ConnectorRun をご覧ください。
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
startConnectorRun メソッドが実行中に再度呼び出されると、エラーが発生する可能性があります。

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

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

コンソール

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

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

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

REST

コレクション ID を確認します。コレクション ID がすでにある場合は、次のステップに進みます。
1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーションメニューで [データストア] をクリックします。
  
  [データストア] ページに移動
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/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: ドキュメントのインポートを開始する時点からのタイムスタンプ値（秒単位）。タイムスタンプ形式に従います。
レスポンス

次のような JSON レスポンスが返されます。レスポンスにはコネクタ実行 ID が含まれます。state フィールドには、同期実行の状態のいずれかが表示されます。詳細については、ConnectorRun をご覧ください。
```
{
  "name": "projects/189082903055/locations/us/collections/contact/dataConnector/connectorRuns/CONNECTOR_RUN_ID",
  "state": "CONNECTOR_RUN_STATE"
}
```
startConnectorRun メソッドが実行中に再度呼び出されると、エラーが発生する可能性があります。

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

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

REST

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

コンソール

REST

レスポンス

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

コンソール

REST

レスポンス

ストリーミング データストア内のドキュメントを選択的に同期する

コンソール

REST

レスポンス

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

コンソール

REST

レスポンス

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

コンソール

REST

レスポンス

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

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

ストリーミングデータストア内のドキュメントを選択的に同期する

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