Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Ekspor asli untuk data RDF

API ekspor Neptune memungkinkan Anda mengekspor data dari database Neptune Anda ke Amazon S3. Anda dapat mengekspor data RDF dalam N-Quads format N-Triples atau.

Cara kerja ekspor asli

Ekspor asli berjalan pada instance penulis cluster Neptune Anda dan menulis data yang diekspor ke Amazon S3 menggunakan unggahan multipart. Karena ekspor menggunakan sumber daya komputasi instance penulis, kami sangat menyarankan menjalankan ekspor terhadap cluster kloning untuk menghindari dampak beban kerja produksi. Lihat Rekomendasi untuk informasi lebih lanjut.

Output ekspor

Output ekspor menskalakan kira-kira secara linier dengan ukuran instance hinggar7i.16xlarge. Sebagai perkiraan perencanaan konservatif, harapkan sekitar 50.000 pernyataan per detik per vCPU.

Gunakan rumus ini untuk memperkirakan durasi ekspor:

export_seconds = total_statements / (vCPUs × 50,000)

Throughput aktual tergantung pada karakteristik dataset termasuk kardinalitas predikat, kompleksitas pernyataan, dan ukuran cluster.

Prasyarat

Sebelum menggunakan API ekspor, Anda harus:

Rekomendasi

Kami sangat menyarankan menjalankan operasi ekspor pada cluster kloning tanpa read/write beban kerja apa pun untuk menghindari dampak pada kinerja produksi.

Untuk rasio harga terhadap kinerja yang optimal, sebaiknya gunakan instance 16xlarge untuk operasi ekspor. Jenis instance ini menyediakan:

Izin IAM

Fitur ekspor melibatkan dua peran IAM terpisah:

Izin pemanggil (tindakan akses data Neptunus)

Prinsip IAM yang memanggil API ekspor harus memiliki tindakan akses data Neptunus berikut dalam kebijakan IAM-nya:

{
  "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/*"
    }
  ]
}

Untuk informasi selengkapnya, lihat Menggunakan pernyataan kebijakan akses data IAM.

Izin peran akses S3

Peran IAM yang diteruskan dalam parameter iamRoleArn permintaan harus dikaitkan dengan cluster Neptunus Anda dan harus memberikan izin Neptune untuk menulis ke bucket S3 target. Untuk langkah-langkah membuat peran IAM dan mengaitkannya dengan cluster Anda, lihat Membuat peran IAM untuk mengizinkan Neptune mengakses Amazon S3.

Lampirkan kebijakan izin berikut ke peran akses 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/*"
      ]
    }
  ]
}

Izin KMS opsional

Jika Anda menentukan a kmsKeyIdentifier dalam permintaan ekspor, tambahkan izin berikut ke peran akses 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"
    }
  ]
}

Ekspor titik akhir

Untuk mengekspor data, Anda mengirim permintaan HTTP ke https://your-neptune-endpoint:port/export titik akhir.

Sintaks permintaan ekspor

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

Minta header

Isi permintaan

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

Permintaan parameter

Sintaksis Respons

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

Titik akhir status ekspor

Untuk memeriksa status tugas ekspor, Anda mengirim permintaan HTTP GET ke titik akhir ekspor dengan ID ekspor.

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

Permintaan parameter

Sintaksis Respons

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

Daftar titik akhir ekspor

Untuk mencantumkan semua tugas ekspor, Anda mengirim permintaan HTTP GET ke titik akhir ekspor.

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

Sintaksis Respons

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

Batalkan titik akhir ekspor

Untuk membatalkan tugas ekspor, Anda mengirim permintaan HTTP DELETE ke titik akhir ekspor dengan ID ekspor.

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

Permintaan parameter

Sintaksis Respons

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

Format keluaran ekspor

Struktur direktori S3

Data yang diekspor diatur dalam bucket S3 Anda sebagai berikut:

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

Tanggapan kesalahan

Kode kesalahan umum

Contoh respons kesalahan

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

Contoh

Mulai ekspor

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

Mulai ekspor yang difilter (grafik bernama)

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"
      ]
    }
  }'

Periksa status ekspor

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

Membatalkan ekspor

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

Batasan

Ekspor asli memiliki batasan berikut: