本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

RDF 資料的原生匯出

Neptune 匯出 API 可讓您將資料從 Neptune 資料庫匯出至 Amazon S3。您可以匯出 N-Triples 或 N-Quads 格式的 RDF 資料。

原生匯出的運作方式

原生匯出會在 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 叢集相關聯，且必須授予 Neptune 寫入目標 S3 儲存貯體的許可。如需建立 IAM 角色並將其與叢集建立關聯的步驟，請參閱建立 IAM 角色以允許 Neptune 存取 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"
    }
  ]
}

匯出端點

若要匯出資料，請將 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>"

限制

原生匯出具有下列限制：