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

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