Mengelola penyimpanan data penelusuran layanan kesehatan

Setelah membuat penyimpanan data layanan kesehatan dan mengimpor data FHIR R4, Anda dapat melakukan operasi berikut untuk mengelolanya:

• Membatalkan impor batch.
• Menjeda atau melanjutkan streaming.
• Sinkronisasi manual data yang di-streaming:
  • Sinkronkan semua dokumen.
  • Menyinkronkan dokumen tertentu.
  • Menyinkronkan dokumen setelah stempel waktu tertentu.
• Menghapus streaming.

Membatalkan impor batch

Untuk membatalkan operasi impor batch yang sedang berlangsung, lakukan tindakan berikut:

REST

1. Temukan ID operasi untuk operasi impor batch. ID operasi ini sama dengan ID yang ditampilkan saat Anda mengimpor data ke penyimpanan data. Jika Anda sudah memiliki ID operasi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik penyimpanan data yang impornya ingin Anda batalkan.

   3. Di halaman detail penyimpanan data, klik Lihat detail. Opsi ini hanya tersedia setelah operasi impor dibuat dan sedang berlangsung.

   4. Di panel Detail log aktivitas, dapatkan ID operasi.

2. Membatalkan impor batch yang sedang berlangsung.

   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" \
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • DATA_STORE_ID: ID penyimpanan data yang impor batch yang sedang berlangsung ingin Anda batalkan.
   • IMPORT_OPERATION_ID: ID operasi impor batch yang sedang berlangsung yang ingin Anda batalkan.

   Jika operasi berhasil dibatalkan, Anda akan menerima objek JSON kosong.

Menjeda atau melanjutkan streaming

Untuk menjeda atau melanjutkan operasi streaming, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di menu navigasi, klik Data Stores.

   Halaman Data Stores menampilkan daftar penyimpanan data di project Google Cloud Anda beserta detailnya.

3. Klik penyimpanan data yang streaming-nya ingin Anda jeda atau lanjutkan.

4. Di halaman Data konektor data, klik Jeda streaming data untuk menjeda streaming atau Lanjutkan streaming data untuk melanjutkan streaming data.

REST

1. Temukan ID koleksi Anda. Jika Anda sudah memiliki ID koleksi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama konektor data yang streaming-nya ingin Anda jeda atau lanjutkan.

   3. Di halaman Data untuk konektor data Anda, dapatkan ID koleksi.

2. Menjeda atau melanjutkan streaming dalam konektor data.

   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
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • COLLECTION_ID: ID konektor data yang streaming-nya ingin Anda jeda atau lanjutkan.
   • PAUSE_STREAM_TRUE|FALSE: boolean saat disetel ke true akan menjeda streaming dan saat disetel ke false akan melanjutkan streaming yang dijeda.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Kolom autoRunDisabled hanya ditampilkan saat Anda menjeda streaming data.

   {
     "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": {}
   }
   

Menyinkronkan semua dokumen di penyimpanan data streaming

Anda dapat memicu pengisian ulang secara manual untuk semua dokumen dengan jenis resource FHIR yang didukung. Dengan begitu, Anda dapat memastikan penyimpanan data Vertex AI Search tetap terbaru dengan penyimpanan FHIR Cloud Healthcare API. Sinkronisasi data hanya dapat dilakukan di penyimpanan data streaming.

Untuk menyinkronkan semua dokumen di penyimpanan data streaming, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di menu navigasi, klik Data Stores.

   Halaman Data Stores menampilkan daftar penyimpanan data di project Google Cloud Anda beserta detailnya.

3. Pilih konektor data yang ingin Anda sinkronkan.

4. Di halaman detail penyimpanan data, klik Impor ulang.

5. Di panel Impor ulang data, klik , pilih tanggal setelah Anda ingin menyinkronkan data, lalu klik Tutup.

6. Di bagian Resources to re-import, pilih semua jenis resource FHIR. Dengan melakukannya, semua dokumen akan diisi ulang dengan jenis resource FHIR yang didukung.

7. Klik Impor ulang.

REST

1. Temukan ID koleksi Anda. Jika Anda sudah memiliki ID koleksi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama konektor data yang streaming-nya ingin Anda jeda atau lanjutkan.

   3. Di halaman Data untuk konektor data Anda, dapatkan ID koleksi.

2. Memicu sinkronisasi atau pengisian ulang semua dokumen dengan jenis resource FHIR yang didukung.

   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": {}
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • COLLECTION_ID: ID koleksi yang streaming-nya ingin Anda jeda atau lanjutkan.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Respons berisi ID eksekusi konektor. Kolom state menampilkan salah satu status proses sinkronisasi. Untuk mengetahui informasi selengkapnya, lihat ConnectorRun.

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

   Jika Anda memanggil metode startConnectorRun lagi saat masih berjalan, Anda mungkin akan mendapatkan error.

Menyinkronkan dokumen tertentu di penyimpanan data streaming

Anda dapat mengimpor dokumen tertentu dengan jenis resource FHIR yang didukung. Tindakan ini berguna jika Anda ingin memperbarui penyimpanan data Vertex AI Search dengan dokumen jenis resource FHIR tertentu. Sinkronisasi data hanya dapat dilakukan di penyimpanan data streaming.

Untuk menyinkronkan dokumen tertentu di penyimpanan data streaming, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di menu navigasi, klik Data Stores.

   Halaman Data Stores menampilkan daftar penyimpanan data di project Google Cloud Anda beserta detailnya.

