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

QLDBDriver Amazon per Java

Per lavorare con i dati nel tuo registro, puoi connetterti ad Amazon QLDB dalla tua applicazione Java utilizzando un driver AWS fornito. I seguenti argomenti descrivono come iniziare a usare il QLDB driver per Java.

Risorse per i driver

Per ulteriori informazioni sulle funzionalità supportate dal driver Java, consultate le seguenti risorse:

Prerequisiti

Prima di iniziare a utilizzare il QLDB driver per Java, è necessario effettuare le seguenti operazioni:

Successivamente, puoi scaricare l'applicazione di esempio completa del tutorial oppure puoi installare solo il driver in un progetto Java ed eseguire brevi esempi di codice.

Impostazione delle AWS credenziali e della regione predefinite

Il QLDB driver e il sottostante AWS SDK for Javarichiedono che l'utente fornisca AWS le credenziali all'applicazione in fase di esecuzione. Gli esempi di codice in questa guida presuppongono che stiate utilizzando un file di AWS credenziali, come descritto in Impostare credenziali e regione predefinite nella Guida per gli AWS SDK for Java 2.x sviluppatori.

Come parte di questi passaggi, è inoltre necessario impostare il valore predefinito Regione AWS per determinare l'endpoint predefinitoQLDB. Gli esempi di codice a cui si collegano QLDB sono quelli predefiniti Regione AWS. Per un elenco completo delle regioni in cui QLDB è disponibile, consulta gli QLDBendpoint e le quote di Amazon nel. Riferimenti generali di AWS

Di seguito è riportato un esempio di file di AWS credenziali denominato~/.aws/credentials, in cui il carattere tilde (~) rappresenta la tua home directory.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Sostituite i valori delle vostre AWS credenziali con i valori your_access_key_id e your_secret_access_key.

Installazione

QLDBsupporta le seguenti versioni dei driver Java e le relative dipendenze. AWS SDK

Per installare il QLDB driver, si consiglia di utilizzare un sistema di gestione delle dipendenze, come Gradle o Maven. Ad esempio, aggiungi il seguente artefatto come dipendenza nel tuo progetto Java.

2.x

Gradle

Aggiungi questa dipendenza nel tuo build.gradle file di configurazione.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '2.3.1'
}

Maven

Aggiungi questa dipendenza nel tuo pom.xml file di configurazione.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>2.3.1</version>
  </dependency>
</dependencies>

Questo elemento include automaticamente il modulo AWS SDK for Java 2.x principale, le librerie Amazon Ion e altre dipendenze richieste.

1.x

Gradle

Aggiungi questa dipendenza nel tuo build.gradle file di configurazione.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '1.1.0'
}

Maven

Aggiungi questa dipendenza nel tuo pom.xml file di configurazione.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>

Questo elemento include automaticamente il modulo AWS SDK for Java principale, le librerie Amazon Ion e altre dipendenze richieste.

Importante

Spazio dei nomi Amazon Ion: quando importi classi Amazon Ion nella tua applicazione, devi utilizzare il pacchetto che si trova nello spazio dei nomi. com.amazon.ion AWS SDK for Java Dipende da un altro pacchetto Ion presente nello spazio dei nomisoftware.amazon.ion, ma si tratta di un pacchetto legacy non compatibile con il driver. QLDB

Per brevi esempi di codice su come eseguire transazioni di dati di base su un registro, consulta il. Riferimento al libro di cucina

Altre librerie opzionali

Facoltativamente, puoi anche aggiungere le seguenti utili librerie al tuo progetto. Questi artefatti sono dipendenze obbligatorie nell'applicazione di esempio. Tutorial su Java

Gradle

Aggiungi queste dipendenze nel tuo file build.gradle di configurazione.

dependencies {
    compile group: 'com.amazonaws', name: 'aws-java-sdk-qldb', version: '1.11.785'
    compile group: 'com.fasterxml.jackson.dataformat', name: 'jackson-dataformat-ion', version: '2.10.0'
}

Maven

Aggiungi queste dipendenze nel tuo pom.xml file di configurazione.

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-qldb</artifactId>
    <version>1.11.785</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-ion</artifactId>
    <version>2.10.0</version>
  </dependency>
</dependencies>