Method: projects.locations.dataStores.importDocuments

Lance une opération de longue durée pour importer des documents dans un datastore.

Un fichier qui a déjà été importé est ignoré, sauf si son objet Cloud Storage a été écrasé depuis ou, pour SOURCE_FORMAT_DOCUMENT_JSON, si ses métadonnées ont changé. Les fichiers qui ont échoué lors d'une importation précédente sont traités à nouveau. Les fichiers individuels qui ne peuvent pas être importés sont signalés dans le rapport d'erreurs (voir ImportOutputConfig.error_gcs_prefix) plutôt que de faire échouer l'ensemble de l'importation.

dataStores.importDocuments, dataStores.purgeDocuments et dataStores.patch s'exécutent un par un par DataStore. Pendant qu'une opération est en cours d'exécution, une autre peut être mise en attente. Toute autre requête échoue avec l'erreur ABORTED jusqu'à ce que l'opération en cours se termine. Pour importer de nombreux fichiers, listez-les tous dans inputUris d'une même requête plutôt que d'envoyer des requêtes parallèles.

Requête HTTP

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

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource du DataStore dans lequel importer les documents. Format : projects/{project}/locations/{location}/dataStores/{dataStore}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
importOutputConfig

object (ImportOutputConfig)

Facultatif. Configuration de la destination pour la sortie des documents d'importation : emplacement où écrire le rapport d'erreurs de l'importation.

Obligatoire. Source de l'entrée. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
gcsSource

object (GcsSource)

Emplacement Cloud Storage du contenu d'entrée. Avec la valeur par défaut sourceFormat, un URI peut être un modèle tel que gs://my-bucket/folder/*, qui correspond aux objets directement dans folder, mais pas à ceux de ses sous-dossiers. Une importation peut inclure au maximum 100 000 fichiers pour un datastore UNSTRUCTURED ou 100 pour un datastore VIDEO.

Fin des champs mutuellement exclusifs.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

ImportOutputConfig

Configuration de la destination pour la sortie liée aux documents d'importation.

Représentation JSON
{
  "errorGcsPrefix": string
}
Champs
errorGcsPrefix

string

Facultatif. Préfixe d'URI de l'emplacement Cloud Storage où écrire les erreurs rencontrées lors de l'importation. Le préfixe ne doit contenir aucun objet. Les erreurs sont écrites dans des fichiers segmentés sous ce préfixe, une par ligne, sous la forme d'un message google.rpc.Status encodé en JSON. Si ce champ est vide, aucun rapport d'erreur n'est écrit.