Method: projects.locations.dataStores.importDocuments

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

string

Wajib. Nama resource DataStore tempat Dokumen akan diimpor. Format: projects/{project}/locations/{location}/dataStores/{dataStore}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "importOutputConfig": {
    object (ImportOutputConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsSource": {
    object (GcsSource)
  }
  // End of mutually exclusive fields.
}
Kolom
importOutputConfig

object (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

object (GcsSource)

Lokasi Cloud Storage untuk konten input. Dengan sourceFormat default, URI dapat berupa pola seperti gs://my-bucket/folder/*, yang cocok dengan objek langsung di folder, tetapi tidak dengan objek di subfoldernya. Satu impor dapat menyertakan maksimal 100.000 file untuk DataStore UNSTRUCTURED, atau 100 file untuk DataStore VIDEO.

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-platform
  • https://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

string

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 google.rpc.Status yang dienkode JSON. Jika kolom ini kosong, laporan error tidak akan ditulis.