Memulai Operasi yang Berjalan Lama untuk mengimpor Dokumen ke DataStore.
File yang telah berhasil diimpor akan dilewati, kecuali jika objek Cloud Storage-nya telah ditimpa sejak saat itu atau, untuk SOURCE_FORMAT_DOCUMENT_JSON, metadatanya telah berubah. File yang gagal dalam impor sebelumnya akan diproses lagi. File individual yang tidak dapat diimpor akan dilaporkan dalam laporan error (lihat ImportOutputConfig.error_gcs_prefix), bukan menggagalkan seluruh impor.
dataStores.importDocuments, dataStores.purgeDocuments, dan dataStores.patch berjalan satu per satu per DataStore. Saat satu operasi berjalan, satu operasi lagi dapat menunggu; permintaan lebih lanjut akan gagal dengan ABORTED hingga operasi yang berjalan selesai. Untuk mengimpor banyak file, cantumkan semuanya di inputUris dari satu permintaan, bukan mengirim permintaan paralel.
Permintaan HTTP
POST https://vectorsearch.googleapis.com/v1beta/{name}:importDocuments
Parameter jalur
| Parameter | |
|---|---|
name |
Wajib. Nama resource DataStore tempat Dokumen akan diimpor. Format: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
|---|
{ "importOutputConfig": { object ( |
| Kolom | |
|---|---|
importOutputConfig |
Opsional. Konfigurasi tujuan untuk output dokumen impor: tempat untuk menulis laporan error impor. |
| Wajib. Sumber input. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
gcsSource |
Lokasi Cloud Storage untuk konten input. Dengan |
| Akhir kolom yang saling eksklusif. | |
Isi respons
Jika berhasil, isi respons akan memuat instance Operation.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/vectorsearch
Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ImportOutputConfig
Konfigurasi tujuan untuk output terkait dokumen impor.
| Representasi JSON |
|---|
{ "errorGcsPrefix": string } |
| Kolom | |
|---|---|
errorGcsPrefix |
Opsional. Awalan URI lokasi Cloud Storage untuk menulis error yang terjadi selama impor. Awalan tidak boleh berisi objek apa pun. Error ditulis ke file yang di-sharding di bawah awalan ini, satu per baris, sebagai pesan |