기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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 로더 오류 및 피드 메시지](loader-message.md) 섹션을 참조하세요.
*유형:* *문자열*.
+ **`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 데이터 로드에 대한 특별 고려 사항](load-api-reference-load.md#load-api-reference-load-parameters-opencypher)을(를) 참조하세요.
+ **`parsingErrors`** – 발생한 분석 오류 수.
*유형:* *unsigned long*.
+ **`datatypeMismatchErrors`** – 주어진 데이터와 일치하지 않은 데이터 유형이 있는 레코드 수.
*유형:* *unsigned long*.
+ **`insertErrors`** – 오류로 인해 삽입할 수 없는 레코드 수.
*유형:* *unsigned long*.
## Neptune 로더 Get-Status `errors` 응답 객체
오류는 다음 범주로 분류됩니다.
+ **`Error 400`** – 잘못된 `loadId`는 HTTP `400` Bad Request 오류를 반환합니다. 메시지에서 오류를 설명합니다.
+ **`Error 500`** – 처리할 수 없는 유효 요청은 HTTP `500` 내부 서버 오류를 반환합니다. 메시지에서 오류를 설명합니다.
오류 발생 시 로더가 반환하는 오류 및 피드 메시지 목록은 [Neptune 로더 오류 및 피드 메시지](loader-message.md) 섹션을 참조하세요.
오류가 발생하면 응답의 `BODY`에 다음 필드와 함께 JSON `errors` 객체가 반환됩니다.
+ **`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#predicate> .
```
보시다시피 위 행의 두 번째 `http`는 `|` 기호가 아니라 `<` 기호 앞에 와야 합니다. 상태 응답의 `errorLogs`에 결과 오류 객체는 다음과 같습니다.
```
{
"errorCode" : "PARSING_ERROR",
"errorMessage" : "Expected '<', found: |",
"fileName" : "s3://bucket/key",
"recordNum" : 12345
},
```