JSON 레이아웃 overallStatus 객체 오류 객체 errorLogs 객체

Neptune 로더 Get-Status 응답

Neptune Get-Status의 다음 예제 응답은 응답의 전체 구조를 API 설명하고, 다양한 필드와 데이터 유형, 오류 처리 및 오류 로그 세부 정보를 설명합니다.

Neptune 로더 Get-Status 응답 JSON 레이아웃

로더 상태 응답의 일반 레이아웃은 다음과 같습니다.


{
    "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 로더 Get-Status `overallStatus` 및 `failedFeeds` 응답 객체

오류 설명을 포함하여 실패한 각 피드에 대해 반환될 수 있는 응답은 Get-Status 응답의 overallStatus 객체에 대한 응답과 동일합니다.

모든 로드에 대한 overallStatus 객체 및 실패한 각 피드에 대한 failedFeeds 객체에 다음 필드가 표시됩니다.

fullUri - 로드할 파일 또는 파일의 URI입니다.

유형: 문자열

형식: s3://bucket/key.
runNumber – 이 로드 또는 피드의 실행 횟수. 이 숫자는 로드가 다시 시작될 때 증가합니다.

유형: unsigned long.
retryNumber – 이 로드 또는 피드의 재시도 횟수. 이 숫자는 로더가 피드 또는 로드를 자동 재시도할 때 증가합니다.

유형: unsigned long.
status – 로드 또는 피드의 반환된 상태(LOAD_COMPLETED는 로드가 문제없이 성공했음을 나타냄). 기타 로드 상태 메시지 목록은 Neptune 로더 오류 및 피드 메시지 섹션을 참조하세요.

유형: 문자열.
totalTimeSpent – 로드 또는 피드용 데이터의 분석 및 삽입에 소요된 시간(초). 소스 파일 목록을 가져오는 데 소요된 시간은 여기에 포함되지 않습니다.

유형: unsigned long.
totalRecords – 로드되거나 로드가 시도된 총 레코드 수.

유형: unsigned long.

CSV 파일에서 로드할 때 레코드 수는 로드된 줄 수가 아니라 해당 줄의 개별 레코드 수를 나타냅니다. 예를 들어 다음과 같은 작은 CSV 파일을 사용합니다.
```
~id,~label,name,team
'P-1','Player','Stokes','England'
```
Neptune은 이 파일에 다음과 같은 3개의 레코드가 포함된 것으로 간주합니다.
```
P-1  label Player
P-1  name  Stokes
P-1  team  England
```
totalDuplicates – 발생한 중복 레코드 수.

유형: unsigned long.

totalRecords 개수의 경우와 마찬가지로 이 값에는 파일의 개별 중복 레코드 수가 포함되며 중복 행 수는 포함되지 CSV 않습니다. 이 작은 CSV 파일을 예로 들어 보겠습니다.
```
~id,~label,name,team
P-2,Player,Kohli,India
P-2,Player,Kohli,India
```
로드 후 반환되는 상태는 다음과 같습니다. 총 6개의 레코드가 보고되며, 이 중 3개는 중복됩니다.
```
{
  "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
    }
  }
}
```
openCypher 로드의 경우 중복은 다음과 같은 경우에 계산됩니다.
- 로더는 노드 파일의 행에 있는 ID 공간이 없는 ID가 다른 행에 있거나 기존 노드에 속한 ID 공간이 없는 다른 ID 값과 동일한지 감지합니다.
- 로더는 노드 파일의 행에 ID 공간이 있는 다른 ID 값과 동일한 ID 공간을 가진 ID가 다른 행에 있거나 기존 노드에 속해 있음을 감지합니다.
openCypher 데이터 로드에 대한 특별 고려 사항을 참조하세요.
parsingErrors – 발생한 분석 오류 수.

유형: unsigned long.
datatypeMismatchErrors – 주어진 데이터와 일치하지 않은 데이터 유형이 있는 레코드 수.

유형: unsigned long.
insertErrors – 오류로 인해 삽입할 수 없는 레코드 수.

유형: unsigned long.

Neptune 로더 Get-Status `errors` 응답 객체

오류는 다음 범주로 분류됩니다.

Error 400 – 잘못된 는 HTTP 400 잘못된 요청 오류를 loadId 반환합니다. 메시지에서 오류를 설명합니다.
Error 500 – 처리할 수 없는 유효한 요청은 HTTP 500 내부 서버 오류를 반환합니다. 메시지에서 오류를 설명합니다.

오류 발생 시 로더가 반환하는 오류 및 피드 메시지 목록은 Neptune 로더 오류 및 피드 메시지 섹션을 참조하세요.

오류가 발생하면 JSON errors 객체가 응답BODY의 에 반환되고 다음 필드가 표시됩니다.

startIndex – 최초로 포함된 오류의 인덱스.

유형: unsigned long.
endIndex – 마지막으로 포함된 오류의 인덱스.

유형: unsigned long.
loadId – 로드의 ID. errors 파라미터를 TRUE로 설정하여 이 ID로 로드 오류를 인쇄할 수 있습니다.

유형: 문자열.
errorLogs – 오류 목록.

유형: 목록

Neptune 로더 Get-Status `errorLogs` 응답 객체

로더 Get-Status 응답의 errors에 있는 errorLogs 객체에는 다음 필드를 사용하여 각 오류를 설명하는 객체가 포함되어 있습니다.

errorCode – 오류의 특성을 식별합니다.

다음 값 중 하나일 수 있습니다.
- 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(대량 로더가 오류 유형을 확인할 수 없을 때 반환됨).
errorMessage – 메시지에서 오류를 설명합니다.

이는 오류 코드와 관련된 일반 메시지이거나 세부 정보가 포함된 특정 메시지(예: 시작/끝 버텍스 누락 또는 구문 분석 오류)일 수 있습니다.
fileName – 피드 이름입니다.
recordNum – 구문 분석 오류가 발생한 경우 레코드 파일에서 구문 분석할 수 없는 레코드 번호입니다. 레코드 번호가 오류에 해당되지 않거나 확인할 수 없는 경우 0으로 설정됩니다.

예를 들어 대량 로더가 RDF nquads 파일에서 다음과 같은 결함 있는 행이 발생한 경우 구문 분석 오류가 발생합니다.


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

보시다시피 위 행의 두 번째 http는 | 기호가 아니라 < 기호 앞에 와야 합니다. 상태 응답의 errorLogs에 결과 오류 객체는 다음과 같습니다.


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

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

요청

예시

Neptune 로더 Get-Status 응답

Neptune 로더 Get-Status 응답 JSON 레이아웃

Neptune 로더 Get-Status overallStatus 및 failedFeeds 응답 객체

Neptune 로더 Get-Status errors 응답 객체

Neptune 로더 Get-Status errorLogs 응답 객체

Neptune 로더 Get-Status `overallStatus` 및 `failedFeeds` 응답 객체

Neptune 로더 Get-Status `errors` 응답 객체

Neptune 로더 Get-Status `errorLogs` 응답 객체