Parameter koneksi lanjutan - Amazon Athena
Parameter enkripsi hasilParameter pengambilan hasilParameter konfigurasi hasilParameter penggunaan kembali hasil kueriParameter polling eksekusi kueriParameter penggantian titik akhirParameter konfigurasi proxyParameter pencatatanNama aplikasiTes koneksiJumlah percobaanBatas waktu jaringan

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

Parameter koneksi lanjutan

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

Parameter enkripsi hasil

Perhatikan bidang berikut:

  • AWS KMS Kunci harus EncryptionOption ditentukan kapan SSE_KMS atauCSE_KMS.

  • AWS KMS Kunci tidak dapat EncryptionOption ditentukan kapan tidak ditentukan atau kapan EncryptionOptionSSE_S3.

Opsi enkripsi

Jenis enkripsi yang akan digunakan untuk hasil kueri karena disimpan di Amazon S3. Untuk informasi tentang enkripsi hasil kueri, lihat EncryptionConfigurationdi Referensi API Amazon Athena.

Nama parameter Alias Jenis parameter Nilai default Kemungkinan nilai
EncryptionOption S3 OutputEncOption (usang) Opsional none SSE_S3, SSE_KMS, CSE_KMS

Kunci KMS

Kunci KMS ARN atau ID, SSE_KMS jika CSE_KMS atau dipilih sebagai opsi enkripsi. Untuk informasi selengkapnya, lihat EncryptionConfigurationdi Referensi API Amazon Athena.

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

Parameter pengambilan hasil

Pengambil hasil

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

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

  • GetQueryResultsPengambil 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.

  • GetQueryResultsStreamPengambil akan menggunakan ukuran pengambilan yang dikonfigurasi sebagai ukuran halaman, atau 10.000 secara default.

  • S3Pengambil akan menggunakan ukuran pengambilan yang dikonfigurasi sebagai ukuran halaman, atau 10.000 secara default.

Parameter konfigurasi hasil

Pemilik ember yang diharapkan

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.

Nama parameter Alias Jenis parameter Nilai default
ExpectedBucketOwner none Opsional none

Opsi Acl

Menunjukkan bahwa ACL kalengan Amazon S3 harus disetel untuk mengontrol kepemilikan hasil kueri yang disimpan. Untuk informasi selengkapnya tentang AclOption, lihat AclConfiguration.

Nama parameter Alias Jenis parameter Nilai default Kemungkinan nilai
AclOption none Opsional none BUCKET_OWNER_FULL_CONTROL

Parameter penggunaan kembali hasil kueri

Aktifkan penggunaan kembali hasil

Menentukan apakah hasil sebelumnya untuk query yang sama dapat digunakan kembali ketika query dijalankan. Untuk informasi tentang penggunaan kembali hasil kueri, lihat ResultReuseByAgeConfiguration.

Nama parameter Alias Jenis parameter Nilai default
EnableResultReuseByAge none Opsional SALAH

Hasil penggunaan kembali usia maks

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.

Nama parameter Alias Jenis parameter Nilai default
MaxResultReuseAgeInMinutes none Opsional 60

Parameter polling eksekusi kueri

Interval polling eksekusi kueri minimum

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

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

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

Nama parameter Alias Jenis parameter Nilai default
QueryExecutionPollingIntervalMultiplier none Opsional 2

Parameter penggantian titik akhir

Pengesampingan titik akhir Athena

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

Perhatikan bidang 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

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

Perhatikan bidang 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

Endpoint yang akan digunakan driver untuk layanan Lake Formation saat menggunakan AWS Lake Formation AssumeDecoratedRoleWithSAMP API untuk mengambil kredensi sementara. Jika parameter ini tidak ditentukan, driver menggunakan endpoint Lake Formation default.

Perhatikan bidang 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

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

Titik akhir yang akan digunakan driver untuk AWS STS layanan saat menggunakan AWS STS AssumeRoleWithSAMP API untuk mengambil kredensi sementara. Jika parameter ini tidak ditentukan, driver menggunakan AWS STS endpoint default.

Perhatikan bidang 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

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.

Nama parameter Alias Jenis parameter Nilai default
SSOOIDCEndpointMengesampingkan Opsional none

Pengesampingan titik akhir Admin SSO

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.

Nama parameter Alias Jenis parameter Nilai default
SSOAdminEndpointOverride Opsional none

Parameter konfigurasi proxy

Tuan rumah proxy

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

Nama parameter Alias Jenis parameter Nilai default
ProxyHost none Opsional none

Port proxy

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

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 (tidak digunakan lagi) Opsional none

Kata sandi proxy

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

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

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

Nama parameter Alias Jenis parameter Nilai default
ProxyEnabledForIdP UseProxyForIdP Opsional SALAH

Parameter pencatatan

Bagian ini menjelaskan parameter yang terkait dengan logging.

Tingkat log

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

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

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

Jika disetel keTRUE, 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.

Jumlah percobaan

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

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