

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
<a name="export-utility"></a>

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`
<a name="export-utility-setup"></a>

**Antes de comenzar**
+ **Disponer de la versión 8 del JDK**: necesita tener instalada la versión 8 del [Java SE Development Kit (](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html)JDK).
+ **Descargue la utilidad neptune-export**[: descargue e instale el archivo neptune-export.jar](https://s3.amazonaws.com/aws-neptune-customer-samples/neptune-export/bin/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 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 de IAM](security-iam-access-manage.md).

  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](iam-auth-connecting-gremlin-java.md) para obtener una lista de identificadores de región).

## Ejecución de la utilidad `neptune-export` para iniciar una operación de exportación
<a name="export-utility-running"></a>

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`
<a name="export-utility-examples"></a>

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