Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Neptune Loader-API Get-Status Ruft den Status eines `loader`-Auftrags ab. Zum Abrufen des Ladestatus müssen Sie eine HTTP-`GET`-Anforderung an den `https://your-neptune-endpoint:port/loader`-Endpunkt senden. Zum Abrufen des Status für eine bestimmte Ladeanforderung müssen Sie die `loadId` als URL-Parameter einschließen oder die `loadId` dem URL-Pfad voranstellen. Neptune verfolgt nur die letzten 1.024 Massenladeaufgaben und speichert pro Auftrag nur die letzten 10 000 Fehlerdetails. Die Liste der Fehler- und Feed-Meldungen, die der Loader im Fehlerfall zurückgibt, finden Sie unter [Neptune Loader-Fehler- und Feed-Nachrichten](loader-message.md). **Contents** + [Neptune Loader-Anfragen Get-Status](load-api-reference-status-requests.md) + [Syntax der Loader-Anfrage Get-Status](load-api-reference-status-requests.md#load-api-reference-status-request-syntax) + [Neptune Loader-Anforderungsparameter Get-Status](load-api-reference-status-requests.md#load-api-reference-status-parameters) + [Antworten von Neptune Loader Get-Status](load-api-reference-status-response.md) + [JSON-Layout für Neptune Get-Status Loader-Antworten](load-api-reference-status-response.md#load-api-reference-status-response-layout) + [Neptune Loader Get-Status `overallStatus` und `failedFeeds` Antwortobjekte](load-api-reference-status-response.md#load-api-reference-status-response-objects) + [Neptune Loader-Antwortobjekt Get-Status `errors`](load-api-reference-status-response.md#load-api-reference-status-errors) + [Neptune Loader-Antwortobjekt Get-Status `errorLogs`](load-api-reference-status-response.md#load-api-reference-error-logs) + [Neptune Loader-Beispiele Get-Status](load-api-reference-status-examples.md) + [Beispiel für eine Ladestatusanforderung](load-api-reference-status-examples.md#load-api-reference-status-examples-status-request) + [Beispiel für eine loadIds-Anforderung](load-api-reference-status-examples.md#load-api-reference-status-examples-loadId-request) + [Beispiel für eine Detailstatusanforderung](load-api-reference-status-examples.md#load-api-reference-status-examples-details-request) + [Neptune Loader-Beispiele Get-Status `errorLogs`](load-api-reference-error-logs-examples.md) + [Beispiel für eine Detailstatusantwort bei Fehlern](load-api-reference-error-logs-examples.md#load-api-reference-status-examples-details-request-errors) + [Beispiel für den Fehler `Data prefetch task interrupted`](load-api-reference-error-logs-examples.md#load-api-reference-status-examples-task-interrupted) # Neptune Loader-Anfragen Get-Status ## Syntax der Loader-Anfrage Get-Status ``` GET https://your-neptune-endpoint:port/loader?loadId=loadId ``` ``` GET https://your-neptune-endpoint:port/loader/loadId ``` ``` GET https://your-neptune-endpoint:port/loader ``` ## Neptune Loader-Anforderungsparameter Get-Status + **`loadId`**   –   Die ID des Ladeauftrags. Wenn Sie keinen Wert angeben`loadId`, wird eine Ladeliste IDs zurückgegeben. + **`details`**   –   Fügt über den Gesamtstatus hinausgehende Details hinzu. *Zulässige Werte*: `TRUE`, `FALSE`. *Standardwert*: `FALSE`. + **`errors`**   –   Fügt die Liste der Fehler ein. *Zulässige Werte*: `TRUE`, `FALSE`. *Standardwert*: `FALSE`. Die Fehlerliste ist segmentiert. Die Parameter `page` und `errorsPerPage` erlauben Ihnen das seitenweise Durchlaufen aller Fehler. + **`page`**   –   Die Fehlerseitenzahl. Dieser Wert ist nur gültig, wenn der `errors`-Parameter auf `TRUE` eingestellt ist. *Zulässige Werte*: Positive Ganzzahlen. *Standardwert*: 1. + **`errorsPerPage`**   –   Die Anzahl der Fehler pro Seite. Dieser Wert ist nur gültig, wenn der `errors`-Parameter auf `TRUE` eingestellt ist. *Zulässige Werte*: Positive Ganzzahlen. *Standardwert*: 10. + **`limit`**   –   Die Anzahl der Lade-IDs, die aufgelistet werden sollen. Nur gültig, wenn eine Ladeliste angefordert wird, IDs indem eine `GET` Anfrage ohne `loadId` Angabe gesendet wird. *Zulässige Werte*: Positive Ganzzahlen von 1 bis 100. *Standardwert*: 100. + **`includeQueuedLoads`**— Ein optionaler Parameter, der verwendet werden kann, um das Laden IDs von Ladeanforderungen in der Warteschlange auszuschließen, wenn eine Ladeliste angefordert IDs wird. Standardmäßig `LOAD_IN_QUEUE` sind die Ladevorgänge IDs aller Ladejobs mit Status in einer solchen Liste enthalten. Sie werden vor dem Laden IDs anderer Jobs angezeigt, sortiert nach dem Zeitpunkt, zu dem sie der Warteschlange hinzugefügt wurden, vom letzten zum frühesten. *Zulässige Werte*: `TRUE`, `FALSE`. *Standardwert*: `TRUE`. # Antworten von Neptune Loader Get-Status Die folgende Beispielantwort der Get-Status Neptune-API beschreibt die Gesamtstruktur der Antwort, erklärt die verschiedenen Felder und ihre Datentypen sowie die Fehlerbehandlung und die Fehlerprotokolldetails. ## JSON-Layout für Neptune Get-Status Loader-Antworten Das allgemeine Layout einer Loader-Status-Antwort sieht wie folgt aus: ``` { "status" : "200 OK", "payload" : { "feedCount" : [ { "LOAD_FAILED" : number } ], "overallStatus" : { "fullUri" : "s3://bucket/key", "runNumber" : number, "retryNumber" : number, "status" : "string", "totalTimeSpent" : number, "startTime" : number, "totalRecords" : number, "totalDuplicates" : number, "parsingErrors" : number, "datatypeMismatchErrors" : number, "insertErrors" : number, }, "failedFeeds" : [ { "fullUri" : "s3://bucket/key", "runNumber" : number, "retryNumber" : number, "status" : "string", "totalTimeSpent" : number, "startTime" : number, "totalRecords" : number, "totalDuplicates" : number, "parsingErrors" : number, "datatypeMismatchErrors" : number, "insertErrors" : number, } ], "errors" : { "startIndex" : number, "endIndex" : number, "loadId" : "string, "errorLogs" : [ ] } } } ``` ## Neptune Loader Get-Status `overallStatus` und `failedFeeds` Antwortobjekte Die möglichen Antworten, die für jeden fehlgeschlagenen Feed zurückgegeben werden, einschließlich Fehlerbeschreibungen, sind die gleichen wie für das Objekt `overallStatus` in einer `Get-Status`-Antwort. Die folgenden Felder werden im Objekt `overallStatus` für alle Ladevorgänge und im Objekt `failedFeeds` für jeden fehlgeschlagenen Feed angegeben: + **`fullUri` **  –   Der URI der Datei/der Dateien, die geladen werden soll(en). *Typ:* *Zeichenfolge* *Format*: `s3://bucket/key`. + **`runNumber`**   –   Die Zahl der Ausführungen dieses Ladevorgangs oder Feeds. Diese wird um eins erhöht, wenn der Ladevorgang neu gestartet wird. *Typ:* *unsigned long*. + **`retryNumber`**   –   Die Zahl der Wiederholungen dieses Ladevorgangs oder Feeds. Diese wird um eins erhöht, wenn der Loader einen Feed oder Ladevorgang automatisch wiederholt. *Typ:* *unsigned long*. + **`status`**   –   Der zurückgegebene Status des Ladevorgangs oder Feeds. `LOAD_COMPLETED` gibt einen erfolgreichen Ladevorgang ohne Probleme an. Eine Liste weiterer Ladestatusmeldungen finden Sie unter [Neptune Loader-Fehler- und Feed-Nachrichten](loader-message.md). *Typ:* *Zeichenfolge*. + **`totalTimeSpent`**   –   Die Zeit in Sekunden, die für das Analysieren und Einfügen von Daten für den Ladevorgang oder Feed verbraucht wurde. Dabei wird nicht die Zeit für das Abrufen der Liste der Quelldateien berücksichtigt. *Typ:* *unsigned long*. + **`totalRecords`**   –   Die Gesamtzahl der Datensätze, die geladen wurden oder deren Laden versucht wurde. *Typ:* *unsigned long*. Beachten Sie, dass sich die Zahl der Datensätze beim Laden aus einer CSV-Datei nicht auf die Anzahl der geladenen Zeilen bezieht, sondern auf die Anzahl der einzelnen Datensätze in diesen Zeilen. Betrachten Sie beispielsweise eine winzige CSV-Datei wie diese: ``` ~id,~label,name,team 'P-1','Player','Stokes','England' ``` Neptune würde annehmen, dass diese Datei 3 Datensätze enthält: ``` P-1 label Player P-1 name Stokes P-1 team England ``` + **`totalDuplicates`**   –   Die Anzahl der gefundenen duplizierten Datensätze. *Typ:* *unsigned long*. Wie im Fall von `totalRecords` enthält dieser Wert die Anzahl der einzelnen duplizierten Datensätze in einer CSV-Datei, nicht die Anzahl der duplizierten Zeilen. Betrachten Sie beispielsweise diese kleine CSV-Datei: ``` ~id,~label,name,team P-2,Player,Kohli,India P-2,Player,Kohli,India ``` Der nach dem Laden zurückgegebene Status würde wie folgt aussehen und insgesamt 6 Datensätze melden, von denen 3 Duplikate sind: ``` { "status": "200 OK", "payload": { "feedCount": [ { "LOAD_COMPLETED": 1 } ], "overallStatus": { "fullUri": "(the URI of the CSV file)", "runNumber": 1, "retryNumber": 0, "status": "LOAD_COMPLETED", "totalTimeSpent": 3, "startTime": 1662131463, "totalRecords": 6, "totalDuplicates": 3, "parsingErrors": 0, "datatypeMismatchErrors": 0, "insertErrors": 0 } } } ``` Bei openCypher-Ladevorgängen wird ein Duplikat gezählt, wenn: + Der Loader erkennt, dass eine Zeile in einer Knotendatei eine ID ohne ID-Bereich hat, die mit einem anderen ID-Wert ohne ID-Bereich identisch ist, entweder in einer anderen Zeile oder als Teil eines vorhandenen Knotens. + Der Loader erkennt, dass eine Zeile in einer Knotendatei eine ID mit ID-Bereich hat, die mit einem anderen ID-Wert mit ID-Bereich identisch ist, entweder in einer anderen Zeile oder als Teil eines vorhandenen Knotens. Siehe [Besondere Überlegungen beim Laden von openCypher-Daten](load-api-reference-load.md#load-api-reference-load-parameters-opencypher). + **`parsingErrors`**   –   Die Anzahl der aufgetretenen Analysefehler. *Typ:* *unsigned long*. + **`datatypeMismatchErrors`**   –   Die Anzahl der Datensätze mit einem Datentyp, der nicht mit den angegebenen Daten übereinstimmt. *Typ:* *unsigned long*. + **`insertErrors`**   –   Die Anzahl der Datensätze, die aufgrund von Fehlern nicht eingefügt werden konnten. *Typ:* *unsigned long*. ## Neptune Loader-Antwortobjekt Get-Status `errors` Fehler lassen sich in die folgenden Kategorien einteilen: + **`Error 400`**   –   Eine ungültige `loadId` gibt den HTTP-Fehler `400` für ungültige Anforderungen zurück. Die Nachricht beschreibt den Fehler. + **`Error 500`**   –   Eine gültige Anforderung, die nicht verarbeitet werden kann, gibt den internen HTTP-Serverfehler `500` zurück. Die Nachricht beschreibt den Fehler. Die Liste der Fehler- und Feed-Meldungen, die der Loader im Fehlerfall zurückgibt, finden Sie unter [Neptune Loader-Fehler- und Feed-Nachrichten](loader-message.md). Wenn ein Fehler auftritt, wird das JSON-Objekt `errors` im `BODY` der Antwort mit den folgenden Feldern zurückgegeben: + **`startIndex`**   –   Der Index des ersten enthaltenen Fehlers. *Typ:* *unsigned long*. + **`endIndex`**   –   Der Index des letzten enthaltenen Fehlers. *Typ:* *unsigned long*. + **`loadId`**   –   Die ID des Ladeauftrags. Sie können diese ID verwenden, um die Fehler für den Ladevorgang zu drucken, indem Sie den `errors`-Parameter auf `TRUE` festlegen. *Typ:* *Zeichenfolge*. + **`errorLogs`**   –   Eine Liste der Fehler. *Typ:* *Liste*. ## Neptune Loader-Antwortobjekt Get-Status `errorLogs` Das Objekt `errorLogs` unter `errors` der Get-Status-Antwort des Loaders enthält ein Objekt, das jeden Fehler anhand der folgenden Felder beschreibt: + **`errorCode`**   –   Identifiziert die Art des Fehlers. Dabei kann es sich um einen der folgenden Werte handeln: + `PARSING_ERROR` + `S3_ACCESS_DENIED_ERROR` + `FROM_OR_TO_VERTEX_ARE_MISSING` + `ID_ASSIGNED_TO_MULTIPLE_EDGES` + `SINGLE_CARDINALITY_VIOLATION` + `FILE_MODIFICATION_OR_DELETION_ERROR` + `OUT_OF_MEMORY_ERROR` + `INTERNAL_ERROR` (wird zurückgegeben, wenn der Massen-Loader die Art des Fehlers nicht bestimmen kann). + **`errorMessage`**   –   Eine Meldung mit einer Beschreibung des Fehlers. Dabei kann es sich um eine generische Meldung handeln, die mit dem Fehlercode verknüpft ist, oder um eine spezifische Meldung mit Details, beispielsweise zu einem fehlenden from/to Eckpunkt oder zu einem Analysefehler. + **`fileName`**   –   Der Name des Feeds. + **`recordNum`**   –   Bei einem Analysefehler ist dies die Nummer des Datensatzes in der Datensatzdatei, der nicht analysiert werden konnte. Sie ist auf Null festgelegt, wenn die Datensatznummer nicht auf den Fehler zutrifft oder wenn sie nicht bestimmt werden konnte. Beispielsweise würde der Massen-Loader einen Analysefehler generieren, wenn er in einer RDF-`nquads`-Datei eine fehlerhafte Zeile wie die folgende finden würde: ``` |http://base#predicate> . ``` Wie Sie sehen können, sollte dem zweiten `http` in der Zeile oben eher ein  `<`  als ein  `|`  vorangestellt werden. Das resultierende Fehlerobjekt unter `errorLogs` in einer Statusantwort würde wie folgt aussehen: ``` { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 12345 }, ``` # Neptune Loader-Beispiele Get-Status Die folgenden Beispiele zeigen die Verwendung der Get-Status-API des Neptune-Loaders, mit der Sie Informationen über den Status Ihrer Datenladungen in die Amazon Neptune Neptune-Graphdatenbank abrufen können. Diese Beispiele decken drei Hauptszenarien ab: Abrufen des Status einer bestimmten Ladung, Auflisten der verfügbaren Last und Abrufen detaillierter IDs Statusinformationen für eine bestimmte Last. ## Beispiel für eine Ladestatusanforderung Dies ist eine Anforderung, die über HTTP `GET` mit dem Befehl `curl` gesendet wird. ``` curl -X GET 'https://your-neptune-endpoint:port/loader/loadId (a UUID)' ``` **Example Antwort** ``` { "status" : "200 OK", "payload" : { "feedCount" : [ { "LOAD_FAILED" : 1 } ], "overallStatus" : { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } } } ``` ## Beispiel für eine loadIds-Anforderung Dies ist eine Anforderung, die über HTTP `GET` mit dem Befehl `curl` gesendet wird. ``` curl -X GET 'https://your-neptune-endpoint:port/loader?limit=3' ``` **Example Antwort** ``` { "status" : "200 OK", "payload" : { "loadIds" : [ "a2c0ce44-a44b-4517-8cd4-1dc144a8e5b5", "09683a01-6f37-4774-bb1b-5620d87f1931", "58085eb8-ceb4-4029-a3dc-3840969826b9" ] } } ``` ## Beispiel für eine Detailstatusanforderung Dies ist eine Anforderung, die über HTTP `GET` mit dem Befehl `curl` gesendet wird. ``` curl -X GET 'https://your-neptune-endpoint:port/loader/loadId (a UUID)?details=true' ``` **Example Antwort** ``` { "status" : "200 OK", "payload" : { "failedFeeds" : [ { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } ], "feedCount" : [ { "LOAD_FAILED" : 1 } ], "overallStatus" : { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } } } ``` # Neptune Loader-Beispiele Get-Status `errorLogs` Die folgenden Beispiele zeigen die detaillierte Statusantwort des Neptune-Loaders, wenn beim Laden der Daten Fehler aufgetreten sind. Die Beispiele veranschaulichen die Struktur der Antwort, einschließlich Informationen über fehlgeschlagene Feeds, den Gesamtstatus und detaillierte Fehlerprotokolle. ## Beispiel für eine Detailstatusantwort bei Fehlern Dies ist eine Anforderung, die über HTTP `GET` mit `curl` gesendet wird: ``` curl -X GET 'https://your-neptune-endpoint:port/loader/0a237328-afd5-4574-a0bc-c29ce5f54802?details=true&errors=true&page=1&errorsPerPage=3' ``` **Example Beispiel für eine Detailantwort bei Fehlern** Dies ist ein Beispiel für die Antwort, die Sie möglicherweise für die Abfrage oben erhalten, wobei das Objekt `errorLogs` die aufgetretenen Ladefehler auflistet: ``` { "status" : "200 OK", "payload" : { "failedFeeds" : [ { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 } ], "feedCount" : [ { "LOAD_FAILED" : 1 } ], "overallStatus" : { "datatypeMismatchErrors" : 0, "fullUri" : "s3://bucket/key", "insertErrors" : 0, "parsingErrors" : 5, "retryNumber" : 0, "runNumber" : 1, "status" : "LOAD_FAILED", "totalDuplicates" : 0, "totalRecords" : 5, "totalTimeSpent" : 3.0 }, "errors" : { "endIndex" : 3, "errorLogs" : [ { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 1 }, { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 2 }, { "errorCode" : "PARSING_ERROR", "errorMessage" : "Expected '<', found: |", "fileName" : "s3://bucket/key", "recordNum" : 3 } ], "loadId" : "0a237328-afd5-4574-a0bc-c29ce5f54802", "startIndex" : 1 } } } ``` ## Beispiel für den Fehler `Data prefetch task interrupted` Wenn Sie den Status `LOAD_FAILED` erhalten und anschließend detailliertere Informationen anfordern, kann als Fehler `PARSING_ERROR` mit der Meldung `Data prefetch task interrupted` zurückgegeben werden: ``` "errorLogs" : [ { "errorCode" : "PARSING_ERROR", "errorMessage" : "Data prefetch task interrupted: Data prefetch task for 11467 failed", "fileName" : "s3://amzn-s3-demo-bucket/some-source-file", "recordNum" : 0 } ] ``` Dieser Fehler tritt bei einer temporären Unterbrechung des Datenladevorgangs auf, die in der Regel nicht durch Ihre Anforderung oder Ihre Daten verursacht wurde. Er kann in der Regel behoben werden, indem Sie einfach die Massen-Upload-Anforderung wiederholen. Wenn Sie Standardeinstellungen verwenden, nämlich `"mode":"AUTO"` und `"failOnError":"TRUE"`, überspringt der Loader Dateien, die er bereits erfolgreich geladen hat und fährt mit dem Laden von Dateien fort, die noch nicht geladen wurden, als die Unterbrechung stattfand.