Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Opsi lanjutan
Ambil ukuran
Jumlah maksimum hasil (baris) untuk kembali 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 unduhan S3 langsung tidak dimungkinkan, secara otomatis akan kembali menggunakan operasi GetQueryResultsStream API. Misalnya, ini terjadi ketika hasil kueri dienkripsi dengan opsi. CSE_KMS
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 ke permintaan dari Athena, auto fetcher pertama-tama mencoba mengunduh hasil dari S3 dan kemudian kembali menggunakan. GetQueryResultsStream Dalam situasi ini, Anda mungkin ingin mengatur ResultFetcher to GetQueryResultsStream 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 query sebelumnya dapat digunakan kembali ketika query 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 query sebelumnya yang Athena harus mempertimbangkan 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. Saat 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 c5.2xlarge
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
|
UseMultipleBenang S3 |
Opsional | 0 |
UseMultipleS3Threads=1; |
Gunakan katalog dan skema tunggal
Secara default, driver ODBC meminta Athena untuk mendapatkan daftar katalog dan skema yang tersedia. Opsi ini memaksa pengemudi 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, memungkinkan driver ODBC mengirimkan SHOW TABLES kueri untuk mendapatkan daftar tabel yang tersedia. Ini adalah pengaturan default. Jika parameter ini disetel ke 0, driver ODBC menggunakan ListTableMetadataAthena API untuk mendapatkan daftar tabel yang tersedia. Perhatikan bahwa, untuk jenis LAMBDA katalog, menggunakan ListTableMetadata lead ke regresi kinerja.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| UseQueryToListTables | Opsional | 1 |
UseQueryToListTables=1; |
Gunakan WCHAR untuk tipe string
Secara default, driver ODBC menggunakan SQL_CHAR dan SQL_VARCHAR untuk Athena char tipe data stringvarchar,,,string, array map<>struct<>, dan. row Mengatur parameter ini untuk 1 memaksa driver untuk menggunakan SQL_WCHAR dan SQL_WVARCHAR untuk tipe data string. Karakter lebar dan tipe karakter variabel lebar digunakan untuk memastikan bahwa karakter dari berbagai bahasa dapat disimpan dan diambil dengan benar.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| Gunakan WChar ForStringTypes | Opsional | 0 |
UseWCharForStringTypes=1; |
Kueri katalog eksternal
Menentukan apakah driver perlu query 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 |
|---|---|---|---|
| VerifySSL | Opsional | 1 |
VerifySSL=0; |
Ukuran blok hasil S3
Menentukan, dalam byte, ukuran blok yang akan diunduh untuk satu permintaan API Amazon GetObjectS3. Nilai default 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 |
|---|---|---|---|
| S3 ResultBlockSize | 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 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 mengekspos 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 yang kompleks sepertimap,struct, danarray. Seperti StringColumnLength, Athena melaporkan 0 presisi untuk kolom dengan tipe data yang kompleks. Driver Athena ODBC menetapkan presisi default untuk kolom dengan tipe data yang kompleks dan mengekspos 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 toko 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.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| TrustedCerts | Opsional | %INSTALL_PATH%/bin |
TrustedCerts=C:\\Program Files\\Amazon Athena ODBC
Driver\\bin\\cacert.pem; |
Periode jajak pendapat min
Menentukan nilai minimum dalam milidetik untuk menunggu sebelum polling Athena untuk status eksekusi query.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| MinQueryExecutionPollingInterval | Opsional | 100 |
MinQueryExecutionPollingInterval=200; |
Periode jajak pendapat maks
Menentukan nilai maksimum dalam milidetik untuk menunggu sebelum polling Athena untuk status eksekusi query.
| 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 polling hingga mencapai nilai periode polling maksimal.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| QueryExecutionPollingIntervalMultiplier | Opsional | 2 |
QueryExecutionPollingIntervalMultiplier=2; |
Durasi jajak pendapat maks
Menentukan nilai maksimum dalam milidetik bahwa pengemudi dapat polling Athena untuk status eksekusi query.
| 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 Klien 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 ditetapkan untuk ClientConfiguration.requestTimeoutMs parameter klien Athena. Untuk informasi parameter, lihat Konfigurasi Klien di Panduan AWS SDK untuk Java Pengembang.
| Nama string koneksi | Jenis parameter | Nilai default | Contoh string koneksi |
|---|---|---|---|
| RequestTimeout | Opsional | 10000 |
RequestTimeout=30000; |
