Beispiel: Laden von Daten in eine Neptune-DB-Instance

Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon VPC-Konsole unter https://console.aws.amazon.com/vpc/.

Wählen Sie im linken Navigationsbereich die Option Endpoints (Endpunkte) aus.

Klicken Sie auf Endpunkt erstellen.

Wählen Sie unter Service Name (Service-Name) com.amazonaws.region.s3 aus.

Wählen Sie die VPC aus, die Ihre Neptune-DB-Instance enthält.

Aktivieren Sie das Kontrollkästchen neben den Routing-Tabellen, die den Subnetzen Ihres Clusters zugeordnet sind. Wenn Sie nur eine Routing-Tabelle vorliegen haben, müssen Sie das entsprechende Kontrollkästchen aktivieren.

Klicken Sie auf Endpunkt erstellen.

Kopieren Sie die Datendateien in einen Amazon-S3-Bucket. Der S3-Bucket muss sich in derselben AWS Region befinden wie der Cluster, der die Daten lädt.

Sie können den folgenden AWS CLI Befehl verwenden, um die Dateien in den Bucket zu kopieren.

aws s3 cp data-file-name s3://bucket-name/object-key-name

Alternativ können Sie den verwenden, AWS Management Console um Dateien in den S3-Bucket hochzuladen. Öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/und wählen Sie einen Bucket aus. Wählen Sie oben links Hochladen aus, um Dateien hochzuladen.

Geben Sie in einem Befehlszeilenfenster Folgendes ein, um den Neptune-Loader auszuführen. Verwenden Sie dabei die korrekten Werte für den Endpunkt, den Amazon-S3-Pfad, das Format und den IAM-Rollen-ARN.

Der Parameter format kann einen der folgenden Werte haben: csv für Gremlin, opencypher für openCypher oder ntriples, nquads, turtle und rdfxml für RDF. Informationen zu den anderen Parametern finden Sie unter Neptune-Loader-Befehl.

Informationen zum Ermitteln des Hostnamens Ihrer Neptune-DB-Instance finden Sie im Abschnitt Verbinden mit Amazo-Neptune-Endpunkten.

Der Parameter für die Region muss mit der Region des Clusters und des S3-Buckets übereinstimmen.

Amazon Neptune ist in den folgenden AWS Regionen verfügbar:

curl -X POST \
    -H 'Content-Type: application/json' \
    https://your-neptune-endpoint:port/loader -d '
    {
      "source" : "s3://bucket-name/object-key-name",
      "format" : "format",
      "iamRoleArn" : "arn:aws:iam::account-id:role/role-name",
      "region" : "region",
      "failOnError" : "FALSE",
      "parallelism" : "MEDIUM",
      "updateSingleCardinalityProperties" : "FALSE",
      "queueRequest" : "TRUE",
      "dependencies" : ["load_A_id", "load_B_id"]
    }'

Informationen zum Erstellen und Zuordnen einer IAM-Rolle zu einem Neptune-Cluster finden Sie unter Voraussetzungen: IAM-Rolle und Amazon-S3-Zugriff.

Der Neptune-Loader gibt eine Auftrags-id zurück, mit der Sie den Status prüfen oder den Ladevorgang abbrechen können, z. B.:

{
    "status" : "200 OK",
    "payload" : {
        "loadId" : "ef478d76-d9da-4d94-8ff1-08d9d4863aa5"
    }
}

Geben Sie Folgendes ein, um den Status des Ladevorgangs mit der loadId aus Schritt 3 abzurufen:

curl -G 'https://your-neptune-endpoint:port/loader/ef478d76-d9da-4d94-8ff1-08d9d4863aa5'

Wenn der Status des Ladevorgangs einen Fehler angibt, können Sie mehr Details zum Status und eine Liste der Fehler anfordern. Weitere Informationen und Beispiele finden Sie unter Neptune Loader-API Get-Status .

(Optional) Brechen Sie den Load-Auftrag ab.

Geben Sie Folgendes ein, um den Befehl Delete für den Loader-Auftrag mit der Auftrags-id aus Schritt 3 auszuführen:

curl -X DELETE 'https://your-neptune-endpoint:port/loader/ef478d76-d9da-4d94-8ff1-08d9d4863aa5'

Der DELETE-Befehl gibt den HTTP-Code 200 OK nach erfolgtem Abbruch zurück.

Die Daten aus Dateien des Ladeauftrags, der beendet wurde, werden nicht zurückgesetzt. Die Daten bleiben in der Neptune-DB-Instance.