本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

RDF 数据的原生导出

海王星导出 API 使您能够将数据从海王星数据库导出到亚马逊 S3。您可以以 N-Triples 或 N-Quads 格式导出 RDF 数据。

原生导出的工作原理

本机导出在 Neptune 集群的写入器实例上运行，并使用分段上传将导出的数据写入到 Amazon S3。由于导出使用写入器实例的计算资源，因此我们强烈建议对克隆集群运行导出，以避免影响生产工作负载。有关更多信息，请参阅建议。

出口吞吐量

导出吞吐量大致呈线性增长，实例大小最大为。r7i.16xlarge根据保守的规划估计，预计每个 vCPU 每秒大约有 50,000 条语句。

使用此公式估算出口持续时间：

export_seconds = total_statements / (vCPUs × 50,000)

实际吞吐量取决于数据集特征，包括谓词基数、语句复杂性和集群大小。

先决条件

在使用导出 API 之前，您必须：

建议

我们强烈建议在没有任何 read/write 工作负载的克隆集群上运行导出操作，以避免对生产性能产生影响。

为了获得最佳的性价比，我们建议使用 16xlarg e 实例进行导出操作。此实例类型提供：

IAM 权限

导出功能涉及两个独立的 IAM 角色：

来电者权限（海王星数据访问操作）

调用导出 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"
    }
  ]
}

导出端点

要导出数据，您需要向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>"

限制

原生导出有以下限制：