Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Method: projects.locations.dataStores.importDocuments

Avvia un'operazione a lunga esecuzione per importare i documenti in un datastore.

Un file che è già stato importato correttamente viene ignorato, a meno che il relativo oggetto Cloud Storage non sia stato sovrascritto o, nel caso di SOURCE_FORMAT_DOCUMENT_JSON, i relativi metadati non siano stati modificati. I file che non sono stati importati in precedenza vengono elaborati di nuovo. I singoli file che non possono essere importati vengono segnalati nel report sugli errori (vedi ImportOutputConfig.error_gcs_prefix) anziché causare l'errore dell'intera importazione.

dataStores.importDocuments, dataStores.purgeDocuments e dataStores.patch vengono eseguiti uno alla volta per DataStore. Mentre una è in esecuzione, un'altra può attendere; qualsiasi ulteriore richiesta non va a buon fine con ABORTED finché l'operazione in esecuzione non termina. Per importare molti file, elencali tutti in inputUris di una richiesta anziché inviare richieste parallele.

Richiesta HTTP

POST https://vectorsearch.googleapis.com/v1beta/{name}:importDocuments

Parametri di percorso

Parametri

Parametri
`name`	`string` Obbligatorio. Il nome della risorsa del datastore in cui importare i documenti. Formato: `projects/{project}/locations/{location}/dataStores/{dataStore}`.

name

string

Obbligatorio. Il nome della risorsa del datastore in cui importare i documenti. Formato: projects/{project}/locations/{location}/dataStores/{dataStore}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON

Rappresentazione 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. }

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

Campi
`importOutputConfig`	`object (ImportOutputConfig)` Facoltativo. Configurazione della destinazione per l'output dei documenti di importazione: dove scrivere il report di Error Reporting dell'importazione.
Obbligatorio. La sorgente dell'input. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
`gcsSource`	`object (GcsSource)` Percorso di Cloud Storage per i contenuti di input. Con il valore predefinito `sourceFormat`, un URI può essere un pattern come `gs://my-bucket/folder/*`, che corrisponde agli oggetti direttamente in `folder`, ma non a quelli nelle relative sottocartelle. Un'importazione può includere al massimo 100.000 file per un datastore `UNSTRUCTURED` o 100 per un datastore `VIDEO`.
Fine dei campi che si escludono a vicenda.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/vectorsearch

Per saperne di più, consulta la Authentication Overview.

ImportOutputConfig

Configurazione della destinazione per l'output relativo ai documenti di importazione.

Rappresentazione JSON
{ "errorGcsPrefix": string }

Campi

Campi
`errorGcsPrefix`	`string` Facoltativo. Prefisso URI della posizione di Cloud Storage in cui scrivere eventuali errori riscontrati durante l'importazione. Il prefisso non deve contenere oggetti. Gli errori vengono scritti in file con sharding sotto questo prefisso, uno per riga, come messaggio `google.rpc.Status` con codifica JSON. Se questo campo è vuoto, non viene scritto alcun report sugli errori.

errorGcsPrefix