Method: projects.locations.dataStores.importDocuments

Initiiert einen Vorgang mit langer Ausführungszeit, um Dokumente in einen Datenspeicher zu importieren.

Eine Datei, die bereits erfolgreich importiert wurde, wird übersprungen, es sei denn, das zugehörige Cloud Storage-Objekt wurde seitdem überschrieben oder die Metadaten haben sich geändert (bei SOURCE_FORMAT_DOCUMENT_JSON). Dateien, die bei einem früheren Import fehlgeschlagen sind, werden noch einmal verarbeitet. Einzelne Dateien, die nicht importiert werden können, werden im Fehlerbericht aufgeführt (siehe ImportOutputConfig.error_gcs_prefix), anstatt den gesamten Import abzubrechen.

dataStores.importDocuments, dataStores.purgeDocuments und dataStores.patch werden jeweils einzeln pro DataStore ausgeführt. Während ein Vorgang ausgeführt wird, kann ein weiterer warten. Alle weiteren Anfragen schlagen mit ABORTED fehl, bis der laufende Vorgang abgeschlossen ist. Wenn Sie viele Dateien importieren möchten, listen Sie sie alle in inputUris einer Anfrage auf, anstatt parallele Anfragen zu senden.

HTTP-Anfrage

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

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname des DataStore, in den Dokumente importiert werden sollen. Format: projects/{project}/locations/{location}/dataStores/{dataStore}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "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.
}
Felder
importOutputConfig

object (ImportOutputConfig)

Optional. Konfiguration des Ziels für die Ausgabe von Importdokumenten: Speicherort für den Fehlerbericht des Imports.

Erforderlich. Die Quelle der Eingabe. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
gcsSource

object (GcsSource)

Cloud Storage-Speicherort für die Eingabeinhalte. Mit dem Standardwert sourceFormat kann ein URI ein Muster wie gs://my-bucket/folder/* sein, das mit den Objekten direkt in folder übereinstimmt, aber nicht mit denen in den Unterordnern. Ein Import kann maximal 100.000 Dateien für einen UNSTRUCTURED-Datenspeicher oder 100 Dateien für einen VIDEO-Datenspeicher enthalten.

Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

ImportOutputConfig

Konfiguration des Ziels für die Ausgabe im Zusammenhang mit dem Import von Dokumenten.

JSON-Darstellung
{
  "errorGcsPrefix": string
}
Felder
errorGcsPrefix

string

Optional. URI-Präfix des Cloud Storage-Speicherorts, in den alle während des Imports aufgetretenen Fehler geschrieben werden sollen. Das Präfix darf keine Objekte enthalten. Fehler werden als JSON-codierte google.rpc.Status-Nachricht in Shard-Dateien unter diesem Präfix geschrieben. Ein Fehler pro Zeile. Wenn dieses Feld leer ist, wird kein Fehlerbericht geschrieben.