As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar a ferramenta de linha de comando `neptune-export` para exportar dados do Neptune
<a name="export-utility"></a>

É possível usar as seguintes etapas para exportar dados do cluster de banco de dados do Neptune para o Amazon S3 usando o utilitário de linha de comando `neptune-export`:

## Pré-requisitos para usar o utilitário de linha de comando `neptune-export`
<a name="export-utility-setup"></a>

**Antes de começar**
+ **Tenha a versão 8 do JDK**: você precisa instalar a versão 8 do [Java SE Development Kit (JDK](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html)).
+ **Baixe o utilitário neptune-export**: baixe e instale o arquivo [neptune-export.jar](https://s3.amazonaws.com/aws-neptune-customer-samples/neptune-export/bin/neptune-export.jar).
+ **Garanta que o `neptune-export` tenha acesso à VPC do Neptune**: execute o neptune-export de um local onde ele possa acessar a VPC em que o cluster de banco de dados do Neptune está localizado.

  Por exemplo, é possível executá-lo em uma instância do Amazon EC2 dentro da VPC do Neptune, ou em uma VPC separada que seja emparelhada com a VPC do Neptune, ou em um bastion host separado.
+ **Garanta que os grupos de segurança da VPC concedam acesso a `neptune-export`**: confira se os grupos de segurança da VPC anexados à VPC do Neptune permitem acesso ao cluster de banco de dados a partir do endereço IP ou do grupo de segurança associado ao ambiente `neptune-export`.
+ **Configure as permissões necessárias do IAM** — Se seu banco de dados tiver a autenticação de banco de dados AWS Identity and Access Management (IAM) ativada, certifique-se de que a função sob a qual é `neptune-export` executada esteja associada a uma política do IAM que permite conexões com o Neptune. Para obter informações sobre políticas do Neptune, consulte [Usar políticas do IAM](security-iam-access-manage.md).

  Se você quiser usar o parâmetro `clusterId` export nas solicitações de consulta, o perfil sob o qual o `neptune-export` é executado exige as seguintes permissões do IAM:
  + `rds:DescribeDBClusters`
  + `rds:DescribeDBInstances`
  + `rds:ListTagsForResource`

  Se você quiser exportar de um cluster clonado, o perfil sob o qual `neptune-export` é executado exige as seguintes permissões do 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 os dados exportados no Amazon S3, o perfil sob o qual o `neptune-export` é executado exige as seguintes permissões do IAM para os locais do Amazon S3:
  + `s3:PutObject`
  + `s3:PutObjectTagging`
  + `s3:GetObject`
+ **Defina a variável de ambiente `SERVICE_REGION`**: defina a variável de ambiente `SERVICE_REGION` para identificar a região onde o cluster de banco de dados está localizado (consulte [Connecting to Neptune](iam-auth-connecting-gremlin-java.md) para obter uma lista de identificadores de região).

## Executar o utilitário `neptune-export` para iniciar uma operação de exportação
<a name="export-utility-running"></a>

Use o seguinte comando para executar o neptune-export na linha de comando e iniciar uma operação de exportação:

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

O comando tem dois parâmetros:

**Parâmetros para neptune-export ao iniciar uma exportação**
+ **`--root-path`**: caminho para um diretório no qual os arquivos de exportação são gravados antes de serem publicados no Amazon S3.
+ **`--json`**: um objeto JSON que define a exportação.

## Exemplos de comando usando o utilitário de linha de comando `neptune-export`
<a name="export-utility-examples"></a>

Como exportar dados do grafo de propriedades diretamente do cluster de banco de dados de origem:

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

Como exportar dados do RDF diretamente do cluster de banco de dados de origem:

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

Se você omitir o parâmetro de solicitação `command`, por padrão, o utilitário `neptune-export` exportará dados do grafo de propriedades do Neptune.

Como exportar de um clone do cluster de banco de dados:

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

Como exportar do cluster de banco de dados usando a autenticação do 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
            }
          }'
```