3. Pilih konektor data yang ingin Anda sinkronkan.

4. Di halaman detail penyimpanan data, klik Impor ulang.

5. Di panel Impor ulang data, klik , pilih tanggal setelah Anda ingin menyinkronkan data, lalu klik Tutup.

6. Di bagian Resources to re-import, pilih semua jenis resource FHIR yang ingin Anda impor ulang. Tindakan ini akan mengimpor semua dokumen dari jenis resource FHIR yang dipilih.

7. Klik Impor ulang.

REST

1. Temukan ID koleksi Anda. Jika Anda sudah memiliki ID koleksi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama konektor data yang streaming-nya ingin Anda jeda atau lanjutkan.

   3. Di halaman Data untuk konektor data Anda, dapatkan ID koleksi.

2. Memicu sinkronisasi atau pengisian ulang dokumen selektif dengan jenis resource FHIR yang didukung.

   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"
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • COLLECTION_ID: ID koleksi yang streaming-nya ingin Anda jeda atau lanjutkan.
   • RESOURCE_TYPE: jenis resource dokumen FHIR yang ingin Anda isi ulang.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Respons berisi ID eksekusi konektor. Kolom state menampilkan salah satu status proses sinkronisasi. Untuk mengetahui informasi selengkapnya, lihat ConnectorRun.

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

   Jika Anda memanggil metode startConnectorRun lagi saat masih berjalan, Anda mungkin akan mendapatkan error.

Menyinkronkan dokumen setelah stempel waktu tertentu di penyimpanan data streaming

Anda dapat mengimpor dokumen selektif dengan jenis resource FHIR yang didukung setelah stempel waktu tertentu. Sinkronisasi data hanya dapat dilakukan di penyimpanan data streaming.

Untuk menyinkronkan dokumen setelah stempel waktu tertentu, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di menu navigasi, klik Data Stores.

   Halaman Data Stores menampilkan daftar penyimpanan data di project Google Cloud Anda beserta detailnya.

3. Pilih konektor data yang ingin Anda sinkronkan.

4. Di halaman detail penyimpanan data, klik Impor ulang.

5. Di panel Impor ulang data, klik , pilih tanggal setelah Anda ingin menyinkronkan data, lalu klik Tutup.

6. Di bagian Resources to re-import, pilih semua jenis resource FHIR yang ingin Anda impor ulang. Tindakan ini akan mengimpor semua dokumen dari jenis resource FHIR yang dipilih.

7. Klik Impor ulang.

REST

1. Temukan ID koleksi Anda. Jika Anda sudah memiliki ID koleksi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama konektor data yang streaming-nya ingin Anda jeda atau lanjutkan.

   3. Di halaman Data untuk konektor data Anda, dapatkan ID koleksi.

2. Memicu sinkronisasi atau pengisian ulang semua dokumen dengan jenis resource FHIR yang didukung.

   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
     }
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • COLLECTION_ID: ID koleksi yang streaming-nya ingin Anda jeda atau lanjutkan.
   • TIMESTAMP_SECONDS: nilai stempel waktu dalam detik sejak waktu Anda ingin mengimpor dokumen. Formatnya mengikuti format Stempel Waktu.
   • TIMESTAMP_NANOS: nilai stempel waktu dalam detik sejak waktu Anda ingin mengimpor dokumen. Formatnya mengikuti format Stempel Waktu.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Respons berisi ID eksekusi konektor. Kolom state menampilkan salah satu status proses sinkronisasi. Untuk mengetahui informasi selengkapnya, lihat ConnectorRun.

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

   Jika Anda memanggil metode startConnectorRun lagi saat masih berjalan, Anda mungkin akan mendapatkan error.

Menghapus streaming

Untuk menghapus operasi streaming, lakukan langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di menu navigasi, klik Data Stores.

   Halaman Data Stores menampilkan daftar penyimpanan data di project Google Cloud Anda beserta detailnya.

3. Dalam daftar penyimpanan data, klik Opsi lainnya untuk konektor data yang ingin Anda hapus.

4. Klik Delete.

5. Pada dialog yang muncul, ketik ya, lalu klik Konfirmasi untuk mengonfirmasi penghapusan.

REST

1. Temukan ID koleksi Anda. Jika Anda sudah memiliki ID koleksi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama konektor data yang streaming-nya ingin Anda jeda atau lanjutkan.

   3. Di halaman Data untuk konektor data Anda, dapatkan ID koleksi.

2. Memicu sinkronisasi atau pengisian ulang semua dokumen dengan jenis resource FHIR yang didukung.

   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
     }
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • COLLECTION_ID: ID koleksi yang streaming-nya ingin Anda jeda atau lanjutkan.
   • TIMESTAMP_SECONDS: nilai stempel waktu dalam detik sejak waktu Anda ingin mengimpor dokumen. Formatnya mengikuti format Stempel Waktu.
   • TIMESTAMP_NANOS: nilai stempel waktu dalam detik sejak waktu Anda ingin mengimpor dokumen. Formatnya mengikuti format Stempel Waktu.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Respons berisi ID eksekusi konektor. Kolom state menampilkan salah satu status proses sinkronisasi. Untuk mengetahui informasi selengkapnya, lihat ConnectorRun.

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

   Jika Anda memanggil metode startConnectorRun lagi saat masih berjalan, Anda mungkin akan mendapatkan error.