Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Nativer Export für RDF-Daten

Mit der Neptune-Export-API können Sie Daten aus Ihrer Neptune-Datenbank nach Amazon S3 exportieren. Sie können RDF-Daten in unser Format exportieren. N-Triples N-Quads

Wie funktioniert der native Export

Der native Export wird auf der Writer-Instance Ihres Neptune-Clusters ausgeführt und schreibt exportierte Daten mithilfe mehrteiliger Uploads in Amazon S3. Da der Export die Rechenressourcen der Writer-Instance nutzt, empfehlen wir dringend, Exporte für einen geklonten Cluster auszuführen, um die Produktionsworkloads nicht zu beeinträchtigen. Weitere Informationen finden Sie unter Empfehlungen.

Durchsatz exportieren

Der Exportdurchsatz skaliert ungefähr linear mit der Instanzgröße von bis zur7i.16xlarge. Als konservative Planungsschätzung gehen Sie von etwa 50.000 Anweisungen pro Sekunde und vCPU aus.

Verwenden Sie diese Formel, um die Exportdauer abzuschätzen:

export_seconds = total_statements / (vCPUs × 50,000)

Der tatsächliche Durchsatz hängt von den Datensatzmerkmalen ab, einschließlich der Kardinalität der Prädikate, der Komplexität der Anweisungen und der Clustergröße.

Voraussetzungen

Bevor Sie die Export-API verwenden, müssen Sie:

Empfehlungen

Wir empfehlen dringend, den Exportvorgang auf einem geklonten Cluster ohne read/write Workloads auszuführen, um Auswirkungen auf die Produktionsleistung zu vermeiden.

Für ein optimales Preis-Leistungs-Verhältnis empfehlen wir, 16xlarge Instances für Exportvorgänge zu verwenden. Dieser Instanztyp bietet:

IAM-Berechtigungen

Die Exportfunktion umfasst zwei separate IAM-Rollen:

Anruferberechtigungen (Neptune-Datenzugriffsaktionen)

Die IAM-Richtlinie des IAM-Prinzipals, der die Export-API aufruft, muss die folgenden Neptune-Datenzugriffsaktionen enthalten:

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

Weitere Informationen finden Sie unter Verwenden von IAM-Richtlinienanweisungen für den Datenzugriff.

Berechtigungen für S3-Zugriffsrollen

Die im iamRoleArn Anforderungsparameter übergebene IAM-Rolle muss Ihrem Neptune-Cluster zugeordnet sein und Neptune die Berechtigung gewähren, in den Ziel-S3-Bucket zu schreiben. Schritte zum Erstellen einer IAM-Rolle und zum Zuordnen dieser Rolle zu Ihrem Cluster finden Sie unter Erstellen Sie eine IAM-Rolle, um Neptune den Zugriff auf Amazon S3 zu ermöglichen.

Hängen Sie die folgende Berechtigungsrichtlinie an die S3-Zugriffsrolle an:

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

Optionale KMS-Berechtigungen

Wenn Sie kmsKeyIdentifier in der Exportanforderung eine angeben, fügen Sie der S3-Zugriffsrolle die folgenden Berechtigungen hinzu:

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

Endpunkt exportieren

Um Daten zu exportieren, senden Sie HTTP-Anfragen an den https://your-neptune-endpoint:port/export Endpunkt.

Syntax der Exportanfrage

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

Anfordern von Headern

Anforderungstext

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

Anforderungsparameter

Antwortsyntax

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

Endpunkt für den Exportstatus

Um den Status einer Exportaufgabe zu überprüfen, senden Sie eine HTTP GET-Anfrage mit der Export-ID an den Export-Endpunkt.

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

Anforderungsparameter

Antwortsyntax

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

Endpunkt der Exporte auflisten

Um alle Exportaufgaben aufzulisten, senden Sie eine HTTP GET-Anfrage an den Export-Endpunkt.

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

Antwortsyntax

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

Export-Endpunkt abbrechen

Um eine Exportaufgabe abzubrechen, senden Sie eine HTTP DELETE-Anfrage mit der Export-ID an den Export-Endpunkt.

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

Anforderungsparameter

Antwortsyntax

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

Ausgabeformat exportieren

S3-Verzeichnisstruktur

Exportierte Daten sind in Ihrem S3-Bucket wie folgt organisiert:

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

Fehlermeldungen

Allgemeine Fehlercodes

Beispiel für eine Fehlerantwort

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

Beispiele

Starte einen Export

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

Startet einen gefilterten Export (benannte Grafiken)

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

Überprüfen Sie den Exportstatus

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

Einen Export abbrechen

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

Einschränkungen

Für den systemeigenen Export gelten die folgenden Einschränkungen: