Setelah impor data awal ke penyimpanan data layanan kesehatan Vertex AI Search, Anda mungkin telah melakukan salah satu pembaruan berikut di penyimpanan FHIR sumber:
- Menambahkan resource FHIR baru
- Memperbarui resource FHIR yang ada
- Resource FHIR yang dihapus
Dalam kasus tersebut, Anda dapat merekonsiliasi perubahan dari penyimpanan FHIR sumber ke penyimpanan data layanan kesehatan Vertex AI Search.
Ringkasan rekonsiliasi
Anda dapat merekonsiliasi perubahan secara bertahap atau sepenuhnya. Kedua mode tersebut dibandingkan dalam tabel berikut.
Perubahan pada FHIR store sumber | Mode inkremental | Mode penuh |
---|---|---|
Resource FHIR baru | Menambahkan dokumen baru ke penyimpanan data Vertex AI Search | Menambahkan dokumen baru ke penyimpanan data Vertex AI Search |
Resource FHIR yang diperbarui | Mengganti dokumen yang ada di penyimpanan data Vertex AI Search sekaligus mempertahankan ID dokumen | Mengganti dokumen yang ada di penyimpanan data Vertex AI Search sekaligus mempertahankan ID dokumen |
Resource FHIR yang dihapus | Tidak merekonsiliasi | Menghapus dokumen yang sesuai dari penyimpanan data Vertex AI Search Anda |
Sebelum memulai
Tinjau kuota dan batas untuk project Google Cloud Anda. Penyimpanan data layanan kesehatan Vertex AI Search Anda dapat berisi maksimal 1 juta dokumen per project. Jika kuota ini tercapai selama impor, proses impor akan berhenti.
Melakukan impor inkremental
Contoh berikut menunjukkan cara mengimpor perubahan
inkremental dari penyimpanan FHIR Cloud Healthcare API menggunakan
metode
documents.import
.
Izin yang diperlukan untuk langkah ini
Berikan izin berikut
atau peran Identity and Access Management (IAM)
berikut ke akun layanan
service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com
.
- Untuk impor data FHIR satu kali dari penyimpanan FHIR di Cloud Healthcare API.
Izin
bigquery.jobs.create
bigquery.datasets.create
bigquery.tables.export
healthcare.datasets.get
healthcare.datasets.list
healthcare.fhirStores.get
healthcare.fhirStores.list
healthcare.fhirStores.export
Peran
- Untuk impor streaming data FHIR dari penyimpanan FHIR di Cloud Healthcare API (Pratinjau).
Izin
healthcare.datasets.get
healthcare.datasets.list
healthcare.fhirStores.get
healthcare.fhirStores.update
healthcare.fhirStores.list
healthcare.fhirStores.export
healthcare.fhirResources.get
Peran
- Untuk menyesuaikan skema saat membuat penyimpanan data (Pratinjau) guna mengonfigurasi kemampuan pengindeksan,
kemampuan penelusuran, dan kemampuan pengambilan resource dan elemen FHIR.
Izin
storage.objects.create
storage.objects.delete
storage.objects.list
Peran
- Untuk mengimpor data FHIR yang mereferensikan file di Google Cloud. Izin ini diberikan secara default jika
file yang dirujuk berada dalam project Google Cloud yang sama dengan aplikasi Vertex AI Search.
Izin
storage.objects.get
storage.buckets.create
Peran
Lakukan impor inkremental.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project:
PROJECT_ID " \ "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID /locations/us/dataStores/DATA_STORE_ID /branches/0/documents:import" \ -d '{ "reconciliation_mode": "INCREMENTAL", "fhir_store_source": {"fhir_store": "projects/PROJECT_ID /locations/CLOUD_HEALTHCARE_DATASET_LOCATION /datasets/CLOUD_HEALTHCARE_DATASET_ID /fhirStores/FHIR_STORE_ID "} }'Ganti kode berikut:
PROJECT_ID
: ID Google Cloud project Anda.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search.CLOUD_HEALTHCARE_DATASET_ID
: ID set data Cloud Healthcare API yang berisi penyimpanan FHIR sumber.CLOUD_HEALTHCARE_DATASET_LOCATION
: lokasi set data Cloud Healthcare API yang berisi penyimpanan FHIR sumber.FHIR_STORE_ID
: ID penyimpanan FHIR R4 Cloud Healthcare API.
Respons
Anda akan menerima respons JSON yang mirip dengan berikut ini. Respons ini berisi ID untuk operasi yang berjalan lama. Operasi yang berjalan lama ditampilkan saat panggilan metode mungkin memerlukan waktu lama untuk selesai. Perhatikan nilai IMPORT_OPERATION_ID. Anda memerlukan nilai ini untuk memverifikasi status impor.
{ "name": "projects/
PROJECT_ID /locations/us/collections/default_collection/dataStores/DATA_STORE_ID /branches/0/operations/IMPORT_OPERATION_ID ", "metadata": { "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsMetadata" } }Verifikasi apakah operasi impor data FHIR sudah selesai.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://us-discoveryengine.googleapis.com/v1alpha/projects/
PROJECT_ID /locations/us/collections/default_collection/dataStores/DATA_STORE_ID /branches/0/operations/IMPORT_OPERATION_ID "Ganti kode berikut:
PROJECT_ID
: ID Google Cloud project Anda.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search.IMPORT_OPERATION_ID
: ID operasi dari operasi yang berjalan lama yang ditampilkan saat Anda memanggil metodeimport
.
Respons
Anda akan menerima respons JSON yang mirip dengan berikut ini. Operasi impor adalah operasi yang berjalan lama. Saat operasi berjalan, respons akan berisi kolom berikut:
successCount
: menunjukkan jumlah resource FHIR yang berhasil diimpor sejauh ini.failureCount
: menunjukkan jumlah resource FHIR yang gagal diimpor sejauh ini. Kolom ini hanya ditampilkan jika ada resource FHIR yang gagal diimpor.
Setelah operasi selesai, respons akan berisi kolom berikut:
successCount
: menunjukkan jumlah resource FHIR yang berhasil diimpor.failureCount
: menunjukkan jumlah resource FHIR yang gagal diimpor. Kolom ini hanya ditampilkan jika ada resource FHIR yang gagal diimpor.totalCount
: menunjukkan jumlah resource FHIR yang ada di penyimpanan FHIR sumber. Kolom ini hanya ditampilkan jika ada resource FHIR yang gagal diimpor.done
: memiliki nilaitrue
untuk menunjukkan bahwa operasi impor telah selesaierrorSamples
: memberikan informasi tentang resource yang gagal diimpor. Kolom ini hanya ditampilkan jika ada resource FHIR yang gagal diimpor.errorConfig
: memberikan jalur ke lokasi Cloud Storage yang berisi file log ringkasan error.
{ "name": "projects/
PROJECT_ID /locations/us/collections/default_collection/dataStores/DATA_STORE_ID /branches/0/operations/IMPORT_OPERATION_ID ", "metadata": { "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsMetadata", "createTime": "START_TIMESTAMP ", "updateTime": "END_TIMESTAMP ", "successCount": "SUCCESS_COUNT ", "failureCount": "FAILURE_COUNT ", "totalCount": "TOTAL_COUNT ", }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsResponse", "errorSamples": [ERROR_SAMPLE ], "errorConfig": { "gcsPrefix": "LOG_FILE_LOCATION " } } }
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Python Vertex AI Agent Builder.
Untuk melakukan autentikasi ke Vertex AI Agent Builder, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.