Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo dello strumento da riga di comando `neptune-export` per esportare i dati da Neptune
<a name="export-utility"></a>

Puoi utilizzare la procedura seguente per esportare dati dal tuo cluster database Neptune ad Amazon S3 con l'utilità da riga di comando `neptune-export`:

## Prerequisiti per l'utilizzo dell'utilità da riga di comando `neptune-export`
<a name="export-utility-setup"></a>

**Prima di iniziare**
+ **Versione 8 di JDK**: è necessario che sia installata la versione 8 di [Java SE Development Kit](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html) (JDK).
+ **Scarica l'utilità neptune-export**:[ scarica e installa il file neptune-export.jar](https://s3.amazonaws.com/aws-neptune-customer-samples/neptune-export/bin/neptune-export.jar).
+ **Assicurati che `neptune-export` abbia accesso al VPC Neptune**: esegui neptune-export da una posizione in cui possa accedere al VPC in cui si trova il cluster database Neptune.

  Ad esempio, puoi eseguirlo su un'istanza Amazon EC2 all'interno del VPC Neptune o in un VPC separato collegato al VPC Neptune o su un host bastione separato.
+ **Assicurati che i gruppi di sicurezza VPC concedano l'accesso a `neptune-export`**: verifica che i gruppi di sicurezza VPC collegati al VPC Neptune consentano l'accesso al tuo cluster database dall'indirizzo IP o dal gruppo di sicurezza associato all'ambiente `neptune-export`.
+ **Configura le autorizzazioni IAM necessarie**: se il tuo database ha l'autenticazione del database AWS Identity and Access Management (IAM) abilitata, assicurati che il ruolo in base al quale `neptune-export` viene eseguita sia associato a una policy IAM che consenta le connessioni a Neptune. Per informazioni generali sulle policy Neptune, consulta [Utilizzo delle policy IAM](security-iam-access-manage.md).

  Se desideri utilizzare il parametro di esportazione `clusterId` nelle richieste di query, il ruolo in cui viene eseguita l'utilità `neptune-export` richiede le seguenti autorizzazioni IAM:
  + `rds:DescribeDBClusters`
  + `rds:DescribeDBInstances`
  + `rds:ListTagsForResource`

  Se desideri esportare da un cluster clonato, il ruolo in cui viene eseguita l'utilità `neptune-export` richiede le seguenti autorizzazioni 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`

  Per pubblicare i dati esportati su Amazon S3, il ruolo in cui viene eseguita l'utilità `neptune-export` richiede le seguenti autorizzazioni IAM per le posizioni Amazon S3:
  + `s3:PutObject`
  + `s3:PutObjectTagging`
  + `s3:GetObject`
+ **Imposta la variabile di ambiente `SERVICE_REGION`**: imposta la variabile di ambiente `SERVICE_REGION` per identificare la regione in cui si trova il cluster database (consulta [Connessione a Neptune](iam-auth-connecting-gremlin-java.md) per l'elenco degli identificatori di regione).

## Esecuzione dell'utilità `neptune-export` per avviare un'operazione di esportazione
<a name="export-utility-running"></a>

Usa il seguente comando per eseguire neptune-export dalla riga di comando e avviare un'operazione di esportazione:

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

Il comando ha due parametri:

**Parametri per neptune-export all'avvio di un'esportazione**
+ **`--root-path`**: percorso di una directory locale in cui i file di esportazione vengono scritti prima di essere pubblicati su Amazon S3.
+ **`--json`**: oggetto JSON che definisce l'esportazione.

## Comandi di esempio per l'utilità da riga di comando `neptune-export`
<a name="export-utility-examples"></a>

Per esportare i dati del grafo delle proprietà direttamente dal cluster database di origine:

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

Per esportare i dati RDF direttamente dal cluster database di origine:

```
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 si omette il parametro della richiesta `command`, per impostazione predefinita l'utilità `neptune-export` esporta i dati del grafo delle proprietà da Neptune.

Per esportare i dati da un clone del cluster database:

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

Per esportare i dati dal cluster database utilizzando l'autenticazione 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
            }
          }'
```