View a markdown version of this page

Neptune-Export API를 사용하여 Neptune-Export 작업 실행 - Amazon Neptune
작업 모니터링작업 취소

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

Neptune-Export API를 사용하여 Neptune-Export 작업 실행

CloudFormation 스택의 출력 탭에는 NeptuneExportApiUri도 포함되어 있습니다. Neptune-Export 엔드포인트에 요청을 보낼 때마다 이 URI를 사용합니다.

내보내기 작업 실행

  • 내보내기를 실행하는 사용자 또는 역할에 execute-api:Invoke 권한이 부여되었는지 확인하세요.

  • Neptune-Export를 설치할 때 CloudFormation 스택에서 EnableIAM 파라미터를 true로 설정한 경우 Neptune-Export API에 대한 모든 요청에 Sigv4 서명해야 합니다. awscurl을 사용하여 API에 요청하는 것이 좋습니다. 여기의 모든 예제에서는 IAM 인증이 활성화된 것으로 가정합니다.

  • Neptune-Export를 설치할 때 CloudFormation 스택에 VPCOnly 파라미터를 true로 설정한 경우 VPC 내에서, 보통 해당 VPC에 있는 Amazon EC2 인스턴스에서 Neptune-Export API를 호출해야 합니다.

데이터 내보내기를 시작하려면 command 및 outputS3Path 요청 파라미터와 endpoint 내보내기 파라미터를 사용하여 NeptuneExportApiUri 엔드포인트에 요청을 보내면 됩니다.

Neptune에서 속성 그래프 데이터를 내보내 Amazon S3에 게시하는 요청의 예는 다음과 같습니다.

curl \
  (your NeptuneExportApiUri) \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{
        "command": "export-pg",
        "outputS3Path": "s3://(your Amazon S3 bucket)/neptune-export",
        "params": { "endpoint": "(your Neptune endpoint DNS name)" }
      }'

마찬가지로, 다음은 Neptune에서 Amazon S3로 RDF 데이터를 내보내는 요청의 예입니다.

curl \
  (your NeptuneExportApiUri) \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{
        "command": "export-rdf",
        "outputS3Path": "s3://(your Amazon S3 bucket)/neptune-export",
        "params": { "endpoint": "(your Neptune endpoint DNS name)" }
      }'

command 요청 파라미터를 생략하면 기본적으로 Neptune-Export는 Neptune에서 속성 그래프 데이터를 내보내려고 시도합니다.

이전 명령이 성공적으로 실행된 경우 출력은 다음과 같습니다.

{
  "jobName": "neptune-export-abc12345-1589808577790",
  "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f"
}

방금 시작한 내보내기 작업 모니터링

실행 중인 작업을 모니터링하려면 다음과 같이 jobID를 NeptuneExportApiUri에 추가하면 됩니다.

curl \
  (your NeptuneExportApiUri)/(the job ID)

서비스가 아직 내보내기 작업을 시작하지 않은 경우 응답은 다음과 같습니다.

{
  "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f",
  "status": "pending"
}

내보내기 작업이 시작된 후 명령을 반복하면 응답은 다음과 같습니다.

{
  "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f",
  "status": "running",
  "logs": "https://us-east-1.console.aws.amazon.com/cloudwatch/home?..."
}

상태 호출에서 제공한 URI를 사용하여 CloudWatch Logs에서 로그를 열면 내보내기 진행 상황을 자세히 모니터링할 수 있습니다.

CloudWatch Logs 로그 화면의 스크린샷입니다.

실행 중인 내보내기 작업 취소

AWS Management Console을 사용하여 실행 중인 내보내기 작업을 취소하려면

  1. https://console.aws.amazon.com/batch/에서 AWS Batch 콘솔을 엽니다.

  2. 작업을 선택합니다.

  3. 취소하려는 실행 중인 작업을 jobID를 기준으로 찾습니다.

  4. 작업 취소를 선택합니다.

Neptune 내보내기 API를 사용하여 실행 중인 내보내기 작업을 취소하려면:

다음과 같이 jobID가 추가된 상태에서 HTTP DELETE 요청을 NeptuneExportApiUri로 보냅니다.

curl -X DELETE \
  (your NeptuneExportApiUri)/(the job ID)