

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à.

# Guida introduttiva al driver JDBC Neptune
<a name="neptune-jdbc-getting-started"></a>

Per utilizzare il driver JDBC Neptune per connettersi a un'istanza Neptune, il driver JDBC deve essere implementato in un'istanza Amazon EC2 nello stesso VPC del cluster database Neptune oppure l'istanza deve essere disponibile tramite un tunnel SSH o un sistema di bilanciamento del carico. Un tunnel SSH può essere configurato internamente nel driver o può essere configurato esternamente.

È possibile scaricare il driver [qui](https://github.com/aws/amazon-neptune-jdbc-driver/releases). Il driver viene fornito in un pacchetto come singolo file JAR con un nome simile a `neptune-jdbc-1.0.0-all.jar`. Per utilizzarlo, posizionare il file JAR nel `classpath` dell'applicazione. Oppure, se l'applicazione utilizza Maven o Gradle, è possibile utilizzare i comandi Maven o Gradle appropriati per installare il driver dal file JAR.

Il driver necessita di un URL di connessione JDBC per connettersi a Neptune, in un formato simile al seguente:

```
jdbc:neptune:(connection type)://(host);property=value;property=value;...;property=value
```

Le sezioni relative a ciascun linguaggio di query del GitHub progetto descrivono le proprietà che è possibile impostare nell'URL di connessione JDBC per quel linguaggio di query.

Se il file JAR è presente nel `classpath` dell'applicazione, non sono necessarie altre configurazioni. È possibile connettere il driver utilizzando l'interfaccia JDBC `DriverManager` e una stringa di connessione Neptune. Ad esempio, se il cluster database Neptune è accessibile tramite l'endpoint `neptune-example.com` sulla porta 8182, è possibile connettersi con openCypher in questo modo:

```
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;

void example() {
    String url = "jdbc:neptune:opencypher://bolt://neptune-example:8182";

    Connection connection = DriverManager.getConnection(url);
    Statement statement = connection.createStatement();

    connection.close();
}
```

Le sezioni della documentazione del GitHub progetto per ogni linguaggio di query descrivono come costruire la stringa di connessione quando si utilizza quel linguaggio di query.