Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memulai dengan driver JDBC 3.x
<a name="jdbc-v3-driver-getting-started"></a>

Gunakan informasi di bagian ini untuk memulai dengan driver Amazon Athena JDBC 3.x.

**Topics**
+ [Petunjuk Instalasi](#jdbc-v3-driver-installation-instructions)
+ [Menjalankan pengemudi](#jdbc-v3-driver-running-the-driver)
+ [Mengkonfigurasi driver](#jdbc-v3-driver-configuring-the-driver)
+ [Memutakhirkan dari driver Athena JDBC v2](#jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3)

## Petunjuk Instalasi
<a name="jdbc-v3-driver-installation-instructions"></a>

Anda dapat menggunakan driver JDBC 3.x dalam aplikasi khusus atau dari klien SQL pihak ketiga.

### Dalam aplikasi khusus
<a name="jdbc-v3-driver-installation-in-a-custom-application"></a>

Unduh `.zip` file yang berisi jar driver dan dependensinya. Setiap dependensi memiliki `.jar` file sendiri. Tambahkan jar driver sebagai dependensi dalam aplikasi kustom Anda. Secara selektif tambahkan dependensi jar driver berdasarkan apakah Anda telah menambahkan dependensi tersebut ke aplikasi Anda dari sumber lain.

### Di klien SQL pihak ketiga
<a name="jdbc-v3-driver-installation-in-a-third-party-sql-client"></a>

Unduh file jar uber driver dan tambahkan ke klien SQL pihak ketiga mengikuti instruksi untuk klien itu.

## Menjalankan pengemudi
<a name="jdbc-v3-driver-running-the-driver"></a>

Untuk menjalankan driver, Anda dapat menggunakan aplikasi khusus atau klien SQL pihak ketiga.

### Dalam aplikasi khusus
<a name="jdbc-v3-driver-running-in-a-custom-application"></a>

Gunakan antarmuka JDBC untuk berinteraksi dengan driver JDBC dari suatu program. Kode berikut menunjukkan contoh aplikasi Java kustom.

```
public static void main(String args[]) throws SQLException {
    Properties connectionParameters = new Properties();
    connectionParameters.setProperty("Workgroup", "primary");
    connectionParameters.setProperty("Region", "us-east-2");
    connectionParameters.setProperty("Catalog", "AwsDataCatalog");
    connectionParameters.setProperty("Database","sampledatabase");
    connectionParameters.setProperty("OutputLocation","s3://amzn-s3-demo-bucket");
    connectionParameters.setProperty("CredentialsProvider","DefaultChain");
    String url = "jdbc:athena://";
    AthenaDriver driver = new AthenaDriver();
    Connection connection = driver.connect(url, connectionParameters);
    Statement statement = connection.createStatement();
    String query = "SELECT * from sample_table LIMIT 10";
    ResultSet resultSet = statement.executeQuery(query);
    printResults(resultSet); // A custom-defined method for iterating over a
                             // result set and printing its contents
}
```

### Di klien SQL pihak ketiga
<a name="jdbc-v3-driver-running-in-a-third-party-sql-client"></a>

Ikuti dokumentasi untuk klien SQL yang Anda gunakan. Biasanya, Anda menggunakan antarmuka pengguna grafis klien SQL untuk memasukkan dan mengirimkan kueri, dan hasil kueri ditampilkan dalam antarmuka yang sama.

## Mengkonfigurasi driver
<a name="jdbc-v3-driver-configuring-the-driver"></a>

Anda dapat menggunakan parameter koneksi untuk mengonfigurasi driver Amazon Athena JDBC. Untuk parameter koneksi yang didukung, lihat[Parameter koneksi Amazon Athena JDBC 3.x](jdbc-v3-driver-connection-parameters.md).

### Dalam aplikasi khusus
<a name="jdbc-v3-driver-configuring-in-a-custom-application"></a>

Untuk mengatur parameter koneksi untuk driver JDBC dalam aplikasi khusus, lakukan salah satu hal berikut:
+ Tambahkan nama parameter dan nilainya ke `Properties` objek. Saat Anda menelepon`Connection#connect`, berikan objek itu bersama dengan URL. Sebagai contoh, lihat contoh aplikasi Java di[Menjalankan pengemudi](#jdbc-v3-driver-running-the-driver).
+ Dalam string koneksi (URL), gunakan format berikut untuk menambahkan nama parameter dan nilainya langsung setelah awalan protokol.

  ```
  <parameterName>=<parameterValue>;
  ```

  Gunakan titik koma di akhir setiap pasangan name/parameter nilai parameter, dan tidak meninggalkan spasi putih setelah titik koma, seperti pada contoh berikut.

  ```
  String url = "jdbc:athena://WorkGroup=primary;Region=us-east-1;...;";AthenaDriver driver = new AthenaDriver();Connection connection = driver.connect(url, null);
  ```
**catatan**  
Jika parameter ditentukan baik dalam string koneksi dan `Properties` objek, nilai dalam string koneksi diutamakan. Menentukan parameter yang sama di kedua tempat tidak disarankan.
+ Tambahkan nilai parameter sebagai argumen untuk metode`AthenaDataSource`, seperti dalam contoh berikut.

  ```
  AthenaDataSource dataSource = new AthenaDataSource();
      dataSource.setWorkGroup("primary");
      dataSource.setRegion("us-east-2");
      ...
      Connection connection = dataSource.getConnection();
      ...
  ```

### Di klien SQL pihak ketiga
<a name="jdbc-v3-driver-configuring-in-a-third-party-sql-client"></a>

Ikuti instruksi dari klien SQL yang Anda gunakan. Biasanya, klien menyediakan antarmuka pengguna grafis untuk memasukkan nama parameter dan nilainya.

## Memutakhirkan dari driver Athena JDBC v2
<a name="jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3"></a>

Sebagian besar parameter koneksi JDBC versi 3 kompatibel dengan driver JDBC versi 2 (Simba). Ini berarti bahwa string koneksi versi 2 dapat digunakan kembali dengan versi 3 driver. Namun, beberapa parameter koneksi telah berubah. Perubahan ini dijelaskan di sini. Saat Anda meningkatkan ke driver JDBC versi 3, perbarui konfigurasi yang ada jika perlu.

### Kelas pengemudi
<a name="jdbc-v3-driver-upgrading-driver-class"></a>

Beberapa alat BI meminta Anda untuk memberikan kelas driver dari file driver JDBC. `.jar` Sebagian besar alat menemukan kelas ini secara otomatis. Nama kelas yang sepenuhnya memenuhi syarat dalam driver versi 3 adalah`com.amazon.athena.jdbc.AthenaDriver`. Di driver versi 2, kelasnya`com.simba.athena.jdbc.Driver`.

### String koneksi
<a name="jdbc-v3-driver-upgrading-connection-string"></a>

Driver versi 3 digunakan `jdbc:athena://` untuk protokol di awal URL string koneksi JDBC. Driver versi 3 juga mendukung protokol versi 2`jdbc:awsathena://`, tetapi penggunaan protokol versi 2 tidak digunakan lagi. Untuk menghindari perilaku yang tidak terdefinisi, versi 3 tidak menerima string koneksi yang dimulai dengan `jdbc:awsathena://` jika versi 2 (atau driver lain yang menerima string koneksi yang dimulai dengan`jdbc:awsathena://`) telah terdaftar di kelas. [DriverManager](https://docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html)

### Penyedia kredensyal
<a name="jdbc-v3-driver-upgrading-credentials-providers"></a>

Driver versi 2 menggunakan nama yang sepenuhnya memenuhi syarat untuk mengidentifikasi penyedia kredensyal yang berbeda (misalnya,. `com.simba.athena.amazonaws.auth.DefaultAWSCredentialsProviderChain` Driver versi 3 menggunakan nama yang lebih pendek (misalnya,`DefaultChain`). Nama-nama baru dijelaskan di bagian yang sesuai untuk setiap penyedia kredensyal.

Penyedia kredensi khusus yang ditulis untuk driver versi 2 perlu dimodifikasi untuk driver versi 3 untuk mengimplementasikan [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html)antarmuka dari yang baru AWS SDK untuk Java alih-alih antarmuka [AWSCredentialsPenyedia](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/AWSCredentialsProvider.html) dari sebelumnya. AWS SDK untuk Java

Tidak `PropertiesFileCredentialsProvider` didukung di driver JDBC 3.x. Penyedia digunakan dalam driver JDBC 2.x tetapi milik versi SDK for AWS Java sebelumnya yang mendekati akhir dukungan. Untuk mencapai fungsionalitas yang sama di driver JDBC 3.x, gunakan penyedia sebagai [AWS kredensi profil konfigurasi](jdbc-v3-driver-aws-configuration-profile-credentials.md) gantinya.

### Tingkat log
<a name="jdbc-v3-driver-upgrading-log-level"></a>

Tabel berikut menunjukkan perbedaan `LogLevel` parameter dalam driver JDBC versi 2 dan versi 3.


****  

| Versi driver JDBC | Nama parameter | Jenis parameter | Nilai default | Kemungkinan nilai | Contoh string koneksi | 
| --- | --- | --- | --- | --- | --- | 
| v2 | LogLevel | Opsional | 0 | 0-6 | LogLevel=6; | 
| v3 | LogLevel | Opsional | JEJAK | MATI, KESALAHAN, PERINGATAN, INFO, DEBUG, LACAK | LogLevel=INFO; | 

### Pengambilan ID kueri
<a name="jdbc-v3-driver-upgrading-query-id-retrieval"></a>

Dalam driver versi 2, Anda membuka `Statement` instance ke`com.interfaces.core.IStatementQueryInfoProvider`, antarmuka yang memiliki dua metode: `#getPReparedQueryId` dan`#getQueryId`. Anda dapat menggunakan metode ini untuk mendapatkan ID eksekusi kueri dari kueri yang telah berjalan.

Dalam driver versi 3, Anda membuka, `Statement``PreparedStatement`, dan `ResultSet` instance ke antarmuka. `com.amazon.athena.jdbc.AthenaResultSet` Antarmuka memiliki satu metode:`#getQueryExecutionId`.