Uso de la herramienta de línea de comandos neptune-export para exportar datos de Neptune - Amazon Neptune

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de la herramienta de línea de comandos neptune-export para exportar datos de Neptune

Puede seguir estos pasos para exportar datos de su clúster de base de datos de Neptune a Amazon S3 mediante la utilidad de línea de comandos neptune-export:

Requisitos previos para usar la utilidad de línea de comandos neptune-export

Antes de comenzar
  • Disponer de la versión 8 del JDK: necesita tener instalada la versión 8 del Java SE Development Kit (JDK).

  • Descargue la utilidad neptune-export: descargue e instale el archivo neptune-export.jar.

  • Asegúrese de que neptune-export tiene acceso a su VPC de Neptune: ejecute neptune-export desde una ubicación en la que pueda acceder a la VPC en la que se encuentra su clúster de base de datos de Neptune.

    Por ejemplo, puede ejecutarlo en una instancia de Amazon EC2 dentro de la VPC de Neptune, en una VPC independiente que esté interconectada con la VPC de Neptune, o en un host bastión independiente.

  • Asegúrese de que los grupos de seguridad de VPC concedan acceso a neptune-export: compruebe que los grupos de seguridad de VPC conectados a la VPC de Neptune permiten el acceso a su clúster de base de datos desde la dirección IP o el grupo de seguridad asociado al entorno neptune-export.

  • Configure los permisos de IAM necesarios: si su base de datos tiene habilitada la autenticación de bases de datos de AWS Identity and Access Management (IAM), asegúrese de que la función con la que neptune-export se ejecuta esté asociada a una política de IAM que permita las conexiones a Neptune. Para obtener información sobre las políticas de Neptune, consulte Uso de políticas IAM.

    Si desea utilizar el parámetro de exportación clusterId en sus solicitudes de consulta, el rol en el que neptune-export se ejecuta requiere los siguientes permisos de IAM:

    • rds:DescribeDBClusters

    • rds:DescribeDBInstances

    • rds:ListTagsForResource

    Si quiere exportar desde un clúster clonado, el rol en el que neptune-export se ejecuta requiere los siguientes permisos de IAM:

    • 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

    Para publicar los datos exportados en Amazon S3, el rol en el que neptune-export se ejecuta requiere los siguientes permisos de IAM para las ubicaciones de Amazon S3:

    • s3:PutObject

    • s3:PutObjectTagging

    • s3:GetObject

  • Defina la variable de entorno SERVICE_REGION: defina la variable de entorno SERVICE_REGION para identificar la región en la que se encuentra el clúster de base de datos (consulte Connecting to Neptune para obtener una lista de identificadores de región).

Ejecución de la utilidad neptune-export para iniciar una operación de exportación

Utilice el siguiente comando para ejecutar neptune-export desde la línea de comandos e iniciar una operación de exportación:

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

El comando tiene dos parámetros:

Parámetros para neptune-export al iniciar una exportación
  • --root-path: ruta a un directorio local donde se escriben los archivos de exportación antes de publicarlos en Amazon S3.

  • --json: un objeto JSON que define la exportación.

Ejemplos de comandos que utilizan la utilidad de línea de comandos neptune-export

Para exportar los datos del gráfico de propiedades directamente desde el clúster de base de datos de origen:

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

Para exportar los datos de RDF directamente desde el clúster de base de datos de origen:

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 omite el parámetro de la solicitud command, la utilidad neptune-export exporta de forma predeterminada los datos del gráfico de propiedades de Neptune.

Para exportar desde un clon de su clúster de base de datos:

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

Para exportar desde su clúster de base de datos mediante la autenticación de 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 } }'