Disposition JSON Objets OverallStatus objet d'erreurs Objet ErrorLogs

Réponses de Neptune Loader Get-Status

Disposition JSON de la réponse Get-Status de Neptune Loader

La structure générale d'une réponse d'état du chargeur est la suivante :


{
    "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 et objets de réponse `overallStatusfailedFeeds`

Les réponses possibles renvoyées pour chaque flux ayant échoué, y compris les descriptions des erreurs, sont les mêmes que pour l'overallStatusobjet de la Get-Status réponse.

Les champs suivants apparaissent dans l'overallStatusobjet pour tous les chargements et dans l'failedFeedsobjet pour chaque alimentation ayant échoué :

fullUri— L'URI du ou des fichiers à charger.

Type : chaîne

Format : s3://bucket/key.
runNumber— Le numéro d'exécution de ce chargement ou de ce flux. Ce nombre est incrémenté lorsque le chargement est redémarré.

Type : long non signé.
retryNumber— Le numéro de nouvelle tentative de ce chargement ou de ce flux. Ce nombre est incrémenté lorsque le chargeur relance automatiquement un flux ou un chargement.

Type : long non signé.
status— L'état renvoyé du chargement ou de l'alimentation. LOAD_COMPLETEDindique un chargement réussi sans problème. Pour obtenir la liste des autres messages relatifs à l'état du chargement, reportez-vous à la section. Message d'erreur et de flux liés au chargeur Neptune

Type : chaîne.
totalTimeSpent— Le temps, en secondes, passé à analyser et à insérer des données pour le chargement ou le flux. N'inclut pas le temps consacré à l'extraction de la liste de fichiers source.

Type : long non signé.
totalRecords— Nombre total d'enregistrements chargés ou tentés de charger.

Type : long non signé.

Notez que lors du chargement à partir d'un fichier CSV, le nombre d'enregistrements ne fait pas référence au nombre de lignes chargées, mais au nombre d'enregistrements individuels sur ces lignes. Par exemple, prenez un petit fichier CSV comme celui-ci :
```
~id,~label,name,team
'P-1','Player','Stokes','England'
```
Neptune considère que ce fichier contient 3 enregistrements, à savoir :
```
P-1  label Player
P-1  name  Stokes
P-1  team  England
```
totalDuplicates— Le nombre d'enregistrements dupliqués rencontrés.

Type : long non signé.

Comme dans le cas du totalRecords décompte, cette valeur contient le nombre d'enregistrements individuels dupliqués dans un fichier CSV, et non le nombre de lignes dupliquées. Prenez ce petit fichier CSV, par exemple :
```
~id,~label,name,team
P-2,Player,Kohli,India
P-2,Player,Kohli,India
```
Le statut renvoyé après le chargement ressemblerait à ceci, signalant 6 enregistrements au total, dont 3 sont des doublons :
```
{
  "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
    }
  }
}
```
Pour les chargements OpenCypher, un doublon est compté lorsque :
- Le chargeur détecte qu'une ligne d'un fichier de nœud possède un identifiant sans espace d'identification identique à une autre valeur d'identifiant sans espace d'identification, que ce soit dans une autre ligne ou appartenant à un nœud existant.
- Le chargeur détecte qu'une ligne d'un fichier de nœud possède un ID avec un espace ID identique à une autre valeur d'ID avec espace ID, soit dans une autre ligne, soit appartenant à un nœud existant.
Consultez Considérations spéciales relatives au chargement de données OpenCypher.
parsingErrors— Nombre d'erreurs d'analyse rencontrées.

Type : long non signé.
datatypeMismatchErrors— Le nombre d'enregistrements dont le type de données ne correspond pas aux données fournies.

Type : long non signé.
insertErrors— Le nombre d'enregistrements qui n'ont pas pu être insérés en raison d'erreurs.

Type : long non signé.

Objet de réponse Neptune Loader Get-Status `errors`

Les erreurs sont réparties en plusieurs catégories :

Error 400— Une requête non valide loadId renvoie une erreur de requête HTTP 400 incorrecte. Le message décrit l'erreur.
Error 500— Une demande valide qui ne peut pas être traitée renvoie une erreur 500 interne du serveur HTTP. Le message décrit l'erreur.

Consultez Message d'erreur et de flux liés au chargeur Neptune la liste des messages d'erreur et de fil renvoyés par le chargeur en cas d'erreur.

En cas d'erreur, un errors objet JSON est renvoyé dans BODY la réponse, avec les champs suivants :

startIndex— L'index de la première erreur incluse.

Type : long non signé.
endIndex— L'index de la dernière erreur incluse.

Type : long non signé.
loadId— L'ID du chargement. Vous pouvez utiliser cet ID pour afficher les erreurs du chargement en définissant le paramètre errors sur TRUE.

Type : chaîne.
errorLogs— La liste des erreurs.

Type : liste.

Objet de réponse Neptune Loader Get-Status `errorLogs`

L'errorLogsobjet situé errors sous la réponse Get-Status du chargeur contient un objet décrivant chaque erreur à l'aide des champs suivants :

errorCode— Identifie la nature de l'erreur.

Elle peut prendre l'une des valeurs suivantes :
- 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(renvoyé lorsque le chargeur en vrac ne peut pas déterminer le type de l'erreur).
errorMessage— Un message décrivant l'erreur.

Il peut s'agir d'un message générique associé au code d'erreur ou d'un message spécifique contenant des détails, par exemple concernant un sommet de départ ou de destination manquant ou une erreur d'analyse.
fileName— Le nom du flux.
recordNum— Dans le cas d'une erreur d'analyse, il s'agit du numéro d'enregistrement dans le fichier de l'enregistrement qui n'a pas pu être analysé. Il est mis à zéro si le numéro d'enregistrement ne s'applique pas à l'erreur ou s'il n'a pas pu être déterminé.

Par exemple, le chargeur en bloc générerait une erreur d'analyse s'il rencontrait une ligne défectueuse telle que la suivante dans un fichier RDF nquads :


<http://base#subject> |http://base#predicate> <http://base#true> .

Comme vous pouvez le voir, la seconde http de la ligne ci-dessus doit être précédée de < plutôt que|. L'objet d'erreur résultant errorLogs dans une réponse d'état :


{
    "errorCode" : "PARSING_ERROR",
    "errorMessage" : "Expected '<', found: |",
    "fileName" : "s3://bucket/key",
    "recordNum" : 12345
},

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Requêtes

Exemples

Réponses de Neptune Loader Get-Status

Disposition JSON de la réponse Get-Status de Neptune Loader

Neptune Loader Get-Status et objets de réponse overallStatusfailedFeeds

Objet de réponse Neptune Loader Get-Status errors

Objet de réponse Neptune Loader Get-Status errorLogs

Neptune Loader Get-Status et objets de réponse `overallStatusfailedFeeds`

Objet de réponse Neptune Loader Get-Status `errors`

Objet de réponse Neptune Loader Get-Status `errorLogs`