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

RDF 데이터에 대한 기본 내보내기

Neptune 내보내기 API를 사용하면 Neptune 데이터베이스에서 Amazon S3로 데이터를 내보낼 수 있습니다. RDF 데이터를 N-Triples 또는 N-Quads 형식으로 내보낼 수 있습니다.

네이티브 내보내기 작동 방식

네이티브 내보내기는 Neptune 클러스터의 라이터 인스턴스에서 실행되며 멀티파트 업로드를 사용하여 내보낸 데이터를 Amazon S3에 씁니다. 내보내기는 라이터 인스턴스의 컴퓨팅 리소스를 사용하므로 프로덕션 워크로드에 영향을 주지 않도록 복제된 클러스터에 대해 내보내기를 실행하는 것이 좋습니다. 자세한 내용은 권장 사항을 참조하세요.

내보내기 처리량

내보내기 처리량은 인스턴스 크기에 따라 대략 선형적으로 최대 까지 확장됩니다r7i.16xlarge. 보수적인 계획 추정치로 vCPU당 초당 약 50,000개의 문을 예상합니다.

이 공식을 사용하여 내보내기 기간을 추정합니다.

export_seconds = total_statements / (vCPUs × 50,000)

실제 처리량은 조건자 카디널리티, 문 복잡성 및 클러스터 크기를 포함한 데이터 세트 특성에 따라 달라집니다.

사전 조건

내보내기 API를 사용하기 전에 다음을 수행해야 합니다.

권장 사항

프로덕션 성능에 영향을 주지 않도록 읽기/쓰기 워크로드 없이 복제된 클러스터에서 내보내기 작업을 실행하는 것이 좋습니다.

최적의 price-to-performance 비율을 얻으려면 내보내기 작업에 16xlarge 인스턴스를 사용하는 것이 좋습니다. 이 인스턴스 유형은 다음을 제공합니다.

IAM 권한

내보내기 기능에는 두 개의 개별 IAM 역할이 포함됩니다.

발신자 권한(Neptune 데이터 액세스 작업)

내보내기 API를 호출하는 IAM 보안 주체는 IAM 정책에 다음과 같은 Neptune 데이터 액세스 작업이 있어야 합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowNeptuneExportActions",
      "Effect": "Allow",
      "Action": [
        "neptune-db:StartExportJob",
        "neptune-db:GetExportJobStatus",
        "neptune-db:ListExportJobs",
        "neptune-db:CancelExportJob"
      ],
      "Resource": "arn:aws:neptune-db:us-east-1:123456789012:cluster-resource-id/*"
    }
  ]
}

자세한 내용은 IAM 데이터 액세스 정책 설명 사용을 참조하세요.

S3 액세스 역할 권한

iamRoleArn 요청 파라미터에 전달된 IAM 역할은 Neptune 클러스터와 연결되어야 하며 대상 S3 버킷에 쓸 수 있는 권한을 Neptune에 부여해야 합니다. IAM 역할을 생성하고 클러스터와 연결하는 단계는 Neptune이 Amazon S3에 액세스할 수 있도록 허용하는 IAM 역할 생성을 참조하세요.

S3 액세스 역할에 다음 권한 정책을 연결합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowS3WriteForNeptuneExport",
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:GetObject",
        "s3:PutObject",
        "s3:AbortMultipartUpload",
        "s3:GetBucketPublicAccessBlock"
      ],
      "Resource": [
        "arn:aws:s3:::amzn-s3-demo-bucket",
        "arn:aws:s3:::amzn-s3-demo-bucket/*"
      ]
    }
  ]
}

선택적 KMS 권한

내보내기 요청kmsKeyIdentifier에서를 지정하는 경우 S3 액세스 역할에 다음 권한을 추가합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowKMSForNeptuneExport",
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt",
        "kms:Encrypt",
        "kms:GenerateDataKey"
      ],
      "Resource": "arn:aws:kms:us-east-1:123456789012:key/key-id"
    }
  ]
}

엔드포인트 내보내기

데이터를 내보내려면 HTTP 요청을 https://your-neptune-endpoint:port/export 엔드포인트로 보냅니다.

내보내기 요청 구문

POST https://your-neptune-endpoint:port/export

요청 헤더

요청 본문

{
  "destination": "string",
  "format": "string",
  "iamRoleArn": "string",
  "region": "string",
  "compression": "string",
  "kmsKeyIdentifier": "string",
  "exportFilter": {
    "namedGraphUris": ["string"]
  }
}

요청 파라미터

응답 구문

{
  "status": "string",
  "payload": {
    "exportId": "string"
  }
}

내보내기 상태 엔드포인트

내보내기 작업의 상태를 확인하려면 내보내기 ID를 사용하여 내보내기 엔드포인트에 HTTP GET 요청을 보냅니다.

GET https://your-neptune-endpoint:port/export?exportId=export-id

요청 파라미터

응답 구문

{
  "status": "string",
  "payload": {
    "exportId": "string",
    "destination": "string",
    "status": "string",
    "statusReason": "string",
    "format": "string",
    "iamRoleArn": "string",
    "kmsKeyIdentifier": "string",
    "exportFilter": {
      "namedGraphUris": ["string"]
    },
    "exportTaskDetails": {
      "timeElapsedSeconds": number,
      "startTime": number,
      "numRecordsWritten": number,
      "progressPercentage": number
    }
  }
}

내보내기 엔드포인트 나열

모든 내보내기 작업을 나열하려면 HTTP GET 요청을 내보내기 엔드포인트로 보냅니다.

GET https://your-neptune-endpoint:port/export

응답 구문

{
  "status": "string",
  "payload": [
    "string"
  ]
}

내보내기 엔드포인트 취소

내보내기 작업을 취소하려면 내보내기 ID를 사용하여 내보내기 엔드포인트에 HTTP DELETE 요청을 보냅니다.

DELETE https://your-neptune-endpoint:port/export?exportId=export-id

요청 파라미터

응답 구문

{
  "status": "string",
  "payload": {
    "message": "string"
  }
}

출력 형식 내보내기

S3 디렉터리 구조

내보낸 데이터는 S3 버킷에 다음과 같이 구성됩니다.

s3://your-bucket/export-id/
├── data/
│   ├── part-00000.nt
│   ├── part-00001.nt
│   └── ...
└── export_status.json

오류 응답

일반적인 오류 코드

오류 응답 예

{
  "code": "BadRequestException",
  "requestId": "request-id", 
  "message": "Export already in progress with ID 'existing-id'. Please wait or cancel it first.",
  "detailedMessage": "Detailed error description"
}

예제

내보내기 시작

curl -X POST https://your-cluster-endpoint:8182/export \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "s3://my-bucket/exports/",
    "format": "ntriples", 
    "iamRoleArn": "arn:aws:iam::123456789012:role/neptune-export-role",
    "region": "us-west-2"
  }'

필터링된 내보내기 시작(명명된 그래프)

curl -X POST https://your-cluster-endpoint:8182/export \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "s3://my-bucket/exports/",
    "format": "nquads",
    "iamRoleArn": "arn:aws:iam::123456789012:role/neptune-export-role",
    "region": "us-west-2",
    "exportFilter": {
      "namedGraphUris": [
        "http://example.com/graph1",
        "http://example.com/graph2"
      ]
    }
  }'

내보내기 상태 확인

curl -X GET "https://your-cluster-endpoint:8182/export?exportId=<id>"

내보내기 취소

curl -X DELETE "https://your-cluster-endpoint:8182/export?exportId=<id>"

제한 사항

네이티브 내보내기에는 다음과 같은 제한 사항이 있습니다.