

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Neptune 로더 Get-Status `errorLogs` 예제
<a name="load-api-reference-error-logs-examples"></a>

 다음 예제에서는 데이터 로드 프로세스 중에 오류가 발생한 경우 Neptune 로더의 세부 상태 응답을 보여줍니다. 이 예제에서는 실패한 피드, 전체 상태 및 자세한 오류 로그에 대한 정보를 포함하여 응답의 구조를 보여줍니다.

## 오류 발생 시 세부 상태 응답 예제
<a name="load-api-reference-status-examples-details-request-errors"></a>

다음은 `curl`을 사용하여 HTTP `GET`을 통해 전송된 요청입니다.

------
#### [ AWS CLI ]

```
aws neptunedata get-loader-job-status \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --load-id {{0a237328-afd5-4574-a0bc-c29ce5f54802}} \
  --details \
  --errors \
  --errors-per-page 3 \
  --page 1
```

자세한 내용은 AWS CLI 명령 참조의 [get-loader-job-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-loader-job-status.html)를 참조하세요.

------
#### [ SDK ]

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.get_loader_job_status(
    loadId='{{0a237328-afd5-4574-a0bc-c29ce5f54802}}',
    details=True,
    errors=True,
    errorsPerPage=3,
    page=1
)

print(response)
```

------
#### [ awscurl ]

```
awscurl 'https://{{your-neptune-endpoint}}:{{port}}/loader/{{0a237328-afd5-4574-a0bc-c29ce5f54802}}?details=true&errors=true&page=1&errorsPerPage=3' \
  --region {{us-east-1}} \
  --service neptune-db
```

**참고**  
이 예제에서는 자격 AWS 증명이 환경에 구성되어 있다고 가정합니다. {{us-east-1}}을 Neptune 클러스터의 리전으로 바꿉니다.

------
#### [ curl ]

```
curl -X GET 'https://{{your-neptune-endpoint}}:{{port}}/loader/{{0a237328-afd5-4574-a0bc-c29ce5f54802}}?details=true&errors=true&page=1&errorsPerPage=3'
```

------

**Example 오류 발생 시 상세 응답**  
다음은 발생한 로드 오류를 나열하는 `errorLogs` 객체와 함께 위 쿼리에서 얻을 수 있는 응답의 예입니다.  

```
{
    "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-c29ce5f5480}}2",
            "startIndex" : 1
        }
    }
}
```

## `Data prefetch task interrupted` 오류 예제
<a name="load-api-reference-status-examples-task-interrupted"></a>

간혹 `LOAD_FAILED` 상태를 얻은 후 더 자세한 정보를 요청하면 다음과 같이 `Data prefetch task interrupted` 메시지가 있는 `PARSING_ERROR` 오류가 반환될 수 있습니다.

```
"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
    }
]
```

이 오류는 데이터 로드 프로세스에서 일반적으로 요청 또는 데이터로 인해 발생하지 않은 일시적인 중단이 있었을 때 발생합니다. 보통 대량 업로드 요청을 다시 실행하여 간단히 해결할 수 있습니다. 기본 설정인 `"mode":"AUTO"` 및 `"failOnError":"TRUE"`를 사용하는 경우, 로더는 이미 로드한 파일을 건너뛰고 중단이 발생했을 때 아직 로드하지 않은 파일 로드를 다시 시작합니다.