Utilisation deneptune-exportoutil en ligne de commande pour exporter des données depuis Neptune - Amazon Neptune

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation deneptune-exportoutil en ligne de commande pour exporter des données depuis Neptune

Vous pouvez suivre les étapes suivantes pour exporter des données depuis votre cluster de bases de données Neptune vers Amazon S3 à l'aide duneptune-exportutilitaire de ligne de commande :

Conditions préalables pour l'utilisation du.neptune-exportutilitaire de ligne de commande

Avant de commencer

  • Disposez de la version 8 du JDK— Vous avez besoin de la version 8 duKit de développement Java SE (JDK)installé.

  • Téléchargez l'utilitaire neptune-export— Télécharger et installerneptune-export.jarfichier.

  • Assurez-vousneptune-exporta accès à votre Neptune VPC— Exécutez neptune-export à partir d'un emplacement où il peut accéder au VPC où se trouve votre cluster de base de données Neptune.

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

  • Assurez-vous que les groupes de sécurité du VPC accordent l'accès àneptune-export— Vérifiez que le ou les groupes de sécurité du VPC attachés au Neptune VPC autorisent l'accès à votre cluster de base de données à partir de l'adresse IP ou du groupe de sécurité associé auneptune-exportenvironnement.

  • Configurez les autorisations IAM nécessaires— Si votre base de données contientAWS Identity and Access Management(IAM) authentification de base de données activée, assurez-vous que le rôle sous lequelneptune-exportruns est associé à une politique IAM qui autorise les connexions à Neptune. Pour plus d'informations sur les stratégies Neptune, consultezUtilisation de politiques IAM.

    Si vous voulez utiliserclusterIdparamètre d'exportation dans vos demandes de requête, le rôle sous lequelneptune-exportexécute requiert les autorisations IAM suivantes :

    • rds:DescribeDBClusters

    • rds:DescribeDBInstances

    • rds:ListTagsForResource

    Si vous souhaitez exporter à partir d'un cluster cloné, le rôle sous lequelneptune-exportexécute requiert 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 vers Amazon S3, le rôle dans lequelneptune-exportles exécutions nécessitent les autorisations IAM suivantes pour le ou les emplacements Amazon S3 :

    • s3:PutObject

    • s3:PutObjectTagging

    • s3:GetObject

  • Définir la propriétéSERVICE_REGIONvariable d'environnement— Définissez la propriétéSERVICE_REGIONvariable d'environnement pour identifier la région dans laquelle se trouve votre cluster de bases de données (voirConnexion à Neptunepour une liste des identifiants de région).

Exécution deneptune-exportutilitaire 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)

La commande comporte deux paramètres :

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

  • --root-path— Chemin vers un répertoire local dans lequel les fichiers d'exportation sont écrits avant d'être publiés sur Amazon S3.

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

Exemples de commandes utilisantneptune-exportutilitaire de ligne de commande

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 base 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 lecommandparamètre de requête, leneptune-exportL'utilitaire exporte les données du graphe de propriétés depuis Neptune par défaut.

Pour exporter depuis un clone de votre cluster de base 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 exporter depuis votre cluster de base de données en utilisant 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 } }'