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à.
# Configurazione della console Gremlin per la connessione a un'istanza database Neptune
La console Gremlin consente di sperimentare TinkerPop grafici e interrogazioni in un ambiente REPL (loop). read-eval-print
## Installazione della console Gremlin e connessione ad essa nel modo consueto
Con la console Gremlin puoi connetterti a un database a grafo remoto. La sezione seguente illustra l'installazione e la configurazione della console Gremlin per connettersi in remoto a un'istanza database Neptune. Segui queste istruzioni da un'istanza Amazon EC2 nello stesso cloud privato virtuale (VPC) dell'istanza database Neptune.
Per informazioni sulla connessione a Neptune SSL/TLS con (operazione obbligatoria), consulta. [Configurazione SSL/TLS](access-graph-gremlin-java.md#access-graph-gremlin-java-ssl)
**Nota**
Se nel cluster database Neptune è [abilitata l'autenticazione IAM](iam-auth-enable.md), per installare la console Gremlin seguire le istruzioni riportate in [Connessione ai database Amazon Neptune utilizzando l'autenticazione IAM con la console Gremlin](iam-auth-connecting-gremlin-console.md) anziché le istruzioni riportate qui.
**Per installare la console Gremlin e connettersi a Neptune**
1. I binari della console Gremlin richiedono Java 8 o Java 11. Queste istruzioni presuppongono l'uso di Java 11. Puoi installare Java 11 sulla tua istanza EC2 nel modo seguente:
+ Se utilizzi [Amazon Linux 2 (AL2)](https://aws.amazon.com/amazon-linux-2):
```
sudo amazon-linux-extras install java-openjdk11
```
+ Se utilizzi [Amazon Linux 2023 (AL2023)](https://docs.aws.amazon.com/linux/al2023/ug/what-is-amazon-linux.html):
```
sudo yum install java-11-amazon-corretto-devel
```
+ Per altre distribuzioni, usa l'opzione appropriata tra le seguenti:
```
sudo yum install java-11-openjdk-devel
```
oppure:
```
sudo apt-get install openjdk-11-jdk
```
1. Per impostare Java 11 come runtime predefinito sull'istanza EC2, digita quanto segue.
```
sudo /usr/sbin/alternatives --config java
```
Quando richiesto, immetti il numero per Java 11.
1. Scarica la versione appropriata della console Gremlin dal sito Web di Apache. Puoi controllare [Accesso al grafo Neptune con Gremlin](access-graph-gremlin.md) per determinare quale versione di Gremlin è supportata dalla tua versione di Neptune. Ad esempio, se hai bisogno della versione 3.7.2, puoi scaricare la [console Gremlin](https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip) dal sito web di [Apache](https://tinkerpop.apache.org/download.html) Tinkerpop sulla tua istanza EC2 in questo modo:
```
wget https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip
```
1. Decomprimi il file zip della console Gremlin.
```
unzip apache-tinkerpop-gremlin-console-3.7.2-bin.zip
```
1. Cambiare directory nella directory decompressa.
```
cd apache-tinkerpop-gremlin-console-3.7.2
```
1. Nella sottodirectory `conf` della directory estratta, creare un file denominato `neptune-remote.yaml` con il testo seguente. Sostituisci *your-neptune-endpoint* con il nome host o l'indirizzo IP dell'istanza DB di Neptune. Le parentesi quadre (`[ ]`) sono obbligatorie.
**Nota**
Per informazioni su come trovare il nome host dell'istanza database Neptune, consulta la sezione [Connessione agli endpoint Amazon Neptune](feature-overview-endpoints.md).
```
hosts: [your-neptune-endpoint]
port: 8182
connectionPool: { enableSsl: true }
serializer: { className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1,
config: { serializeResultToString: true }}
```
**Nota**
I serializzatori sono stati spostati dal `gremlin-driver` modulo al nuovo `gremlin-util` modulo nella versione 3.7.0. Il pacchetto è cambiato da org.apache.tinkerpop.gremlin.driver.ser a org.apache.tinkerpop.gremlin.util.ser.
1. In un terminale, vai alla directory della console Gremlin (`apache-tinkerpop-gremlin-console-3.7.2`) e immetti il comando seguente per eseguire la console Gremlin.
```
bin/gremlin.sh
```
Verrà visualizzato l’output seguente:
```
\,,,/
(o o)
-----oOOo-(3)-oOOo-----
plugin activated: tinkerpop.server
plugin activated: tinkerpop.utilities
plugin activated: tinkerpop.tinkergraph
gremlin>
```
Ora ti trovi al prompt `gremlin>`. Immetti i restanti passaggi in questo prompt.
1. Al prompt `gremlin>`, immetti quanto segue per connetterti all'istanza database Neptune.
```
:remote connect tinkerpop.server conf/neptune-remote.yaml
```
1. Al prompt `gremlin>`, immetti quanto segue per passare alla modalità remota. In questo modo tutte le query Gremlin vengono inviate alla connessione remota.
```
:remote console
```
1. Immetti quanto segue per inviare una query al grafo Gremlin.
```
g.V().limit(1)
```
1. Al termine, immetti quanto segue per uscire dalla console di Gremlin.
```
:exit
```
**Nota**
Utilizzare un punto e virgola (`;`) o un carattere nuova riga (`\n`) per separare ogni istruzione.
Ogni attraversamento che precede l'attraversamento finale deve terminare in `next()` per essere eseguito. Vengono restituiti solo i dati dell'ultimo attraversamento.
Per ulteriori informazioni sull'implementazione di Gremlin in Neptune, consulta [Conformità agli standard Gremlin in Amazon Neptune](access-graph-gremlin-differences.md).
## Autenticazione IAM
Neptune [supporta l'autenticazione IAM](iam-auth-enable.md) per controllare l'accesso al cluster DB. Se hai abilitato l'autenticazione IAM, devi utilizzare la firma Signature Version 4 per autenticare le tue richieste. Per istruzioni dettagliate ed esempi di codice per la connessione dalla console Gremlin, consulta. [Connessione ai database Amazon Neptune utilizzando l'autenticazione IAM con la console Gremlin](iam-auth-connecting-gremlin-console.md)