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 |
Obligatoire. Nom de ressource du DataStore dans lequel importer les documents. Format : |
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 ( |
| Champs | |
|---|---|
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 |
Emplacement Cloud Storage du contenu d'entrée. Avec la valeur par défaut |
| 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-platformhttps://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 |
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 |