Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Opsi lanjutan
Mengambil ukuran
Jumlah maksimum hasil (baris) untuk dikembalikan dalam permintaan ini. Untuk informasi parameter, lihat GetQuery MaxResults. Untuk API streaming, nilai maksimumnya adalah 10000000.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| RowsToFetchPerBlock | Opsional |
|
RowsToFetchPerBlock=20000; |
Pengambil hasil
Pengambil hasil default mengunduh hasil kueri langsung dari Amazon S3 tanpa melalui operasi Athena API. Ketika mendeteksi situasi di mana pengunduhan S3 langsung tidak memungkinkan, secara otomatis akan kembali menggunakan operasi GetQueryResultsStream API. Misalnya, ini terjadi ketika hasil kueri dienkripsi dengan CSE_KMS opsi.
Menggunakan auto fetcher direkomendasikan dalam sebagian besar situasi. Namun, jika kebijakan IAM Anda, atau kebijakan bucket S3 menggunakan s3:CalledVia kondisi untuk membatasi akses ke objek S3 untuk permintaan dari Athena, pengambil otomatis pertama-tama mencoba mengunduh hasil dari S3 dan kemudian kembali menggunakan. GetQueryResultsStream Dalam situasi ini, Anda mungkin ingin menyet ResultFetcher el GetQueryResultsStream ke untuk menghindari panggilan API tambahan.
catatan
Driver masih mengenali parameter Enable streaming API (UseResultsetStreaming=1;) dan Enable S3 fetcher (EnableS3Fetcher=1;). Namun, kami mendorong Anda untuk menggunakan ResultFetcher parameter untuk pengalaman yang lebih baik.
| Nama string koneksi | Jenis parameter | Nilai default | Nilai yang mungkin | Contoh string koneksi |
|---|---|---|---|---|
|
ResultFetcher |
Opsional | auto |
auto, S3, GetQueryResults,
GetQueryResultsStream |
ResultFetcher=auto |
Aktifkan penggunaan kembali hasil
Menentukan apakah hasil kueri sebelumnya dapat digunakan kembali saat kueri dijalankan. Untuk informasi parameter, lihat ResultReuseByAgeConfiguration.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| EnableResultReuse | Opsional | 0 |
EnableResultReuse=1; |
Hasil penggunaan kembali usia maksimum
Menentukan, dalam hitungan menit, usia maksimum hasil kueri sebelumnya yang harus dipertimbangkan Athena untuk digunakan kembali. Untuk informasi parameter, lihat ResultReuseByAgeConfiguration.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| ReusedResultMaxAgeInMinutes | Opsional | 60 |
ReusedResultMaxAgeInMinutes=90; |
Gunakan beberapa utas S3
Mengambil data dari Amazon S3 menggunakan beberapa utas. Ketika opsi ini diaktifkan, file hasil yang disimpan di bucket Amazon S3 diambil secara paralel menggunakan beberapa utas.
Aktifkan opsi ini hanya jika Anda memiliki bandwidth jaringan yang baik. Misalnya, dalam pengukuran kami pada instance EC2
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
|
UseMultipleS3Threads |
Opsional | 0 |
UseMultipleS3Threads=1; |
Gunakan katalog dan skema tunggal
Secara default, driver ODBC menanyakan Athena untuk mendapatkan daftar katalog dan skema yang tersedia. Opsi ini memaksa driver untuk menggunakan katalog dan skema yang ditentukan oleh kotak dialog konfigurasi Administrator Sumber Data ODBC atau parameter koneksi.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| UseSingleCatalogAndSchema | Opsional | 0 |
UseSingleCatalogAndSchema=1; |
Gunakan kueri untuk daftar tabel
Untuk jenis LAMBDA katalog, aktifkan driver ODBC untuk mengirimkan ku SHOW TABLES eri untuk mendapatkan daftar tabel yang tersedia. Ini adalah pengaturan default. Jika parameter ini disetel ke 0, driver ODBC menggunakan Athena ListTableMetadata API untuk mendapatkan daftar tabel yang tersedia. Perhatikan bahwa, untuk jenis LAMBDA katalog, menggunakan ListTableMetadata mengarah ke regresi kinerja.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| UseQueryToListTables | Opsional | 1 |
UseQueryToListTables=1; |
Gunakan WCHAR untuk jenis string
Secara default, driver ODBC menggunakan SQL_CHAR dan SQL_VARCHAR untuk Athena tipe data stringchar,,,varchar,string, array map<>struct<>, dan. row Mengatur parameter ini untuk 1 memaksa driver menggunakan SQL_WCHAR dan SQL_WVARCHAR untuk tipe data string. Karakter lebar dan tipe karakter variabel lebar digunakan untuk memastikan bahwa karakter dari bahasa yang berbeda dapat disimpan dan diambil dengan benar.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| UseWCharForStringTypes | Opsional | 0 |
UseWCharForStringTypes=1; |
Kueri katalog eksternal
Menentukan apakah driver perlu menanyakan katalog eksternal dari Athena. Untuk informasi selengkapnya, lihat Migrasi ke driver ODBC 2.x.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| QueryExternalCatalogs | Opsional | 0 |
QueryExternalCatalogs=1; |
Verifikasi SSL
Mengontrol apakah akan memverifikasi sertifikat SSL saat Anda menggunakan AWS SDK. Nilai ini diteruskan ke ClientConfiguration.verifySSL parameter. Untuk informasi selengkapnya, lihat Konfigurasi AWS klien di Panduan AWS SDK untuk C++ Pengembang.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| VerifikasiSSL | Opsional | 1 |
VerifySSL=0; |
Ukuran blok hasil S3
Menentukan, dalam byte, ukuran blok yang akan diunduh untuk permintaan GetObject API Amazon S3 tunggal. Nilai defaultnya adalah 67108864 (64 MB). Nilai minimum dan maksimum yang diizinkan adalah 10485760 (10 MB) dan 2146435072 (sekitar 2 GB).
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| S3ResultBlockSize | Opsional | 67108864 |
S3ResultBlockSize=268435456; |
Panjang kolom string
Menentukan panjang kolom untuk kolom dengan tipe string data. Karena Athena menggunakan tipe data string Apache HiveINT_MAX Karena alat BI biasanya pra-mengalokasikan memori untuk kolom, ini dapat menyebabkan konsumsi memori yang tinggi. Untuk menghindari hal ini, driver Athena ODBC membatasi presisi yang dilaporkan untuk kolom tipe string data dan memperlihatkan parameter StringColumnLength koneksi sehingga nilai default dapat diubah.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| StringColumnLength | Opsional | 255 | StringColumnLength=65535; |
Panjang kolom tipe kompleks
Menentukan panjang kolom untuk kolom dengan tipe data kompleks sepertimap,struct, danarray. Seperti StringColumnLength, Athena melaporkan presisi 0 untuk kolom dengan tipe data yang kompleks. Driver Athena ODBC menetapkan presisi default untuk kolom dengan tipe data kompleks dan memperlihatkan parameter ComplexTypeColumnLength koneksi sehingga nilai default dapat diubah.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| ComplexTypeColumnLength | Opsional | 65535 | ComplexTypeColumnLength=123456; |
Sertifikat CA tepercaya
Menginstruksikan klien HTTP di mana menemukan penyimpanan kepercayaan sertifikat SSL Anda. Nilai ini diteruskan ke ClientConfiguration.caFile parameter. Untuk informasi selengkapnya, lihat Konfigurasi AWS klien di Panduan AWS SDK untuk C++ Pengembang.
Dimulai dengan driver versi 2.3.0.0, perilaku khusus platform berikut berlaku:
-
Pada Windows, driver memverifikasi sertifikat SSL terhadap penyimpanan sertifikat sistem Windows dan tidak menggunakan parameter ini. Untuk menggunakan otoritas sertifikat pribadi (CA), impor sertifikat CA ke penyimpanan sertifikat Windows.
-
Di Linux, jika Anda tidak mengatur parameter ini, driver akan menemukan bundel CA saat runtime dengan memeriksa variabel
SSL_CERT_FILElingkunganCURL_CA_BUNDLEdan kemudian satu set jalur sistem yang terkenal. Untuk menggunakan CA pribadi, atur parameter ini atau salah satu variabel lingkungan ke jalur bundel CA Anda. -
Di macOS, driver menggunakan file penyimpanan kepercayaan yang Anda tentukan dalam parameter ini. Jika Anda tidak menyetelnya, verifikasi sertifikat menggunakan penyimpanan kepercayaan default library curl sistem.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| TrustedCerts | Opsional | Windows: penyimpanan sertifikat sistem; Linux: bundel CA yang terdeteksi secara otomatis; macOS: penyimpanan kepercayaan default curl | TrustedCerts=/etc/ssl/certs/cacert.pem; |
Periode polling min
Menentukan nilai minimum dalam milidetik untuk menunggu sebelum melakukan polling Athena untuk status eksekusi kueri.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| MinQueryExecutionPollingInterval | Opsional | 100 |
MinQueryExecutionPollingInterval=200; |
Periode jajak pendapat maksimal
Menentukan nilai maksimum dalam milidetik untuk menunggu sebelum melakukan polling Athena untuk status eksekusi kueri.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| MaxQueryExecutionPollingInterval | Opsional | 60000 |
MaxQueryExecutionPollingInterval=1000; |
Pengganda jajak pendapat
Menentukan faktor untuk meningkatkan periode polling. Secara default, polling dimulai dengan nilai periode polling min dan berlipat ganda dengan setiap jajak pendapat hingga mencapai nilai periode polling maksimum.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| QueryExecutionPollingIntervalMultiplier | Opsional | 2 |
QueryExecutionPollingIntervalMultiplier=2; |
Durasi polling maksimal
Menentukan nilai maksimum dalam milidetik agar pengemudi dapat melakukan polling Athena untuk status eksekusi kueri.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| MaxPollDuration | Opsional | 1800000 |
MaxPollDuration=1800000; |
Batas waktu koneksi
Jumlah waktu (dalam milidetik) koneksi HTTP menunggu untuk membuat koneksi. Nilai ini ditetapkan untuk klien ClientConfiguration.connectTimeoutMs Athena. Jika tidak ditentukan, nilai default curl digunakan. Untuk informasi tentang parameter koneksi, lihat Konfigurasi Kli en di Panduan AWS SDK untuk Java Pengembang.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| ConnectionTimeout | Opsional | 0 |
ConnectionTimeout=2000; |
Batas waktu permintaan
Menentukan batas waktu baca soket untuk klien HTTP. Nilai ini diatur untuk ClientConfiguration.requestTimeoutMs parameter klien Athena. Untuk informasi parameter, lihat Konfigur asi Klien di Panduan AWS SDK untuk Java Pengembang.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| RequestTimeout | Opsional | 10000 |
RequestTimeout=30000; |
