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

# Athena JDBC 3.x driver
<a name="jdbc-v3-driver"></a>

Anda dapat menggunakan driver Athena JDBC untuk terhubung ke Amazon Athena dari banyak alat klien SQL pihak ketiga dan dari aplikasi khusus.

## Persyaratan Sistem
<a name="jdbc-v3-driver-system-requirements"></a>
+ Lingkungan runtime Java 8 (atau lebih tinggi)
+ Setidaknya 20 MB ruang disk yang tersedia

## Pertimbangan dan batasan
<a name="jdbc-v3-driver-considerations-and-limitations"></a>

Berikut ini adalah beberapa pertimbangan dan batasan untuk driver Athena JDBC 3.x.
+ **Logging** — Driver 3.x menggunakan [SLF4J](https://www.slf4j.org/manual.html), yang merupakan lapisan abstraksi yang memungkinkan penggunaan salah satu dari beberapa sistem logging saat runtime.
+ **Enkripsi** — Saat menggunakan pengambil Amazon S3 dengan opsi `CSE_KMS` enkripsi, klien Amazon S3 tidak dapat mendekripsi hasil yang disimpan dalam bucket Amazon S3. Jika Anda memerlukan `CSE_KMS` enkripsi, Anda dapat terus menggunakan streaming fetcher. Support untuk `CSE_KMS` enkripsi dengan fetcher Amazon S3 direncanakan.

## Unduhan driver JDBC 3.x
<a name="jdbc-v3-driver-download"></a>

Bagian ini berisi informasi unduhan dan lisensi untuk driver JDBC 3.x.

**penting**  
Saat Anda menggunakan driver JDBC 3.x, pastikan untuk mencatat persyaratan berikut:  
**Buka port 444** - Simpan port 444, yang digunakan Athena untuk mengalirkan hasil kueri, terbuka untuk lalu lintas keluar. Saat Anda menggunakan PrivateLink titik akhir untuk terhubung ke Athena, pastikan grup keamanan yang terpasang pada titik akhir terbuka untuk PrivateLink lalu lintas masuk di port 444. 
**athena: GetQueryResultsStream policy** — Tambahkan tindakan `athena:GetQueryResultsStream` kebijakan ke kepala sekolah IAM yang menggunakan driver JDBC. Tindakan dasar ini tidak terdedah secara langsung dengan API. Ini hanya digunakan dengan driver ODBC dan JDBC sebagai bagian dari dukungan hasil streaming. Untuk contoh kebijakan, lihat [AWS kebijakan terkelola: AWSQuicksight AthenaAccess](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy). 

Untuk mengunduh driver Amazon Athena 3.x JDBC, kunjungi tautan berikut.

### Toples uber driver JDBC
<a name="jdbc-v3-driver-download-uber-jar"></a>

Unduhan berikut mengemas driver dan semua dependensinya dalam file yang sama`.jar`. Unduhan ini biasanya digunakan untuk klien SQL pihak ketiga.

[https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-with-dependencies.jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-with-dependencies.jar)

### Toples ramping driver JDBC
<a name="jdbc-v3-driver-download-lean-jar"></a>

Download berikut adalah `.zip` file yang berisi lean `.jar` untuk driver dan `.jar` file terpisah untuk dependensi driver. Download ini biasanya digunakan untuk aplikasi kustom yang mungkin memiliki dependensi yang bertentangan dengan dependensi yang digunakan driver. Unduhan ini berguna jika Anda ingin memilih dependensi driver mana yang akan disertakan dengan lean jar, dan mana yang harus dikecualikan jika aplikasi khusus Anda sudah berisi satu atau lebih dari mereka.

[https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-lean-jar-and-separate-dependencies-jars.zip](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-lean-jar-and-separate-dependencies-jars.zip)

### Lisensi
<a name="jdbc-v3-driver-license"></a>

Tautan berikut berisi perjanjian lisensi untuk driver JDBC 3.x.

[Lisensi ](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/LICENSE.txt)

## Propagasi identitas tepercaya dengan JDBC
<a name="jdbc-v3-driver-trusted-identity"></a>

Anda sekarang dapat terhubung ke Amazon Athena menggunakan driver JDBC dengan kemampuan masuk tunggal melalui Identity Center. AWS Identity and Access Management Saat Anda mengakses Athena dari alat seperti PowerBI, Tableau, atau DBeaver, identitas dan izin Anda secara otomatis menyebar ke Athena melalui Pusat Identitas IAM. Untuk informasi selengkapnya, lihat [Gunakan propagasi identitas Tepercaya dengan driver Amazon Athena](using-trusted-identity-propagation.md).

**Topics**
+ [Persyaratan Sistem](#jdbc-v3-driver-system-requirements)
+ [Pertimbangan dan batasan](#jdbc-v3-driver-considerations-and-limitations)
+ [Unduhan driver JDBC 3.x](#jdbc-v3-driver-download)
+ [Propagasi identitas tepercaya dengan JDBC](#jdbc-v3-driver-trusted-identity)
+ [Memulai dengan driver JDBC 3.x](jdbc-v3-driver-getting-started.md)
+ [Parameter koneksi Amazon Athena JDBC 3.x](jdbc-v3-driver-connection-parameters.md)
+ [Konfigurasi JDBC 3.x lainnya](jdbc-v3-driver-other-configuration.md)
+ [Catatan rilis Amazon Athena JDBC 3.x](jdbc-v3-driver-release-notes.md)
+ [Versi sebelumnya dari driver Athena JDBC 3.x](jdbc-v3-driver-previous-versions.md)

# 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`.

# Parameter koneksi Amazon Athena JDBC 3.x
<a name="jdbc-v3-driver-connection-parameters"></a>

Parameter koneksi yang didukung dibagi di sini menjadi tiga bagian:[Parameter koneksi dasar](jdbc-v3-driver-basic-connection-parameters.md),[Parameter koneksi lanjutan](jdbc-v3-driver-advanced-connection-parameters.md), dan[Parameter koneksi otentikasi](jdbc-v3-driver-authentication-connection-parameters.md). Parameter koneksi lanjutan dan Parameter koneksi otentikasi memiliki subbagian yang mengelompokkan parameter terkait bersama-sama.

**Topics**
+ [Parameter koneksi dasar](jdbc-v3-driver-basic-connection-parameters.md)
+ [Parameter koneksi lanjutan](jdbc-v3-driver-advanced-connection-parameters.md)
+ [Parameter koneksi otentikasi](jdbc-v3-driver-authentication-connection-parameters.md)

# Parameter koneksi dasar
<a name="jdbc-v3-driver-basic-connection-parameters"></a>

Bagian berikut menjelaskan parameter koneksi dasar untuk driver JDBC 3.x.

## Region
<a name="jdbc-v3-driver-region"></a>

Di Wilayah AWS mana kueri akan dijalankan. Untuk daftar wilayah, lihat [titik akhir dan kuota Amazon Athena](https://docs.aws.amazon.com/general/latest/gr/athena.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Region | AwsRegion (usang) | Wajib (tetapi jika tidak disediakan, akan dicari menggunakan) [DefaultAwsRegionProviderChain](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/regions/providers/DefaultAwsRegionProviderChain.html)  | none | 

## Katalog
<a name="jdbc-v3-driver-catalog"></a>

Katalog yang berisi database dan tabel yang akan diakses dengan driver. Untuk informasi tentang katalog, lihat. [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html)


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Katalog | none | Opsional | AwsDataCatalog | 

## Basis Data
<a name="jdbc-v3-driver-database"></a>

Database tempat kueri akan berjalan. Tabel yang tidak secara eksplisit memenuhi syarat dengan nama database diselesaikan ke database ini. Untuk informasi tentang database, lihat [Database](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Basis Data | Skema | Opsional | default | 

## Grup Kerja
<a name="jdbc-v3-driver-workgroup"></a>

Workgroup di mana query akan berjalan. Untuk informasi tentang kelompok kerja, lihat [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| WorkGroup | none | Opsional | utama | 

## Lokasi keluaran
<a name="jdbc-v3-driver-output-location"></a>

Lokasi di Amazon S3 tempat hasil kueri akan disimpan. Untuk informasi tentang lokasi keluaran, lihat [ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OutputLocation | S3 OutputLocation (usang) | Wajib (kecuali workgroup menentukan lokasi output) | none | 

# Parameter koneksi lanjutan
<a name="jdbc-v3-driver-advanced-connection-parameters"></a>

Bagian berikut menjelaskan parameter koneksi lanjutan untuk driver JDBC 3.x.

**Topics**
+ [Parameter enkripsi hasil](#jdbc-v3-driver-result-encryption-parameters)
+ [Parameter pengambilan hasil](#jdbc-v3-driver-result-fetching-parameters)
+ [Parameter konfigurasi hasil](#jdbc-v3-driver-result-config)
+ [Parameter penggunaan kembali hasil kueri](#jdbc-v3-driver-query-result-reuse-parameters)
+ [Parameter polling eksekusi kueri](#jdbc-v3-driver-query-execution-polling-parameters)
+ [Parameter penggantian titik akhir](#jdbc-v3-driver-endpoint-override-parameters)
+ [Parameter konfigurasi proxy](#jdbc-v3-driver-proxy-configuration-parameters)
+ [Parameter pencatatan](#jdbc-v3-driver-logging-parameters)
+ [Nama aplikasi](#jdbc-v3-driver-application-name)
+ [Tes koneksi](#jdbc-v3-driver-connection-test)
+ [Jumlah percobaan](#jdbc-v3-driver-number-of-retries)
+ [Batas waktu jaringan](#jdbc-v3-driver-networktimeoutmillis)

## Parameter enkripsi hasil
<a name="jdbc-v3-driver-result-encryption-parameters"></a>

Perhatikan poin-poin berikut:
+  AWS KMS Kunci harus `EncryptionOption` ditentukan kapan `SSE_KMS` atau`CSE_KMS`.
+  AWS KMS Kunci tidak dapat `EncryptionOption` ditentukan kapan tidak ditentukan atau kapan `EncryptionOption``SSE_S3`.

### Opsi enkripsi
<a name="jdbc-v3-driver-encryption-option"></a>

Jenis enkripsi yang akan digunakan untuk hasil kueri karena disimpan di Amazon S3. Untuk informasi tentang enkripsi hasil kueri, lihat [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)di Referensi *API Amazon Athena*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Kemungkinan nilai | 
| --- | --- | --- | --- | --- | 
| EncryptionOption | S3 OutputEncOption (usang) | Opsional | none | SSE\$1S3, SSE\$1KMS, CSE\$1KMS | 

### Kunci KMS
<a name="jdbc-v3-driver-kms-key"></a>

Kunci KMS ARN atau ID, `SSE_KMS` jika `CSE_KMS` atau dipilih sebagai opsi enkripsi. Untuk informasi selengkapnya, lihat [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)di Referensi *API Amazon Athena*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| KmsKey | S3 OutputEnc KMSKey (usang) | Opsional | none | 

## Parameter pengambilan hasil
<a name="jdbc-v3-driver-result-fetching-parameters"></a>

### Pengambil hasil
<a name="jdbc-v3-driver-result-fetcher"></a>

Pengambil yang akan digunakan untuk mengunduh hasil kueri.

Pengambil hasil default,`auto`, mengunduh hasil kueri langsung dari Amazon S3 tanpa menggunakan Athena. APIs Ketika unduhan S3 langsung tidak dimungkinkan, seperti ketika hasil kueri dienkripsi dengan `CSE_KMS` opsi, secara otomatis akan kembali menggunakan API. `GetQueryResultsStream`

Menggunakan `auto` fetcher direkomendasikan dalam sebagian besar situasi. Jika kebijakan IAM, atau kebijakan bucket S3 Anda menggunakan CalledVia kondisi [s3:](security-iam-athena-calledvia.md) untuk membatasi akses ke permintaan objek S3 dari Athena, `auto` fetcher pertama-tama mencoba mengunduh hasil dari S3 dan kemudian kembali menggunakan API. `GetQueryResultsStream` Dalam situasi ini, Anda dapat mengatur ResultFetcher `GetQueryResultsStream` to untuk menghindari panggilan API tambahan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Kemungkinan nilai | 
| --- | --- | --- | --- | --- | 
| ResultFetcher | none | Opsional | auto | auto, S3,, GetQueryResults GetQueryResultsStream | 

### Ambil ukuran
<a name="jdbc-v3-driver-fetch-size"></a>

Nilai parameter ini digunakan sebagai minimum untuk buffer internal dan sebagai ukuran halaman target saat mengambil hasil. Nilai 0 (nol) berarti bahwa driver harus menggunakan defaultnya seperti yang dijelaskan di bawah ini. Nilai maksimumnya adalah 1.000.000.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| FetchSize | RowsToFetchPerBlock (usang) | Opsional | 0 | 
+ `GetQueryResults`Pengambil akan selalu menggunakan ukuran halaman 1.000, yang merupakan nilai maksimum yang didukung oleh panggilan API. Ketika ukuran fetch lebih tinggi dari 1.000, beberapa panggilan API berturut-turut dilakukan untuk mengisi buffer di atas minimum.
+ `GetQueryResultsStream`Pengambil akan menggunakan ukuran pengambilan yang dikonfigurasi sebagai ukuran halaman, atau 10.000 secara default.
+ `S3`Pengambil akan menggunakan ukuran pengambilan yang dikonfigurasi sebagai ukuran halaman, atau 10.000 secara default.

## Parameter konfigurasi hasil
<a name="jdbc-v3-driver-result-config"></a>

### Pemilik ember yang diharapkan
<a name="jdbc-v3-driver-exp-bucket-owner"></a>

ID akun pemilik bucket s3 yang diharapkan. Jika ID akun yang Anda berikan tidak cocok dengan pemilik sebenarnya dari bucket, permintaan gagal. Untuk informasi selengkapnya tentang memverifikasi pemilik bucket s3, lihat [Memverifikasi kepemilikan bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ExpectedBucketOwner | none | Opsional | none | 

### Opsi Acl
<a name="jdbc-v3-driver-acl"></a>

Menunjukkan bahwa ACL kalengan Amazon S3 harus disetel untuk mengontrol kepemilikan hasil kueri yang disimpan. Untuk informasi selengkapnya tentang `AclOption`, lihat [AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Kemungkinan nilai | 
| --- | --- | --- | --- | --- | 
| AclOption | none | Opsional | none | BUCKET\$1OWNER\$1FULL\$1CONTROL | 

## Parameter penggunaan kembali hasil kueri
<a name="jdbc-v3-driver-query-result-reuse-parameters"></a>

### Aktifkan penggunaan kembali hasil
<a name="jdbc-v3-driver-enable-result-reuse"></a>

Menentukan apakah hasil sebelumnya untuk query yang sama dapat digunakan kembali ketika query dijalankan. Untuk informasi tentang penggunaan kembali hasil kueri, lihat [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| EnableResultReuseByAge | none | Opsional | SALAH | 

### Hasil penggunaan kembali usia maks
<a name="jdbc-v3-driver-result-reuse-max-age"></a>

Usia maksimum, dalam hitungan menit, dari hasil kueri sebelumnya yang harus dipertimbangkan Athena untuk digunakan kembali. Untuk informasi tentang usia maksimal penggunaan kembali hasil, lihat [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| MaxResultReuseAgeInMinutes | none | Opsional | 60 | 

## Parameter polling eksekusi kueri
<a name="jdbc-v3-driver-query-execution-polling-parameters"></a>

### Interval polling eksekusi kueri minimum
<a name="jdbc-v3-driver-minimum-query-execution-polling-interval"></a>

Waktu minimum, dalam milidetik, untuk menunggu sebelum polling Athena untuk status eksekusi kueri.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| MinQueryExecutionPollingIntervalMillis | MinQueryExecutionPollingInterval (usang) | Opsional | 100 | 

### Interval polling eksekusi kueri maksimum
<a name="jdbc-v3-driver-maximum-query-execution-polling-interval"></a>

Waktu maksimum, dalam milidetik, untuk menunggu sebelum polling Athena untuk status eksekusi kueri.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| MaxQueryExecutionPollingIntervalMillis | MaxQueryExecutionPollingInterval (usang) | Opsional | 5000 | 

### Pengganda interval polling eksekusi kueri
<a name="jdbc-v3-driver-query-execution-polling-interval-multiplier"></a>

Faktor untuk meningkatkan masa pemungutan suara. Secara default, polling akan dimulai dengan nilai untuk `MinQueryExecutionPollingIntervalMillis` dan dua kali lipat dengan setiap polling hingga mencapai nilai untuk`MaxQueryExecutionPollingIntervalMillis`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| QueryExecutionPollingIntervalMultiplier | none | Opsional | 2 | 

## Parameter penggantian titik akhir
<a name="jdbc-v3-driver-endpoint-override-parameters"></a>

### Pengesampingan titik akhir Athena
<a name="jdbc-v3-driver-athena-endpoint-override"></a>

Titik akhir yang akan digunakan driver untuk melakukan panggilan API ke Athena.

Perhatikan poin-poin berikut:
+ Jika `http://` protokol `https://` atau tidak ditentukan dalam URL yang disediakan, driver memasukkan awalan. `https://`
+ Jika parameter ini tidak ditentukan, driver menggunakan endpoint default.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AthenaEndpoint | EndpointOverride (usang) | Opsional | none | 

### Pengesampingan titik akhir layanan streaming Athena
<a name="jdbc-v3-driver-athena-streaming-service-endpoint-override"></a>

Titik akhir yang akan digunakan driver untuk mengunduh hasil kueri saat menggunakan layanan streaming Athena. Layanan streaming Athena tersedia di port 444.

Perhatikan poin-poin berikut:
+ Jika `http://` protokol `https://` atau tidak ditentukan dalam URL yang disediakan, driver memasukkan awalan. `https://`
+ Jika port tidak ditentukan dalam URL yang disediakan, driver memasukkan port layanan streaming 444.
+ Jika `AthenaStreamingEndpoint` parameter tidak ditentukan, driver menggunakan `AthenaEndpoint` override. Jika baik penggantian `AthenaStreamingEndpoint` maupun `AthenaEndpoint` penggantian tidak ditentukan, driver menggunakan titik akhir streaming default.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AthenaStreamingEndpoint | StreamingEndpointOverride (usang) | Opsional | none | 

### LakeFormation penggantian titik akhir
<a name="jdbc-v3-driver-athena-lake-formation-endpoint-override"></a>

Endpoint yang akan digunakan driver untuk layanan Lake Formation saat menggunakan AWS Lake Formation [AssumeDecoratedRoleWithSAFL](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) API untuk mengambil kredensi sementara. Jika parameter ini tidak ditentukan, driver menggunakan endpoint Lake Formation default.

Perhatikan poin-poin berikut:
+ Jika `http://` protokol `https://` atau tidak ditentukan dalam URL yang disediakan, driver memasukkan awalan. `https://`


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEndpoint |  LfEndpointOverride (usang)  | Opsional | none | 

### Pengesampingan titik akhir S3
<a name="jdbc-v3-driver-athena-s3-endpoint-override"></a>

Titik akhir yang akan digunakan driver untuk mengunduh hasil kueri saat menggunakan pengambil Amazon S3. Jika parameter ini tidak ditentukan, driver menggunakan endpoint Amazon S3 default.

Perhatikan poin-poin berikut:
+ Jika `http://` protokol `https://` atau tidak ditentukan dalam URL yang disediakan, driver memasukkan awalan. `https://`


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Titik Akhir S3 | Tidak ada | Opsional | none | 

### Pengesampingan titik akhir STS
<a name="jdbc-v3-driver-athena-sts-endpoint-override"></a>

Titik akhir yang akan digunakan driver untuk AWS STS layanan saat menggunakan AWS STS [AssumeRoleWithSAFL](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) API untuk mengambil kredensi sementara. Jika parameter ini tidak ditentukan, driver menggunakan AWS STS endpoint default.

Perhatikan poin-poin berikut:
+ Jika `http://` protokol `https://` atau tidak ditentukan dalam URL yang disediakan, driver memasukkan awalan. `https://`


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| StsEndpoint | StsEndpointOverride(usang) | Opsional | none | 

### Pengesampingan titik akhir SSO OIDC
<a name="jdbc-v3-driver-athena-sso-oidc-endpoint-override"></a>

Titik akhir yang akan digunakan driver saat menggunakan `ClientConfiguration.endpointOverride` untuk mengganti titik akhir HTTP default untuk klien SSO OIDC. Untuk informasi selengkapnya, lihat [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| SSOOIDCEndpointMengesampingkan |  | Opsional | none | 

### Pengesampingan titik akhir Admin SSO
<a name="jdbc-v3-driver-athena-sso-admin-endpoint-override"></a>

Titik akhir yang akan digunakan driver saat menggunakan `ClientConfiguration.endpointOverride` untuk mengganti titik akhir HTTP default untuk klien Admin SSO. Untuk informasi selengkapnya, lihat [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| SSOAdminEndpointOverride |  | Opsional | none | 

## Parameter konfigurasi proxy
<a name="jdbc-v3-driver-proxy-configuration-parameters"></a>

### Tuan rumah proxy
<a name="jdbc-v3-driver-proxy-host"></a>

URL host proxy. Gunakan parameter ini jika Anda memerlukan permintaan Athena untuk melalui proxy.

**catatan**  
 Pastikan untuk menyertakan protokol `https://` atau `http://` di awal URL untuk`ProxyHost`. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProxyHost | none | Opsional | none | 

### Port proxy
<a name="jdbc-v3-driver-proxy-port"></a>

Port yang akan digunakan pada host proxy. Gunakan parameter ini jika Anda memerlukan permintaan Athena untuk melalui proxy.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProxyPort | none | Opsional | none | 

### Nama pengguna proxy
<a name="jdbc-v3-driver-proxy-username"></a>

Nama pengguna untuk mengautentikasi pada server proxy. Gunakan parameter ini jika Anda memerlukan permintaan Athena untuk melalui proxy.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProxyUsername | ProxYuID (usang) | Opsional | none | 

### Kata sandi proxy
<a name="jdbc-v3-driver-proxy-password"></a>

Kata sandi untuk mengautentikasi pada server proxy. Gunakan parameter ini jika Anda memerlukan permintaan Athena untuk melalui proxy.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProxyPassword | ProxyPwd (usang) | Opsional | none | 

### Host bebas proxy
<a name="jdbc-v3-driver-proxy-exempt-hosts"></a>

Satu set nama host yang terhubung ke driver tanpa menggunakan proxy saat proxy diaktifkan (yaitu, ketika parameter `ProxyHost` dan `ProxyPort` koneksi diatur). Host harus dipisahkan oleh karakter pipe (`|`) (misalnya,`host1.com|host2.com`).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProxyExemptHosts | NonProxyHosts | Opsional | none | 

### Proxy diaktifkan untuk penyedia identitas
<a name="jdbc-v3-driver-proxy-enabled-for-identity-providers"></a>

Menentukan apakah proxy harus digunakan ketika driver terhubung ke penyedia identitas.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProxyEnabledForIdP | UseProxyForIdP | Opsional | SALAH | 

## Parameter pencatatan
<a name="jdbc-v3-driver-logging-parameters"></a>

Bagian ini menjelaskan parameter yang terkait dengan logging.

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

Menentukan tingkat untuk logging driver. Tidak ada yang dicatat kecuali `LogPath` parameternya juga disetel.

**catatan**  
Kami merekomendasikan pengaturan hanya `LogPath` parameter kecuali Anda memiliki persyaratan khusus. Pengaturan hanya `LogPath` parameter memungkinkan logging dan menggunakan tingkat `TRACE` log default. Tingkat `TRACE` log menyediakan logging paling rinci.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Kemungkinan nilai | 
| --- | --- | --- | --- | --- | 
| LogLevel | none | Opsional | JEJAK | MATI, KESALAHAN, PERINGATAN, INFO, DEBUG, JEJAK | 

### Jalur log
<a name="jdbc-v3-driver-logging-parameters-log-path"></a>

Jalur ke direktori di komputer yang menjalankan driver tempat log driver akan disimpan. File log dengan nama unik akan dibuat dalam direktori yang ditentukan. Jika disetel, aktifkan pencatatan driver.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LogPath | none | Opsional | none | 

## Nama aplikasi
<a name="jdbc-v3-driver-application-name"></a>

Nama aplikasi yang menggunakan driver. Jika nilai untuk parameter ini ditentukan, nilai tersebut disertakan dalam string agen pengguna dari panggilan API yang dilakukan driver ke Athena.

**catatan**  
Anda juga dapat mengatur nama aplikasi dengan memanggil `setApplicationName` `DataSource` objek.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ApplicationName | none | Opsional | none | 

## Tes koneksi
<a name="jdbc-v3-driver-connection-test"></a>

Jika diatur ke`TRUE`, driver melakukan tes koneksi setiap kali koneksi JDBC dibuat, bahkan jika kueri tidak dijalankan pada koneksi.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ConnectionTest | none | Opsional | BETUL | 

**catatan**  
Tes koneksi mengirimkan `SELECT 1` kueri ke Athena untuk memverifikasi bahwa koneksi telah dikonfigurasi dengan benar. [Ini berarti bahwa dua file akan disimpan di Amazon S3 (set hasil dan metadata), dan biaya tambahan dapat berlaku sesuai dengan kebijakan harga Amazon Athena.](https://aws.amazon.com/athena/pricing)

## Jumlah percobaan
<a name="jdbc-v3-driver-number-of-retries"></a>

Jumlah maksimum kali pengemudi harus mengirim ulang permintaan yang dapat diambil ke Athena.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| NumRetries | MaxErrorRetry (usang) | Opsional | none | 

## Batas waktu jaringan
<a name="jdbc-v3-driver-networktimeoutmillis"></a>

Batas waktu jaringan mengontrol jumlah waktu pengemudi menunggu koneksi jaringan dibuat. Ini termasuk waktu yang diperlukan untuk mengirim permintaan API. Dalam keadaan yang jarang terjadi, mungkin berguna untuk mengubah batas waktu jaringan. Misalnya, Anda mungkin ingin menambah batas waktu untuk jeda pengumpulan sampah yang lama. Pengaturan parameter koneksi ini setara dengan menggunakan `setNetworkTimeout` metode pada `Connection` objek.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
|  NetworkTimeoutMillis  | none | Opsional | none | 

# Parameter koneksi otentikasi
<a name="jdbc-v3-driver-authentication-connection-parameters"></a>

Driver Athena JDBC 3.x mendukung beberapa metode otentikasi. Parameter koneksi yang diperlukan bergantung pada metode otentikasi yang Anda gunakan.

**Topics**
+ [IAM](jdbc-v3-driver-iam-credentials.md)
+ [Default](jdbc-v3-driver-default-credentials.md)
+ [AWS profil konfigurasi](jdbc-v3-driver-aws-configuration-profile-credentials.md)
+ [Profil instans](jdbc-v3-driver-instance-profile-credentials.md)
+ [Khusus](jdbc-v3-driver-custom-credentials.md)
+ [JWT](jdbc-v3-driver-jwt-credentials.md)
+ [JWT propagasi identitas tepercaya](jdbc-v3-driver-jwt-tip-credentials.md)
+ [Browser propagasi identitas tepercaya](jdbc-v3-driver-browser-oidc-tip-credentials.md)
+ [Azure AD](jdbc-v3-driver-azure-ad-credentials.md)
+ [Okta](jdbc-v3-driver-okta-credentials.md)
+ [Ping](jdbc-v3-driver-ping-credentials.md)
+ [IKLAN FS](jdbc-v3-driver-adfs-credentials.md)
+ [Browser Azure AD](jdbc-v3-driver-browser-azure-ad-credentials.md)
+ [Browser SALL](jdbc-v3-driver-browser-saml-credentials.md)
+ [DataZone IDc](jdbc-v3-driver-datazone-idc.md)
+ [DataZone IAM](jdbc-v3-driver-datazone-iamcp.md)

# Kredensial IAM
<a name="jdbc-v3-driver-iam-credentials"></a>

Anda dapat menggunakan kredensil IAM Anda dengan driver JDBC untuk terhubung ke Amazon Athena dengan mengatur parameter koneksi berikut.

## Pengguna
<a name="jdbc-v3-driver-user"></a>

ID kunci AWS akses Anda. Untuk informasi tentang kunci akses, lihat [kredensil AWS keamanan di Panduan Pengguna](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) *IAM*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Pengguna | AccessKeyId | Diperlukan | none | 

## Kata Sandi
<a name="jdbc-v3-driver-password"></a>

ID kunci AWS rahasiamu. Untuk informasi tentang kunci akses, lihat [kredensil AWS keamanan di Panduan Pengguna](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) *IAM*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Kata Sandi | SecretAccessKey | Opsional | none | 

## Token sesi
<a name="jdbc-v3-driver-session-token"></a>

Jika Anda menggunakan AWS kredensil sementara, Anda harus menentukan token sesi. *Untuk informasi tentang kredensil sementara, lihat [Kredensil keamanan sementara di IAM di Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html).*


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| SessionToken | none | Opsional | none | 

# Kredensi default
<a name="jdbc-v3-driver-default-credentials"></a>

Anda dapat menggunakan kredenal default yang Anda konfigurasikan pada sistem klien Anda untuk terhubung ke Amazon Athena dengan mengatur parameter koneksi berikut. *Untuk informasi tentang menggunakan kredensil default, lihat [Menggunakan Rantai Penyedia Kredenal Default di Panduan](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default) Pengembang AWS SDK untuk Java .*

## Penyedia kredensi
<a name="jdbc-v3-driver-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`DefaultChain`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass(usang) | Diperlukan | none | DefaultChain | 

# AWS kredensi profil konfigurasi
<a name="jdbc-v3-driver-aws-configuration-profile-credentials"></a>

Anda dapat menggunakan kredensil yang disimpan dalam profil AWS konfigurasi dengan mengatur parameter koneksi berikut. AWS profil konfigurasi biasanya disimpan dalam file di `~/.aws` direktori). Untuk informasi tentang profil AWS konfigurasi, lihat [Menggunakan profil](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-profiles.html) di *Panduan AWS SDK untuk Java Pengembang*.

## Penyedia kredensi
<a name="jdbc-v3-driver-aws-configuration-profile-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`ProfileCredentials`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass(usang) | Diperlukan | none | ProfileCredentials | 

## Nama profil
<a name="jdbc-v3-driver-profile-name"></a>

Nama profil AWS konfigurasi yang kredensialnya harus digunakan untuk mengautentikasi permintaan ke Athena.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ProfileName | none | Diperlukan | none | 

**catatan**  
Nama profil juga dapat ditentukan sebagai nilai `CredentialsProviderArguments` parameter, meskipun penggunaan ini tidak digunakan lagi.

# Kredensial profil instans
<a name="jdbc-v3-driver-instance-profile-credentials"></a>

Jenis otentikasi ini digunakan pada instans Amazon EC2. *Profil instans adalah profil* yang dilampirkan ke instans Amazon EC2. Menggunakan penyedia kredensil profil instans mendelegasikan pengelolaan AWS kredensional ke Layanan Metadata Instans Amazon EC2. Ini menghilangkan kebutuhan pengembang untuk menyimpan kredensil secara permanen di instans Amazon EC2 atau khawatir tentang memutar atau mengelola kredensil sementara.

## Penyedia kredensi
<a name="jdbc-v3-driver-instance-profile-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`InstanceProfile`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass(usang) | Diperlukan | none | InstanceProfile | 

# Kredensi kustom
<a name="jdbc-v3-driver-custom-credentials"></a>

Anda dapat menggunakan jenis otentikasi ini untuk memberikan kredensil Anda sendiri dengan menggunakan kelas Java yang mengimplementasikan antarmuka. [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html)

## Penyedia kredensi
<a name="jdbc-v3-driver-custom-credentials-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke nama kelas yang sepenuhnya memenuhi syarat dari kelas kustom yang mengimplementasikan [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html)antarmuka. Saat runtime, kelas itu harus berada di jalur kelas Java dari aplikasi yang menggunakan driver JDBC.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass(usang) | Diperlukan | none | Nama kelas yang sepenuhnya memenuhi syarat dari implementasi kustom AwsCredentialsProvider | 

## Argumen penyedia kredensil
<a name="jdbc-v3-driver-credentials-provider-arguments"></a>

Daftar argumen string yang dipisahkan koma untuk konstruktor penyedia kredensial kustom.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| CredentialsProviderArguments | AwsCredentialsProviderArguments (usang) | Opsional | none | 

# Kredensi JWT
<a name="jdbc-v3-driver-jwt-credentials"></a>

Dengan jenis otentikasi ini, Anda dapat menggunakan token web JSON (JWT) yang diperoleh dari penyedia identitas eksternal sebagai parameter koneksi untuk mengautentikasi dengan Athena. Penyedia kredensi eksternal harus sudah difederasi dengan. AWS

## Penyedia kredensi
<a name="jdbc-v3-driver-jwt-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`JWT`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | JWT | 

## Token identitas web JWT
<a name="jdbc-v3-driver-jwt-web-identity-token"></a>

Token JWT diperoleh dari penyedia identitas federasi eksternal. Token ini akan digunakan untuk mengautentikasi dengan Athena.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (usang) | Diperlukan | none | 

## Peran JWT ARN
<a name="jdbc-v3-driver-jwt-role-arn"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang mengasumsikan peran, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di *Referensi AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| JwtRoleArn | role\$1arn (usang) | Diperlukan | none | 

## Nama sesi peran JWT
<a name="jdbc-v3-driver-jwt-role-session-name"></a>

Nama sesi saat Anda menggunakan kredensi JWT untuk otentikasi. Nama dapat berupa nama apa saja yang Anda pilih.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (usang) | Diperlukan | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-jwt-role-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

# JWT dengan integrasi pusat identitas
<a name="jdbc-v3-driver-jwt-tip-credentials"></a>

Jenis otentikasi ini memungkinkan Anda untuk menggunakan token web JSON (JWT) yang diperoleh dari penyedia identitas eksternal sebagai parameter koneksi untuk mengautentikasi dengan Athena. Anda dapat menggunakan plugin ini, untuk mengaktifkan dukungan untuk identitas perusahaan melalui propagasi identitas tepercaya. Untuk informasi selengkapnya tentang cara menggunakan propagasi identitas tepercaya dengan driver, lihat[Gunakan propagasi identitas Tepercaya dengan driver Amazon Athena](using-trusted-identity-propagation.md). Anda juga dapat [mengonfigurasi dan menyebarkan sumber daya menggunakan CloudFormation](using-trusted-identity-propagation-cloudformation.md).

Dengan propagasi identitas tepercaya, konteks identitas ditambahkan ke peran IAM untuk mengidentifikasi pengguna yang meminta akses ke sumber daya. AWS Untuk informasi tentang mengaktifkan dan menggunakan propagasi identitas tepercaya, lihat [Apa itu propagasi identitas tepercaya?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html) .

## Penyedia kredensi
<a name="jdbc-v3-driver-jwt-tip-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`JWT_TIP`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | JWT\$1TIP | 

## Token identitas web JWT
<a name="jdbc-v3-driver-jwt-tip-web-identity-token"></a>

Token JWT diperoleh dari penyedia identitas federasi eksternal. Token ini akan digunakan untuk mengautentikasi dengan Athena. Token Caching diaktifkan secara default dan memungkinkan token akses Pusat Identitas yang sama untuk digunakan di seluruh koneksi driver. Kami merekomendasikan untuk memberikan token JWT baru setelah “Menguji Koneksi” karena token yang dipertukarkan hanya ada selama instance driver aktif.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (usang) | Diperlukan | none | 

## WorkgroupArn
<a name="jdbc-v3-driver-jwt-tip-workgroup-arn"></a>

Nama Sumber Daya Amazon (ARN) dari kelompok kerja Amazon Athena. Untuk informasi selengkapnya tentang kelompok kerja, lihat [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| WorkGroupArn | none | Diperlukan | utama | 

## Peran aplikasi JWT ARN
<a name="jdbc-v3-driver-jwt-tip-application-role-arn"></a>

ARN dari peran yang harus diasumsikan. Peran ini digunakan untuk pertukaran JWT, mendapatkan ARN aplikasi yang dikelola pelanggan IAM Identity Center melalui tag workgroup, dan mendapatkan ARN peran akses. Untuk informasi selengkapnya tentang mengambil peran, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | none | Diperlukan | none | 

## Nama sesi peran JWT
<a name="jdbc-v3-driver-jwt-tip-role-session-name"></a>

Nama sesi saat mengautentikasi dengan kredensi JWT. Itu bisa berupa nama pilihan Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (usang) | Diperlukan | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-jwt-tip-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Peran akses JWT ARN
<a name="jdbc-v3-driver-jwt-tip-access-role-arn"></a>

ARN dari peran yang harus diasumsikan. Ini adalah peran yang diambil oleh layanan Athena untuk melakukan panggilan atas nama Anda. Untuk informasi selengkapnya tentang mengasumsikan peran, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di *Referensi AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AccessRoleArn | none | Opsional | none | 

## ARN aplikasi terkelola pelanggan IAM Identity Center
<a name="jdbc-v3-driver-jwt-tip-customer-idc-application-arn"></a>

Aplikasi yang dikelola pelanggan ARN dari IAM Identity Center. Untuk informasi selengkapnya, lihat [aplikasi yang dikelola pelanggan](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| CustomerIdcApplicationArn | none | Opsional | none | 

# Browser berbasis dengan integrasi pusat identitas
<a name="jdbc-v3-driver-browser-oidc-tip-credentials"></a>

Jenis otentikasi ini memungkinkan Anda untuk mengambil token web JSON baru (JWT) dari penyedia identitas eksternal dan mengautentikasi dengan Athena. Anda dapat menggunakan plugin ini, untuk mengaktifkan dukungan untuk identitas perusahaan melalui propagasi identitas tepercaya. Untuk informasi selengkapnya tentang cara menggunakan propagasi identitas tepercaya dengan driver, lihat[Gunakan propagasi identitas Tepercaya dengan driver Amazon Athena](using-trusted-identity-propagation.md). Anda juga dapat [mengonfigurasi dan menyebarkan sumber daya menggunakan CloudFormation](using-trusted-identity-propagation-cloudformation.md).

Dengan propagasi identitas tepercaya, konteks identitas ditambahkan ke peran IAM untuk mengidentifikasi pengguna yang meminta akses ke sumber daya. AWS Untuk informasi tentang mengaktifkan dan menggunakan propagasi identitas tepercaya, lihat [Apa itu propagasi identitas tepercaya?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html) .

**catatan**  
Plugin ini dirancang khusus untuk lingkungan desktop pengguna tunggal. Dalam lingkungan bersama seperti Windows Server, administrator sistem bertanggung jawab untuk menetapkan dan memelihara batas-batas keamanan antar pengguna.

## Penyedia kredensi
<a name="jdbc-v3-driver-browser-oidc-tip-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`BrowserOidcTip`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | BrowserOidcTip | 

## URL konfigurasi Idp terkenal
<a name="jdbc-v3-driver-browser-oidc-tip-idp-well-known-config"></a>

URL Konfigurasi yang Dikenal IDP adalah titik akhir yang menyediakan detail konfigurasi OpenID Connect untuk penyedia identitas Anda. URL ini biasanya diakhiri dengan `.well-known/openid-configuration` dan berisi metadata penting tentang titik akhir otentikasi, fitur yang didukung, dan kunci penandatanganan token. Misalnya, jika Anda menggunakan *Okta*, URL mungkin terlihat seperti`https://your-domain.okta.com/.well-known/openid-configuration`.

Untuk pemecahan masalah: Jika Anda menerima kesalahan koneksi, verifikasi bahwa URL ini dapat diakses dari jaringan Anda dan mengembalikan konfigurasi OpenID *Connect* JSON yang valid. URL harus dapat dijangkau oleh klien tempat driver diinstal dan harus disediakan oleh administrator penyedia identitas Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdpWellKnownConfigurationUrl | none | Diperlukan | none | 

## Pengidentifikasi klien
<a name="jdbc-v3-driver-browser-oidc-tip-client-id"></a>

Pengenal klien yang dikeluarkan untuk aplikasi oleh penyedia OpenID Connect.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OidcClientId | none | Diperlukan | none | 

## WorkgroupArn
<a name="jdbc-v3-driver-browser-oidc-tip-workgroup-arn"></a>

Nama Sumber Daya Amazon (ARN) dari workgroup Amazon Athena yang berisi tag konfigurasi propagasi identitas tepercaya. Untuk informasi selengkapnya tentang kelompok kerja, lihat [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html). 

**catatan**  
Parameter ini berbeda dari `Workgroup` parameter yang menentukan di mana query akan berjalan. Anda harus mengatur kedua parameter:  
`WorkgroupArn`- Menunjuk ke workgroup yang berisi tag konfigurasi propagasi identitas tepercaya
`Workgroup`- Menentukan workgroup di mana query akan mengeksekusi
Meskipun ini biasanya merujuk pada kelompok kerja yang sama, kedua parameter harus ditetapkan secara eksplisit untuk operasi yang benar.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| WorkGroupArn | none | Diperlukan | utama | 

## Peran aplikasi JWT ARN
<a name="jdbc-v3-driver-browser-oidc-tip-application-role-arn"></a>

ARN dari peran yang akan diasumsikan dalam pertukaran JWT. Peran ini digunakan untuk pertukaran JWT, mendapatkan ARN aplikasi yang dikelola pelanggan IAM Identity Center melalui tag workgroup, dan mendapatkan ARN peran akses. Untuk informasi selengkapnya tentang mengambil peran, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html). 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | none | Diperlukan | none | 

## Nama sesi peran JWT
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-name"></a>

Nama untuk sesi IAM. Ini bisa apa saja yang Anda suka, tetapi biasanya Anda melewati nama atau pengenal yang terkait dengan pengguna yang menggunakan aplikasi Anda. Dengan begitu, kredenal keamanan sementara yang akan digunakan aplikasi Anda terkait dengan pengguna tersebut. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (usang) | Diperlukan | none | 

## Rahasia klien
<a name="jdbc-v3-driver-browser-oidc-tip-client-secret"></a>

ClientSecret adalah kunci rahasia yang dikeluarkan oleh penyedia identitas Anda yang digunakan untuk mengautentikasi aplikasi Anda (klien). Meskipun parameter ini opsional dan mungkin tidak diperlukan untuk semua aliran otentikasi, parameter ini memberikan lapisan keamanan tambahan saat digunakan. Jika konfigurasi IDP Anda memerlukan rahasia klien, Anda harus menyertakan parameter ini dengan nilai yang diberikan oleh administrator penyedia identitas Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OidcClientSecret | none | Opsional | none | 

## Lingkup
<a name="jdbc-v3-driver-browser-oidc-tip-scope"></a>

Cakupan menentukan tingkat akses yang diminta aplikasi Anda dari penyedia identitas. Anda harus menyertakan `openid` dalam ruang lingkup untuk menerima token ID yang berisi klaim identitas pengguna penting. Cakupan Anda mungkin perlu menyertakan izin tambahan seperti `email` atau`profile`, tergantung pada pengguna mana yang mengklaim penyedia identitas Anda (seperti *ID Microsoft Entra*) yang dikonfigurasi untuk disertakan dalam token ID. Klaim ini penting untuk pemetaan *Propagasi Identitas Tepercaya* yang tepat. Jika pemetaan identitas pengguna gagal, verifikasi bahwa cakupan Anda mencakup semua izin yang diperlukan dan penyedia identitas Anda dikonfigurasi untuk menyertakan klaim yang diperlukan dalam token ID. Klaim ini harus sesuai dengan konfigurasi pemetaan *Penerbit Token Tepercaya* Anda di Pusat Identitas IAM. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Lingkup | none | Opsional | email openid offline\$1access | 

## Durasi sesi peran
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Peran akses JWT ARN
<a name="jdbc-v3-driver-browser-oidc-tip-access-role-arn"></a>

ARN dari peran yang diasumsikan Athena untuk melakukan panggilan atas nama Anda. Untuk informasi selengkapnya tentang mengasumsikan peran, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di *Referensi AWS Security Token Service API*. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AccessRoleArn | none | Opsional | none | 

## ARN aplikasi terkelola pelanggan IAM Identity Center
<a name="jdbc-v3-driver-browser-oidc-tip-customer-idc-application-arn"></a>

Aplikasi yang dikelola pelanggan ARN dari IAM Identity Center. Untuk informasi selengkapnya, lihat [aplikasi yang dikelola pelanggan](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| CustomerIdcApplicationArn | none | Opsional | none | 

## Nomor port penyedia identitas
<a name="jdbc-v3-driver-browser-oidc-tip-idp-port-number"></a>

Nomor port lokal yang akan digunakan untuk server callback OAuth 2.0. Ini digunakan sebagai redirect\$1uri dan Anda harus mengizinkan daftar ini di aplikasi IDP Anda. Redirect\$1uri default yang dihasilkan adalah: http://localhost:7890/athena

**Awas**  
Di lingkungan bersama seperti Server Terminal Windows atau Layanan Desktop Jarak Jauh, port loopback (default: 7890) dibagikan di antara semua pengguna di mesin yang sama. Administrator sistem dapat mengurangi potensi risiko pembajakan port dengan:  
Mengkonfigurasi nomor port yang berbeda untuk grup pengguna yang berbeda
Menggunakan kebijakan keamanan Windows untuk membatasi akses port
Menerapkan isolasi jaringan antar sesi pengguna
Jika kontrol keamanan ini tidak dapat diterapkan, sebaiknya gunakan plugin [propagasi identitas tepercaya JWT](jdbc-v3-driver-jwt-tip-credentials.md), yang tidak memerlukan port loopback.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdpPortNumber | none | Opsional | 7890 | 

## Batas waktu respons penyedia identitas
<a name="jdbc-v3-driver-browser-oidc-tip-idp-response-timeout"></a>

Batas waktu dalam hitungan detik untuk menunggu respons callback OAuth 2.0.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | none | Opsional | 120 | 

## Aktifkan caching token
<a name="jdbc-v3-driver-browser-oidc-tip-enable-token-caching"></a>

 EnableTokenCaching Parameter menentukan apakah driver menyimpan token otentikasi di antara koneksi. Pengaturan EnableTokenCaching ke true mengurangi permintaan otentikasi dan meningkatkan pengalaman pengguna, tetapi harus digunakan dengan hati-hati. Pengaturan ini paling cocok untuk lingkungan desktop pengguna tunggal. Di lingkungan bersama seperti Windows Server, disarankan untuk menonaktifkan ini untuk mencegah potensi berbagi token antara pengguna dengan string koneksi serupa. 

Untuk penerapan perusahaan yang menggunakan alat seperti Tableau Server, sebaiknya gunakan plugin [propagasi identitas tepercaya JWT alih-alih metode otentikasi](jdbc-v3-driver-jwt-tip-credentials.md) ini. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| EnableTokenCaching | none | Opsional | SALAH | 

# Kredensi Azure AD
<a name="jdbc-v3-driver-azure-ad-credentials"></a>

Mekanisme otentikasi berbasis SAMP yang memungkinkan otentikasi ke Athena menggunakan penyedia identitas Azure AD. Metode ini mengasumsikan bahwa federasi telah dibentuk antara Athena dan Azure AD.

**catatan**  
Beberapa nama parameter di bagian ini memiliki alias. Alias adalah setara fungsional dari nama parameter dan telah disediakan untuk kompatibilitas mundur dengan driver JDBC 2.x. Karena nama parameter telah diperbaiki untuk mengikuti konvensi penamaan yang lebih jelas dan lebih konsisten, sebaiknya Anda menggunakannya alih-alih alias, yang telah usang. 

## Penyedia kredensi
<a name="jdbc-v3-driver-azure-ad-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`AzureAD`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | AzureAD | 

## Pengguna
<a name="jdbc-v3-driver-azure-ad-user"></a>

Alamat email pengguna Azure AD yang akan digunakan untuk otentikasi dengan Azure AD.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Pengguna | UID (usang) | Diperlukan | none | 

## Kata Sandi
<a name="jdbc-v3-driver-azure-ad-password"></a>

Kata sandi untuk pengguna Azure AD.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Kata Sandi | PWD (usang) | Diperlukan | none | 

## ID penyewa Azure AD
<a name="jdbc-v3-driver-azure-ad-tenant-id"></a>

ID penyewa aplikasi Azure AD Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AzureAdTenantId | tenant\$1id (usang) | Diperlukan | none | 

## ID klien Azure AD
<a name="jdbc-v3-driver-azure-ad-client-id"></a>

ID klien aplikasi Azure AD Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (usang) | Diperlukan | none | 

## Rahasia klien Azure AD
<a name="jdbc-v3-driver-azure-ad-client-secret"></a>

Rahasia klien aplikasi Azure AD Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AzureAdClientSecret | client\$1secret (usang) | Diperlukan | none | 

## Peran yang disukai
<a name="jdbc-v3-driver-preferred-role"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang peran ARN, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di Referensi *AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (tidak digunakan lagi) | Opsional | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-role-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Lake Formation diaktifkan
<a name="jdbc-v3-driver-lake-formation-enabled"></a>

[Menentukan apakah akan menggunakan aksi API Lake Formation [AssumeDecoratedRoleWithSAMP](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) untuk mengambil kredenal IAM sementara, bukan tindakan SAMP API. AssumeRoleWith](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opsional | SALAH | 

# Kredensi Okta
<a name="jdbc-v3-driver-okta-credentials"></a>

Mekanisme otentikasi berbasis SAMP yang memungkinkan otentikasi ke Athena menggunakan penyedia identitas Okta. Metode ini mengasumsikan bahwa federasi telah dibentuk antara Athena dan Okta.

## Penyedia kredensi
<a name="jdbc-v3-driver-okta-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`Okta`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | Okta | 

## Pengguna
<a name="jdbc-v3-driver-okta-user"></a>

Alamat email pengguna Okta untuk digunakan untuk otentikasi dengan Okta.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Pengguna | UID (usang) | Diperlukan | none | 

## Kata Sandi
<a name="jdbc-v3-driver-okta-password"></a>

Kata sandi untuk pengguna Okta.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Kata Sandi | PWD (usang) | Diperlukan | none | 

## Nama host Okta
<a name="jdbc-v3-driver-okta-host-name"></a>

URL untuk organisasi Okta Anda. Anda dapat mengekstrak `idp_host` parameter dari URL **Embed Link** di aplikasi Okta Anda. Untuk langkah, lihat [Ambil informasi konfigurasi ODBC dari Okta](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta). Segmen pertama setelah`https://`, hingga dan termasuk`okta.com`, adalah host idP Anda (misalnya, `trial-1234567.okta.com` untuk URL yang dimulai dengan`https://trial-1234567.okta.com`).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OktaHostName | IDP\$1host (usang) | Diperlukan | none | 

## ID aplikasi Okta
<a name="jdbc-v3-driver-okta-application-id"></a>

Pengidentifikasi dua bagian untuk aplikasi Anda. Anda dapat mengekstrak ID aplikasi dari URL **Embed Link** di aplikasi Okta Anda. Untuk langkah, lihat [Ambil informasi konfigurasi ODBC dari Okta](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta). ID aplikasi adalah dua segmen terakhir dari URL, termasuk garis miring ke depan di tengah. Segmen adalah dua string 20 karakter dengan campuran angka dan huruf besar dan kecil (misalnya,). `Abc1de2fghi3J45kL678/abc1defghij2klmNo3p4`


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OktaAppId | App\$1id (usang) | Diperlukan | none | 

## Nama aplikasi Okta
<a name="jdbc-v3-driver-okta-application-name"></a>

Nama aplikasi Okta Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OktaAppName | App\$1Name (usang) | Diperlukan | none | 

## Jenis MFA Okta
<a name="jdbc-v3-driver-okta-mfa-type"></a>

Jika Anda telah mengatur Okta untuk memerlukan otentikasi multi-faktor (MFA), Anda perlu menentukan jenis MFA Okta dan parameter tambahan tergantung pada faktor kedua yang ingin Anda gunakan.

Jenis Okta MFA adalah jenis faktor otentikasi kedua (setelah kata sandi) yang digunakan untuk mengautentikasi dengan Okta. Faktor kedua yang didukung termasuk pemberitahuan push yang dikirimkan melalui aplikasi Okta Verify dan kata sandi satu kali sementara (TOTPs) yang dihasilkan oleh Okta Verify, Google Authenticator, atau dikirim melalui SMS. Kebijakan keamanan organisasi individu menentukan apakah MFA diperlukan atau tidak untuk login pengguna.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Kemungkinan nilai | 
| --- | --- | --- | --- | --- | 
| OktaMfaType | okta\$1mfa\$1type (usang) | Diperlukan, jika Okta diatur untuk membutuhkan MFA | none | oktaverifywithpush, oktaverifywithtotp, googleauthenticator, smsauthentication | 

## Nomor telepon Okta
<a name="jdbc-v3-driver-okta-phone-number"></a>

Nomor telepon tempat Okta akan mengirim kata sandi satu kali sementara menggunakan SMS ketika jenis `smsauthentication` MFA dipilih. Nomor telepon harus berupa nomor telepon AS atau Kanada.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OktaPhoneNumber | okta\$1phone\$1number (usang) | Diperlukan, OktaMfaType jika smsauthentication | none | 

## Okta MFA waktu tunggu
<a name="jdbc-v3-driver-okta-mfa-wait-time"></a>

Durasi, dalam hitungan detik, untuk menunggu pengguna mengakui pemberitahuan push dari Okta sebelum pengemudi melempar pengecualian batas waktu.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| OktaMfaWaitTime | okta\$1mfa\$1wait\$1time (usang) | Opsional | 60 | 

## Peran yang disukai
<a name="jdbc-v3-driver-okta-preferred-role"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang peran ARN, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di Referensi *AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (tidak digunakan lagi) | Opsional | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-role-okta-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Lake Formation diaktifkan
<a name="jdbc-v3-driver-okta-lake-formation-enabled"></a>

[Menentukan apakah akan menggunakan aksi API Lake Formation [AssumeDecoratedRoleWithSAMP](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) untuk mengambil kredenal IAM sementara, bukan tindakan SAMP API. AssumeRoleWith](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opsional | SALAH | 

# Kredensi ping
<a name="jdbc-v3-driver-ping-credentials"></a>

Mekanisme otentikasi berbasis SAMP yang memungkinkan otentikasi ke Athena menggunakan penyedia identitas Federasi Ping. Metode ini mengasumsikan bahwa federasi telah dibentuk antara Athena dan Federasi Ping.

## Penyedia kredensi
<a name="jdbc-v3-driver-ping-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`Ping`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | Ping | 

## Pengguna
<a name="jdbc-v3-driver-ping-user"></a>

Alamat email pengguna Ping Federate untuk digunakan untuk otentikasi dengan Ping Federate.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Pengguna | UID (usang) | Diperlukan | none | 

## Kata Sandi
<a name="jdbc-v3-driver-ping-password"></a>

Kata sandi untuk pengguna Federasi Ping.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Kata Sandi | PWD (usang) | Diperlukan | none | 

## PingHostName
<a name="jdbc-v3-driver-ping-host-name"></a>

Alamat untuk server Ping Anda. Untuk menemukan alamat Anda, kunjungi URL berikut dan lihat bidang **Titik Akhir Aplikasi SSO**.

```
https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections
```


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PingHostName | IDP\$1host (usang) | Diperlukan | none | 

## PingPortNumber
<a name="jdbc-v3-driver-ping-port-number"></a>

Nomor port yang digunakan untuk terhubung ke host iDP Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PingPortNumber | IDP\$1port (usang) | Diperlukan | none | 

## PingPartnerSpId
<a name="jdbc-v3-driver-ping-partner-spid"></a>

Alamat penyedia layanan. Untuk menemukan alamat penyedia layanan, kunjungi URL berikut dan lihat bidang **Titik Akhir Aplikasi SSO**.

```
https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections
```


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
|  PingPartnerSpId  | Partner\$1SPID (usang) | Diperlukan | none | 

## Peran yang disukai
<a name="jdbc-v3-driver-ping-preferred-role"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang peran ARN, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di Referensi *AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (tidak digunakan lagi) | Opsional | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-role-ping-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Lake Formation diaktifkan
<a name="jdbc-v3-driver-ping-lake-formation-enabled"></a>

[Menentukan apakah akan menggunakan aksi API Lake Formation [AssumeDecoratedRoleWithSAMP](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) untuk mengambil kredenal IAM sementara, bukan tindakan SAMP API. AssumeRoleWith](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opsional | SALAH | 

# Kredensi AD FS
<a name="jdbc-v3-driver-adfs-credentials"></a>

Mekanisme otentikasi berbasis SAMP yang memungkinkan otentikasi ke Athena menggunakan Microsoft Active Directory Federation Services (AD FS). Metode ini mengasumsikan bahwa pengguna telah mengatur federasi antara Athena dan AD FS.

## Penyedia kredensi
<a name="jdbc-v3-driver-adfs-credentials-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`ADFS`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | ADFS | 

## Pengguna
<a name="jdbc-v3-driver-adfs-credentials-user"></a>

Alamat email pengguna AD FS yang akan digunakan untuk otentikasi dengan AD FS.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Pengguna | UID (usang) | Diperlukan untuk otentikasi berbasis formulir. Opsional untuk Otentikasi Terpadu Windows. | none | 

## Kata Sandi
<a name="jdbc-v3-driver-adfs-credentials-password"></a>

Kata sandi untuk pengguna AD FS.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Kata Sandi | PWD (usang) | Diperlukan untuk otentikasi berbasis formulir. Opsional untuk Otentikasi Terpadu Windows. | none | 

## Nama host ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfshostname"></a>

Alamat untuk server AD FS Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AdfsHostName | IDP\$1host (usang) | Diperlukan | none | 

## Nomor port ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfsportnumber"></a>

Nomor port yang digunakan untuk terhubung ke server AD FS Anda.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AdfsPortNumber | IDP\$1port (usang) | Diperlukan | none | 

## Partai mengandalkan ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfsrelyingparty"></a>

Partai mengandalkan tepercaya. Gunakan parameter ini untuk mengganti URL titik akhir pihak yang mengandalkan AD FS.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AdfsRelyingParty | LoginToRP (usang) | Opsional | urn:amazon:webservices | 

## ADFS WIA diaktifkan
<a name="jdbc-v3-driver-adfs-credentials-adfswiaenabled"></a>

Boolean. Gunakan parameter ini untuk mengaktifkan Windows Integrated Authentication (WIA) dengan AD FS.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AdfsWiaEnabled | none | Opsional | FALSE | 

## Peran yang disukai
<a name="jdbc-v3-driver-adfs-credentials-preferred-role"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang peran ARN, lihat [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di Referensi *AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (tidak digunakan lagi) | Opsional | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-adfs-credentials-role-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Lake Formation diaktifkan
<a name="jdbc-v3-driver-adfs-credentials-lake-formation-enabled"></a>

Menentukan apakah akan menggunakan aksi [https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html)Lake Formation API untuk mengambil kredenal IAM sementara, bukan tindakan API. [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opsional | SALAH | 

# Kredensi Browser Azure AD
<a name="jdbc-v3-driver-browser-azure-ad-credentials"></a>

Browser Azure AD adalah mekanisme otentikasi berbasis SAMP yang bekerja dengan penyedia identitas Azure AD dan mendukung otentikasi multi-faktor. Berbeda dengan mekanisme otentikasi Azure AD standar, mekanisme ini tidak memerlukan nama pengguna, kata sandi, atau rahasia klien dalam parameter koneksi. Seperti mekanisme otentikasi Azure AD standar, Browser Azure AD juga mengasumsikan pengguna telah mengatur federasi antara Athena dan Azure AD.

## Penyedia kredensi
<a name="jdbc-v3-driver-browser-azure-ad-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`BrowserAzureAD`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | BrowserAzureAD | 

## ID penyewa Azure AD
<a name="jdbc-v3-driver-browser-azure-ad-azure-ad-tenant-id"></a>

ID penyewa aplikasi Azure AD Anda


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AzureAdTenantId | tenant\$1id (usang) | Diperlukan | none | 

## ID klien Azure AD
<a name="jdbc-v3-driver-browser-azure-ad-azure-ad-client-id"></a>

ID klien aplikasi Azure AD Anda


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (usang) | Diperlukan | none | 

## Batas waktu respons penyedia identitas
<a name="jdbc-v3-driver-identity-provider-response-timeout"></a>

Durasi, dalam hitungan detik, sebelum pengemudi berhenti menunggu respons SAMP dari Azure AD.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (usang) | Opsional | 120 | 

## Peran yang disukai
<a name="jdbc-v3-driver-browser-azure-ad-preferred-role"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang peran ARN, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di Referensi *AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (tidak digunakan lagi) | Opsional | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-browser-azure-ad-role-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Lake Formation diaktifkan
<a name="jdbc-v3-driver-browser-azure-ad-lake-formation-enabled"></a>

[Menentukan apakah akan menggunakan aksi API Lake Formation [AssumeDecoratedRoleWithSAMP](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) untuk mengambil kredenal IAM sementara, bukan tindakan SAMP API. AssumeRoleWith](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opsional | SALAH | 

# Kredensi SAM Browser
<a name="jdbc-v3-driver-browser-saml-credentials"></a>

Browser SAMP adalah plugin otentikasi generik yang dapat bekerja dengan penyedia identitas berbasis SAMP dan mendukung otentikasi multi-faktor.

## Penyedia kredensi
<a name="jdbc-v3-driver-browser-saml-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`BrowserSaml`.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | BrowserSaml | 

## URL login masuk tunggal
<a name="jdbc-v3-driver-single-sign-on-login-url"></a>

URL masuk tunggal untuk aplikasi Anda pada penyedia identitas berbasis SAMP.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| SsoLoginUrl | login\$1url (usang) | Diperlukan | none | 

## Dengarkan port
<a name="jdbc-v3-driver-listen-port"></a>

Nomor port yang digunakan untuk mendengarkan respons SAMP. Nilai ini harus sesuai dengan URL yang Anda gunakan untuk mengonfigurasi penyedia identitas berbasis SAMP (misalnya,`http://localhost:7890/athena`).


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ListenPort | listen\$1port (usang) | Opsional | 7890 | 

## Batas waktu respons penyedia identitas
<a name="jdbc-v3-driver-single-sign-on-login-url-identity-provider-response-timeout"></a>

Durasi, dalam hitungan detik, sebelum pengemudi berhenti menunggu respons SAMP dari Azure AD.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (usang) | Opsional | 120 | 

## Peran yang disukai
<a name="jdbc-v3-driver-single-sign-on-login-url-preferred-role"></a>

Amazon Resource Name (ARN) dari peran yang diambil. Untuk informasi tentang peran ARN, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di Referensi *AWS Security Token Service API*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (tidak digunakan lagi) | Opsional | none | 

## Durasi sesi peran
<a name="jdbc-v3-driver-single-sign-on-login-url-role-session-duration"></a>

Durasi, dalam hitungan detik, dari sesi peran. Untuk informasi selengkapnya, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) di dalam *Referensi API AWS Security Token Service *. 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Durasi (usang) | Opsional | 3600 | 

## Lake Formation diaktifkan
<a name="jdbc-v3-driver-single-sign-on-login-url-lake-formation-enabled"></a>

[Menentukan apakah akan menggunakan aksi API Lake Formation [AssumeDecoratedRoleWithSAMP](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) untuk mengambil kredenal IAM sementara, bukan tindakan SAMP API. AssumeRoleWith](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS 


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opsional | SALAH | 

# DataZone Penyedia Kredensial IDc
<a name="jdbc-v3-driver-datazone-idc"></a>

Mekanisme otentikasi yang memungkinkan penyambungan ke data DataZone yang diatur di Athena menggunakan IAM Identity Center.

## Penyedia kredensi
<a name="jdbc-v3-driver-datazone-idc-credentials-provider"></a>

Penyedia kredensi yang akan digunakan untuk mengautentikasi permintaan ke. AWS Tetapkan nilai parameter ini ke`DataZoneIdc`. Perhatikan bahwa `AWSCredentialsProviderClass` alias tidak digunakan lagi; gunakan nama parameter sebagai gantinya. `CredentialsProvider`


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | Nilai untuk digunakan | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (usang) | Diperlukan | none | DataZoneIdc | 

## DataZone pengenal domain
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-identifier"></a>

Identifier DataZone domain yang akan digunakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneDomainId | none | Diperlukan | none | 

## DataZone pengenal lingkungan
<a name="jdbc-v3-driver-datazone-idc-datazone-environment-identifier"></a>

Pengidentifikasi DataZone lingkungan yang akan digunakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | none | Diperlukan | none | 

## DataZone wilayah domain
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-region"></a>

 Wilayah AWS Tempat DataZone domain Anda disediakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | none | Diperlukan | none | 

## Region
<a name="jdbc-v3-driver-datazone-idc-region"></a>

 Wilayah AWS Tempat DataZone lingkungan Anda dan kelompok kerja Athena disediakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Region | none | Diperlukan | none | 

## URL penerbit IAM Identity Center
<a name="jdbc-v3-driver-datazone-idc-iam-identity-center-issuer-url"></a>

URL penerbit dari instance IAM Identity Center yang digunakan DataZone domain.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdentityCenterIssuerUrl | none | Diperlukan | none | 

## DataZone penggantian titik akhir
<a name="jdbc-v3-driver-datazone-idc-datazone-endpoint-override"></a>

Titik akhir DataZone API yang akan digunakan sebagai pengganti default untuk yang disediakan Wilayah AWS.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneEndpointOverride | none | Opsional | none | 

## Aktifkan caching token
<a name="jdbc-v3-driver-datazone-idc-enable-token-caching"></a>

Saat diaktifkan, memungkinkan token akses Pusat Identitas IAM yang sama untuk digunakan di seluruh koneksi driver. Ini mencegah alat SQL yang membuat beberapa koneksi driver meluncurkan beberapa jendela browser. Jika Anda mengaktifkan parameter ini, kami sarankan Anda menutup alat SQL segera setelah menggunakannya untuk menghapus cache token dan memerlukan otentikasi ulang.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| EnableTokenCaching | none | Opsional | SALAH | 

## Dengarkan port
<a name="jdbc-v3-driver-datazone-idc-listen-port"></a>

Nomor port yang mendengarkan respon IAM Identity Center.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| ListenPort | none | Opsional | 8000 | 

## Waktu respons penyedia identitas habis
<a name="jdbc-v3-driver-datazone-idc-identity-provider-response-time-out"></a>

Durasi, dalam hitungan detik, sebelum pengemudi berhenti menunggu respons dari IAM Identity Center.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | none | Opsional | 120 | 

# DataZone Penyedia Kredensial IAM
<a name="jdbc-v3-driver-datazone-iamcp"></a>

Mekanisme otentikasi yang menggunakan kredensil IAM untuk terhubung ke data yang DataZone diatur di Athena.

## DataZone pengenal domain
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-identifier"></a>

Identifier DataZone domain yang akan digunakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneDomainId | none | Diperlukan | none | 

## DataZone pengenal lingkungan
<a name="jdbc-v3-driver-datazone-iamcp-datazone-environment-identifier"></a>

Pengidentifikasi DataZone lingkungan yang akan digunakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | none | Diperlukan | none | 

## DataZone wilayah domain
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-region"></a>

 Wilayah AWS Tempat DataZone domain Anda disediakan.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | none | Diperlukan | none | 

## DataZone penggantian titik akhir
<a name="jdbc-v3-driver-datazone-iamcp-datazone-endpoint-override"></a>

Titik akhir DataZone API yang akan digunakan sebagai pengganti titik akhir default untuk yang disediakan. Wilayah AWS


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| DataZoneEndpointOverride | none | Opsional | none | 

## Pengguna
<a name="jdbc-v3-driver-datazone-iamcp-user"></a>

ID kunci AWS akses Anda. Untuk informasi selengkapnya tentang kunci akses, lihat [kredensil AWS keamanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) di Panduan Pengguna *IAM*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Pengguna | AccessKeyId | Opsional | none | 

## Kata Sandi
<a name="jdbc-v3-driver-datazone-iamcp-password"></a>

ID kunci AWS rahasiamu. Untuk informasi selengkapnya tentang kunci akses, lihat [kredensil AWS keamanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) di Panduan Pengguna *IAM*.


****  

| Nama parameter | Alias | Jenis parameter | Nilai default | 
| --- | --- | --- | --- | 
| Kata Sandi | SecretAccessKey | Opsional | none | 

# Konfigurasi JDBC 3.x lainnya
<a name="jdbc-v3-driver-other-configuration"></a>

Bagian berikut menjelaskan beberapa pengaturan konfigurasi tambahan untuk driver JDBC 3.x.

## Batas waktu jaringan
<a name="jdbc-v3-driver-network-timeout"></a>

Batas waktu jaringan mengontrol jumlah waktu dalam milidetik driver menunggu koneksi jaringan dibuat. Ini termasuk waktu yang diperlukan untuk mengirim permintaan API. Setelah waktu ini, pengemudi melempar pengecualian batas waktu. Dalam keadaan yang jarang terjadi, mungkin berguna untuk mengubah batas waktu jaringan. Misalnya, Anda mungkin ingin menambah batas waktu untuk jeda pengumpulan sampah yang lama.

Untuk mengaturnya, panggil `setNetworkTimeout` metode pada objek JDBC`Connection`. Nilai ini dapat diubah selama siklus hidup koneksi JDBC. Untuk informasi selengkapnya, lihat [setNetworkTimeout](https://docs.oracle.com/javase/8/docs/api/java/sql/Connection.html#setNetworkTimeout-java.util.concurrent.Executor-int-)di dokumentasi Oracle JDBC API. Menggunakan `setNetworkTimeout` metode ini setara dengan pengaturan parameter [Batas waktu jaringan](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-networktimeoutmillis) koneksi. 

Contoh berikut menetapkan batas waktu jaringan menjadi 5000 milidetik.

```
...
AthenaDriver driver = new AthenaDriver();
Connection connection = driver.connect(url, connectionParameters);
connection.setNetworkTimeout(null, 5000);
...
```

## Batas waktu kueri
<a name="jdbc-v3-driver-query-timeout"></a>

Jumlah waktu, dalam hitungan detik, pengemudi akan menunggu permintaan selesai di Athena setelah kueri diajukan. Setelah waktu ini, pengemudi mencoba membatalkan kueri yang dikirimkan dan melempar pengecualian batas waktu.

Batas waktu kueri tidak dapat ditetapkan sebagai parameter koneksi. Untuk mengaturnya, panggil `setQueryTimeout` metode pada objek JDBC`Statement`. Nilai ini dapat diubah selama siklus hidup pernyataan JDBC. Nilai default parameter ini adalah `0` (nol). Nilai `0` berarti bahwa kueri dapat dijalankan hingga selesai (tergantung pada[Service Quotas](service-limits.md)).

Contoh berikut menetapkan batas waktu query untuk 5 detik.

```
...
AthenaDriver driver = new AthenaDriver();
Connection connection = driver.connect(url, connectionParameters);
Statement statement = connection.createStatement();
statement.setQueryTimeout(5);
...
```

# Catatan rilis Amazon Athena JDBC 3.x
<a name="jdbc-v3-driver-release-notes"></a>

Catatan rilis ini memberikan rincian perbaikan dan perbaikan di driver Amazon Athena JDBC 3.x.

## 3.7.0
<a name="jdbc-v3-driver-release-notes-2025-11-21"></a>

Dirilis 2025-11-21

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-11-21-improvements"></a>
+ **Browser OIDC Plugin otentikasi propagasi identitas tepercaya - Menambahkan plugin otentikasi** baru yang memungkinkan otentikasi berbasis browser mulus dengan penyedia identitas OpenID Connect (OIDC). Plugin ini menangani aliran OAuth 2.0 lengkap melalui browser default Anda, secara otomatis mengambil JSON Web Token (JWT), dan terintegrasi dengan propagasi identitas tepercaya. Dirancang khusus untuk lingkungan desktop pengguna tunggal, ini memberikan pengalaman otentikasi yang lebih efisien dibandingkan dengan penanganan JWT manual. Untuk informasi selengkapnya tentang propagasi identitas tepercaya, lihat [Apa itu propagasi identitas tepercaya](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)? .

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-11-21-fixes"></a>
+ **Dukungan presisi stempel waktu yang ditingkatkan** - Pengemudi sekarang sepenuhnya mendukung presisi milidetik dan nanodetik dalam nilai stempel waktu yang dikembalikan dari kueri Athena melalui metode ini. `getTimestamp()`
+ **Peningkatan penanganan tipe kompleks** - Memperbaiki masalah dengan mengurai tipe data bersarang (array, struct, dan peta) di kedua `DatabaseMetaData#getColumns` operasi metadata umum, memastikan informasi tipe akurat untuk struktur data yang kompleks.
+ **Pencatatan kesalahan yang disempurnakan** - Peningkatan logging untuk kegagalan pengambilan metadata S3, memberikan pesan kesalahan yang lebih jelas dan informasi diagnostik yang lebih baik.

## 3.6.0
<a name="jdbc-v3-driver-release-notes-2025-09-10"></a>

Dirilis 2025-09-10

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-09-10-improvements"></a>
+ **JWT Plugin otentikasi propagasi identitas tepercaya - Menambahkan plugin otentikasi** baru untuk mendukung integrasi propagasi identitas tepercaya JWT dengan driver JDBC. Jenis otentikasi ini memungkinkan Anda untuk menggunakan token web JSON (JWT) yang diperoleh dari penyedia identitas eksternal sebagai parameter koneksi untuk mengautentikasi dengan Athena. Dengan propagasi identitas tepercaya, konteks identitas ditambahkan ke peran IAM untuk mengidentifikasi pengguna yang meminta akses ke sumber daya. AWS Untuk informasi tentang mengaktifkan dan menggunakan propagasi identitas tepercaya, lihat [Apa itu propagasi identitas tepercaya?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html) .
+ Dukungan endpoint **admin SSO OIDC dan SSO kustom - Menambahkan dukungan untuk titik akhir** SSO OIDC dan SSO Admin kustom di driver JDBC. Peningkatan ini memungkinkan Anda untuk menentukan titik akhir Anda sendiri untuk layanan SSO saat menjalankan JDBC di belakang. VPCs
+ **AWS Pembaruan versi SDK - Kami telah memperbarui versi** AWS SDK yang digunakan dalam driver ke 2.32.16 dan telah memperbarui dependensi proyek untuk rilis 3.6.0.

## 3.5.1
<a name="jdbc-v3-driver-release-notes-2025-07-17"></a>

Dirilis 2025-07-17

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-07-17-improvements"></a>
+ **Kemampuan logging** — Peningkatan pencatatan pengambilan S3 dengan meningkatkan level log `INFO` dan menambahkan metrik untuk jumlah baris, offset, dan panjang objek. Melacak siklus hidup koneksi yang diterapkan dan kinerja pencatatan keseluruhan yang dioptimalkan.
+ **Penanganan karakter khusus** - Peningkatan penanganan karakter khusus untuk `LIKE` pola dalam skema dan nama katalog.
+ **Manajemen status koneksi** — Peningkatan manajemen status koneksi untuk mencegah potensi kesalahan dengan mencegah panggilan API setelah penutupan koneksi dan menambahkan pemeriksaan keamanan untuk operasi kueri selama shutdown.

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-07-17-fixes"></a>
+ **Metadata kueri DDL - Memperbaiki `NoSuchKeyFound` masalah dengan penanganan metadata** kueri DDL.

## 3.5.0
<a name="jdbc-v3-driver-release-notes-2025-03-18"></a>

Dirilis 2025-03-18

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-03-18-improvements"></a>
+ **Parameter konfigurasi hasil** - Menambahkan dukungan untuk dua parameter koneksi baru `ExpectedBucketOwner` dan`AclOption`. Untuk informasi selengkapnya, lihat [Parameter konfigurasi hasil](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-config).
+ AWS Versi **SDK — Versi** AWS SDK yang digunakan dalam driver telah diperbarui ke 2.30.22.

## 3.4.0
<a name="jdbc-v3-driver-release-notes-2025-02-18"></a>

Dirilis 2025-02-18

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-02-18-improvements"></a>
+ **Result Fetcher** — Driver sekarang secara otomatis memilih metode tercepat untuk mengunduh hasil kueri. Ini menghilangkan kebutuhan untuk mengkonfigurasi fetcher secara manual di sebagian besar situasi. Untuk informasi selengkapnya, lihat [Parameter pengambilan hasil](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-fetching-parameters).

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2025-02-18-fixes"></a>
+ **ResultSet**— Driver sekarang menangani iterasi atas set hasil pernyataan DDL yang tidak menghasilkan objek hasil pada S3. Ini juga mengembalikan `ResultSet` objek kosong bukan null ketika `GetQueryResultsStream` mengembalikan halaman benar-benar kosong.
+ **ResultsStream**— Hasil streaming telah dioptimalkan dengan menghapus panggilan yang tidak perlu untuk menghitung jumlah baris dalam buffer internal.
+ **GetTables** - `GetTables` Panggilan telah dioptimalkan dengan menangani jenis tabel berdasarkan `ListTableMetadata` dan `GetTableMetadata` tanggapan.

## 3.3.0
<a name="jdbc-v3-driver-release-notes-2024-10-30"></a>

Dirilis 2024-10-30

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-10-30-improvements"></a>
+ **DataZone otentikasi** - Ditambahkan dukungan untuk plugin DataZone `DataZoneIdC` otentikasi dan. `DataZoneIAM` Untuk informasi selengkapnya, lihat [DataZone Penyedia Kredensial IDc](jdbc-v3-driver-datazone-idc.md) dan [DataZone Penyedia Kredensial IAM](jdbc-v3-driver-datazone-iamcp.md).
+ Batas **waktu jaringan** — Batas waktu jaringan sekarang dapat diatur menggunakan parameter `NetworkTimeoutMillis` koneksi. Sebelumnya bisa diatur hanya pada `Connection` objek itu sendiri. Untuk informasi selengkapnya, lihat [Batas waktu jaringan](jdbc-v3-driver-other-configuration.md#jdbc-v3-driver-network-timeout).

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-10-30-fixes"></a>
+ **Penanganan objek kosong S3** - Driver sekarang menangani objek kosong di fetcher S3 alih-alih melempar pengecualian Amazon S3 Range Not Satisfiable.
+ **Logging** — Driver tidak lagi mencatat pesan Item yang diminta untuk eksekusi kueri [...], tetapi langganan dibatalkan setelah mengkonsumsi hasil kueri.
+ **String parameter kosong** — Driver sekarang menangani string kosong yang ada dalam parameter koneksi seolah-olah parameter tidak ada. Ini menyelesaikan masalah yang terjadi ketika beberapa alat BI secara tidak sengaja melewati string kosong yang menyebabkan upaya otentikasi yang tidak diinginkan.

## 3.2.2
<a name="jdbc-v3-driver-release-notes-2024-07-29"></a>

Dirilis 2024-07-29

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-07-29-improvements"></a>
+ **Pemetaan tipe data** - Meningkatkan kepatuhan dengan spesifikasi JDBC dengan mengubah cara driver memetakan`tinyint`,, `smallint``row`, dan tipe `struct` data ke objek Java.
+ **AWS Pembaruan versi SDK** - Versi AWS SDK yang digunakan dalam driver telah diperbarui ke 2.26.23.

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-07-29-fixes"></a>
+ **Komentar** - Memperbaiki masalah dengan komentar baris di akhir pernyataan.
+ **Daftar database** - Memperbaiki masalah di mana database daftar dapat memasuki loop tak terbatas ketika halaman terakhir yang dikembalikan oleh `ListDatabases` API paginasi kosong.

## 3.2.1
<a name="jdbc-v3-driver-release-notes-2024-07-03"></a>

Dirilis 2024-07-03

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-07-03-improvements"></a>
+ **Penyedia kredensyal JWT** - Menambahkan dukungan untuk durasi sesi yang ditentukan pengguna. Untuk informasi selengkapnya, lihat [Durasi sesi peran](jdbc-v3-driver-jwt-credentials.md#jdbc-v3-driver-jwt-role-session-duration).

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-07-03-fixes"></a>
+ **Thread pool** — Dibuat satu `ThreadPoolExecutor` per koneksi untuk tugas asinkron agar tidak menggunakan pool. `ForkJoin`
+ **Penyedia kredensi** — Host proxy sekarang diurai untuk mendapatkan skema dan host ketika klien HTTP dikonfigurasi untuk eksternal. IdPs
+ Penyedia **kredensyal default - Memastikan penyedia** kredensyal default tidak dapat ditutup oleh kode klien.
+ **GetColumns** - Memperbaiki masalah properti `ORDINAL_COLUMN` kolom dalam `DatabaseMetaData#getColumns` metode.
+ **ResultSet**— Menambahkan dukungan untuk `Infinity``-Infinity`,, dan `NaN` untuk `ResultSet.` Memperbaiki perbedaan antara jenis kolom yang dikembalikan dari operasi katalog dan kumpulan hasil dari kueri yang lengkap.

## 3.2.0
<a name="jdbc-v3-driver-release-notes-2024-02-26"></a>

Dirilis 2024-04-26

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-02-26-improvements"></a>
+ **Kinerja operasi katalog** — Kinerja telah ditingkatkan untuk operasi katalog yang tidak menggunakan karakter wildcard.
+ **Perubahan interval polling** minimum — Default interval polling minimum telah dimodifikasi untuk mengurangi jumlah panggilan API yang dilakukan pengemudi ke Athena. Penyelesaian kueri masih terdeteksi sesegera mungkin.
+ **Penemuan alat BI — Pengemudi** telah dibuat lebih mudah ditemukan untuk alat intelijen bisnis.
+ **Pemetaan tipe data** — Pemetaan tipe data ke Athena`binary`,`array`, dan tipe data `struct` DDL telah ditingkatkan.
+ AWS Versi **SDK — Versi** AWS SDK yang digunakan dalam driver telah diperbarui ke 2.25.34.

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-02-26-fixes"></a>
+ **Daftar tabel katalog federasi** - Memperbaiki masalah yang menyebabkan katalog federasi mengembalikan daftar tabel kosong.
+ **getSchemas** — Memperbaiki masalah yang menyebabkan metode JDBC [DatabaseMetaData\$1getSchemas](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getSchemas--) mengambil database hanya dari katalog default, bukan dari semua katalog.
+ **getColumns** — Memperbaiki masalah yang menyebabkan katalog null dikembalikan saat metode JDBC [DatabaseMetaData\$1getColumns](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getColumns-java.lang.String-java.lang.String-java.lang.String-java.lang.String-) dipanggil dengan nama katalog null.

## 3.1.0
<a name="jdbc-v3-driver-release-notes-2024-02-15"></a>

Dirilis 2024-02-15

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-02-15-improvements"></a>
+ Support ditambahkan untuk Microsoft Active Directory Federation Services (AD FS) Windows Integrated Authentication dan otentikasi berbasis formulir.
+ Untuk kompatibilitas mundur dengan versi 2.x, sub-protokol `awsathena` JDBC sekarang diterima tetapi menghasilkan peringatan penghentian. Gunakan sub-protokol `athena` JDBC sebagai gantinya.
+ `AwsDataCatalog`sekarang default untuk parameter katalog, dan `default` merupakan default untuk parameter database. Perubahan ini memastikan bahwa nilai yang benar untuk katalog dan database saat ini dikembalikan, bukan null.
+ Sesuai dengan spesifikasi JDBC, `IS_AUTOINCREMENT` dan `IS_GENERATEDCOLUMN` sekarang kembalikan string kosong, bukan. `NO`
+ Tipe `int` data Athena sekarang memetakan ke tipe JDBC yang sama dengan Athena, bukan ke. `integer` `other`
+ Ketika metadata kolom dari Athena tidak berisi opsional `precision` dan `scale` bidang, driver sekarang mengembalikan nol untuk nilai yang sesuai dalam kolom. `ResultSet`
+ Versi AWS SDK telah diperbarui ke 2.21.39.

### Perbaikan
<a name="jdbc-v3-driver-release-notes-2024-02-15-fixes"></a>
+ Memperbaiki masalah `GetQueryResultsStream` yang menyebabkan pengecualian terjadi ketika hasil teks biasa dari Athena memiliki jumlah kolom yang tidak konsisten dengan jumlah kolom di metadata hasil Athena.

## 3.0.0
<a name="jdbc-v3-driver-release-notes-2023-11-16"></a>

Dirilis 2023-11-16

Driver Athena JDBC 3.x adalah driver generasi baru yang menawarkan kinerja dan kompatibilitas yang lebih baik. Driver JDBC 3.x mendukung pembacaan hasil kueri langsung dari Amazon S3, yang meningkatkan kinerja aplikasi yang mengkonsumsi hasil kueri besar. Driver baru ini juga memiliki lebih sedikit dependensi pihak ketiga, yang membuat integrasi dengan alat BI dan aplikasi khusus lebih mudah.

# Versi sebelumnya dari driver Athena JDBC 3.x
<a name="jdbc-v3-driver-previous-versions"></a>

Kami sangat menyarankan agar Anda menggunakan [versi terbaru dari driver](jdbc-v3-driver.md) JDBC 3.x. Versi terbaru dari driver berisi perbaikan dan perbaikan terbaru. Gunakan versi yang lebih lama hanya jika aplikasi Anda mengalami ketidakcocokan dengan versi terbaru.

## Toples uber driver JDBC
<a name="jdbc-v3-driver-download-uber-jar-previous"></a>

Unduhan berikut mengemas driver dan semua dependensinya dalam file yang sama`.jar`. Unduhan ini biasanya digunakan untuk klien SQL pihak ketiga.
+ [https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-with-dependencies.jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-with-dependencies.jar)
+ [3.5.1 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.1/athena-jdbc-3.5.1-with-dependencies.jar) uber
+ [3.5.0 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.0/athena-jdbc-3.5.0-with-dependencies.jar) uber
+ [3.4.0 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.4.0/athena-jdbc-3.4.0-with-dependencies.jar) uber
+ [3.3.0 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.3.0/athena-jdbc-3.3.0-with-dependencies.jar) uber
+ [3.2.2 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.2/athena-jdbc-3.2.2-with-dependencies.jar) uber
+ [3.2.1 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.1/athena-jdbc-3.2.1-with-dependencies.jar) uber
+ [3.2.0 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-with-dependencies.jar) uber
+ [3.1.0 toples uber toples](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-with-dependencies.jar) uber
+ [https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-with-dependencies.jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-with-dependencies.jar)

## Toples ramping driver JDBC
<a name="jdbc-v3-driver-download-lean-jar"></a>

Download berikut adalah `.zip` file yang berisi lean `.jar` untuk driver dan `.jar` file terpisah untuk dependensi driver. Download ini biasanya digunakan untuk aplikasi kustom yang mungkin memiliki dependensi yang bertentangan dengan dependensi yang digunakan driver. Unduhan ini berguna jika Anda ingin memilih dependensi driver mana yang akan disertakan dengan lean jar, dan mana yang harus dikecualikan jika aplikasi khusus Anda sudah berisi satu atau lebih dari mereka.
+ [https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-lean-jar-and-separate-dependencies-jars.zip](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.5.1 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.1/athena-jdbc-3.5.1-lean-jar-and-separate-dependencies-jars.zip)
+ [3.5.0 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.0/athena-jdbc-3.5.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.4.0 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.4.0/athena-jdbc-3.4.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.3.0 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.3.0/athena-jdbc-3.3.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.2 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.2/athena-jdbc-3.2.2-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.1 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.1/athena-jdbc-3.2.1-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.0 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.1.0 toples tanpa lemak toples tanpa lemak](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-lean-jar-and-separate-dependencies-jars.zip)
+ [https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-lean-jar-and-separate-dependencies-jars.zip](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-lean-jar-and-separate-dependencies-jars.zip)