Utilisation de l'outil de ligne de commande neptune-export pour exporter des données depuis Neptune

Vous pouvez suivre les étapes suivantes pour exporter les données du cluster de bases de données Neptune vers Amazon S3 à l'aide de l'utilitaire de ligne de commande neptune-export :

Conditions préalables à l'utilisation de l'utilitaire de ligne de commande neptune-export

Avant de commencer

• Disposer de la version 8 du kit JDK : la version 8 du kit de développement Java SE (JDK) doit être installée.

• Téléchargez l'utilitaire neptune-export : téléchargez et installez le fichier neptune-export.jar.

• Assurez-vous que neptune-export a accès à votre VPC Neptune : exécutez neptune-export depuis un emplacement permettant d'accéder au VPC où se trouve votre cluster de bases de données Neptune.

  Par exemple, vous pouvez l'exécuter sur une instance Amazon EC2 au sein du VPC Neptune, dans un VPC distinct associé au VPC Neptune ou sur un hôte bastion distinct.

• Assurez-vous que les groupes de sécurité VPC accordent l'accès à neptune-export : vérifiez que le ou les groupes de sécurité VPC attachés au VPC Neptune autorisent l'accès au cluster de bases de données à partir de l'adresse IP ou du groupe de sécurité associé à l'environnement neptune-export.

• Configurez les autorisations IAM nécessaires : si l'authentification de base de données AWS Identity and Access Management (IAM) est activée sur votre base de données, assurez-vous que le rôle sous lequel neptune-export s'exécute est associé à une politique IAM autorisant les connexions à Neptune. Pour en savoir plus sur les politiques Neptune, consultez Utilisation de politiques IAM.

  Si vous souhaitez utiliser le paramètre d'exportation clusterId dans vos demandes de requête, le rôle sous lequel neptune-export s'exécute nécessite les autorisations IAM suivantes :

  • rds:DescribeDBClusters

  • rds:DescribeDBInstances

  • rds:ListTagsForResource

  Si vous souhaitez effectuer une exportation à partir d'un cluster cloné, le rôle sous lequel neptune-export s'exécute nécessite les autorisations IAM suivantes :

  • 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

  Pour publier les données exportées sur Amazon S3, le rôle sous lequel neptune-export s'exécute nécessite les autorisations IAM suivantes pour le ou les sites Amazon S3 :

  • s3:PutObject

  • s3:PutObjectTagging

  • s3:GetObject

• Définissez la variable d'environnement SERVICE_REGION : définissez la variable d'environnement SERVICE_REGION pour identifier la région dans laquelle se trouve votre cluster de bases de données (voir Connexion à Neptune pour obtenir une liste des identifiants de région).

Exécution de l'utilitaire neptune-export pour lancer une opération d'exportation

Utilisez la commande suivante pour exécuter neptune-export depuis la ligne de commande et démarrer une opération d'exportation :

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

Cette commande utilise deux paramètres :

Paramètres de neptune-export lors du démarrage d'une exportation

• --root-path : chemin d'accès à un répertoire local dans lequel les fichiers d'exportation sont écrits avant d'être publiés sur Amazon S3.

• --json : objet JSON qui définit l'exportation.

Exemples de commandes impliquant l'utilitaire de ligne de commande neptune-export

Pour exporter les données du graphe de propriétés directement depuis votre cluster de bases de données source :

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

Pour exporter des données RDF directement depuis votre cluster de bases de données source :

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

Si vous omettez le paramètre de demande command, l'utilitaire neptune-export exporte les données du graphe de propriétés depuis Neptune par défaut.

Pour effectuer une exportation depuis un clone de votre cluster de bases de données :

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

Pour effectuer une exportation depuis votre cluster de bases de données à l'aide de l'authentification IAM :

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