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 |
Erforderlich. Der Ressourcenname des DataStore, in den Dokumente importiert werden sollen. Format: |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
|---|
{ "importOutputConfig": { object ( |
| Felder | |
|---|---|
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 |
Cloud Storage-Speicherort für die Eingabeinhalte. Mit dem Standardwert |
| 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-platformhttps://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 |
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 |