Exportieren von Daten aus Neptune mithilfe des neptune-export-Befehlszeilen-Tools

Anhand der folgenden Schritte können Sie mit dem neptune-export-Befehlszeilen-Dienstprogramm Daten aus Ihrem Neptune-DB-Cluster zu Amazon S3 exportieren:

Voraussetzungen für die Verwendung des neptune-export-Befehlszeilen-Dienstprogramms

Bevor Sie beginnen

• Version 8 des JDK – Sie müssen Version 8 des Java SE Development Kit (JDK) installiert haben.

• Download des Neptune-Export-Hilfsprogramm – Laden und installieren Sie die Datei neptune-export.jar.

• Sicherstellen, dass neptune-export Zugriff auf Ihre Neptune-VPC hat – Führen Sie neptune-export von einem Ort aus, an dem es auf die VPC zugreifen kann, in der sich Ihr Neptune-DB-Cluster befindet.

  Sie können es beispielsweise auf einer Amazon-EC2-Instance innerhalb der Neptune-VPC oder in einer separaten VPC, die mit der Neptune-VPC gepaart ist, oder auf einem separaten Bastion-Host ausführen.

• Sicherstellen, dass die VPC-Sicherheitsgruppen Zugriff auf neptune-export gewähren – Vergewissern Sie sich, dass die mit der Neptune-VPC verbundenen VPC-Sicherheitsgruppen den Zugriff auf Ihren DB-Cluster von der IP-Adresse oder Sicherheitsgruppe aus ermöglichen, die der neptune-export-Umgebung zugeordnet ist.

• Einrichten der erforderlichen IAM-Berechtigungen – Wenn in Ihrer Datenbank die AWS Identity and Access Management (IAM)-Datenbankauthentifizierung aktiviert ist, stellen Sie sicher, dass die Rolle, unter der neptune-export ausgeführt wird, mit einer IAM-Richtlinie verknüpft ist, die Verbindungen zu Neptune zulässt. Informationen zu Neptune-Richtlinien finden Sie unter Verwenden von IAM-Richtlinien.

  Wenn Sie den clusterId-Exportparameter in Ihren Abfrageanfragen verwenden möchten, erfordert die Rolle, unter der neptune-export ausgeführt wird, die folgenden IAM-Berechtigungen:

  • rds:DescribeDBClusters

  • rds:DescribeDBInstances

  • rds:ListTagsForResource

  Wenn Sie aus einem geklonten Cluster exportieren möchten, erfordert die Rolle, unter der neptune-export ausgeführt wird, die folgenden IAM-Berechtigungen:

  • rds:AddTagsToResource

  • rds:DescribeDBClusters

  • rds:DescribeDBInstances

  • rds:ListTagsForResource

  • rds:DescribeDBClusterParameters

  • rds:DescribeDBParameters

  • rds:ModifyDBParameterGroup

  • rds:ModifyDBClusterParameterGroup

  • rds:RestoreDBClusterToPointInTime

  • rds:DeleteDBInstance

  • rds:DeleteDBClusterParameterGroup

  • rds:DeleteDBParameterGroup

  • rds:DeleteDBCluster

  • rds:CreateDBInstance

  • rds:CreateDBClusterParameterGroup

  • rds:CreateDBParameterGroup

  Um die exportierten Daten in Amazon S3 zu veröffentlichen, erfordert die Rolle, unter der neptune-export ausgeführt wird, die folgenden IAM-Berechtigungen für den/die Amazon-S3-Standort(e):

  • s3:PutObject

  • s3:PutObjectTagging

  • s3:GetObject

• Einrichten der Umgebungsvariable SERVICE_REGION – Legen Sie die Umgebungsvariable SERVICE_REGION fest, um die Region zu identifizieren, in der sich Ihr DB-Cluster befindet (eine Liste der Regionskennungen finden Sie unter Herstellen einer Verbindung zu Neptune).

Ausführen des neptune-export-Hilfsprogramms, um einen Exportvorgang zu starten

Verwenden Sie den folgenden Befehl, um neptune-export von der Befehlszeile aus auszuführen und einen Exportvorgang zu starten:

java -jar neptune-export.jar nesvc \
  --root-path (path to a local directory) \
  --json (the JSON file that defines the export)

Der Befehl hat zwei Parameter:

Parameter für neptune-export beim Starten eines Exports

• --root-path – Pfad zu einem lokalen Verzeichnis, in das Exportdateien geschrieben werden, bevor sie in Amazon S3 veröffentlicht werden.

• --json – Ein JSON-Objekt, das den Export definiert.

Beispielbefehle mit dem neptune-export-Befehlszeilen-Dienstprogramm

So exportieren Sie Eigenschaftsgraph-Daten direkt aus Ihrem Quell-DB-Cluster:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-pg",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)"
            }
          }'

So exportieren Sie RDF-Daten direkt aus Ihrem Quell-DB-Cluster:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-rdf",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)"
            }
          }'

Wenn Sie den command-Anforderungsparameter weglassen, exportiert das neptune-export-Hilfsprogramm standardmäßig Eigenschaftsgraph-Daten aus Neptune.

So exportieren Sie aus einem Klon Ihres DB-Clusters:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-pg",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)",
              "cloneCluster" : true
            }
          }'

So exportieren Sie mithilfe der IAM-Authentifizierung aus Ihrem DB-Cluster:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-pg",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)"
              "useIamAuth" : true
            }
          }'