翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

RDF データのネイティブエクスポート

Neptune エクスポート API を使用すると、Neptune データベースから Amazon S3 にデータをエクスポートできます。RDF データは N-Triples 形式または N-Quads 形式でエクスポートできます。

ネイティブエクスポートの仕組み

ネイティブエクスポートは Neptune クラスターのライターインスタンスで実行され、マルチパートアップロードを使用してエクスポートされたデータを Amazon S3 に書き込みます。エクスポートはライターインスタンスのコンピューティングリソースを使用するため、本番環境のワークロードに影響を与えないように、クローンされたクラスターに対してエクスポートを実行することを強くお勧めします。詳細については、「推奨事項」を参照してください。

エクスポートスループット

エクスポートスループットは、 までのインスタンスサイズに合わせてほぼ直線的にスケーリングされますr7i.16xlarge。保守的な計画の見積もりとして、vCPU あたり 1 秒あたり約 50,000 個のステートメントを想定します。

エクスポート期間を見積もるには、次の式を使用します。

export_seconds = total_statements / (vCPUs × 50,000)

実際のスループットは、述語基数、ステートメントの複雑さ、クラスターサイズなどのデータセットの特性によって異なります。

前提条件

エクスポート API を使用する前に、以下を行う必要があります。

推奨事項

本番環境のパフォーマンスへの影響を避けるため、読み取り/書き込みワークロードなしでクローンされたクラスターでエクスポートオペレーションを実行することを強くお勧めします。

最適なprice-to-performanceの比率を得るには、エクスポートオペレーションに 16xlarge インスタンスを使用することをお勧めします。このインスタンスタイプは以下を提供します。

IAM アクセス許可

エクスポート機能には、2 つの個別の 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 ロールを作成してクラスターに関連付ける手順については、「Create an IAM role to allow Neptune to access Amazon S3」を参照してください。

次のアクセス許可ポリシーを 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"
    }
  ]
}

エンドポイントのエクスポート

データをエクスポートするには、https://your-neptune-endpoint:port/exportエンドポイントに HTTP リクエストを送信します。

エクスポートリクエスト構文

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>"

制限事項

ネイティブエクスポートには以下の制限があります。