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	1000untuk non-streaming 20000untuk streaming	RowsToFetchPerBlock=20000;

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;

Aktifkan API streaming

Memilih apakah akan menggunakan API streaming Athena untuk mengambil set hasil.

Nama string koneksi	Jenis parameter	Nilai default	Contoh string koneksi
UseResultsetStreaming	Opsional	0	UseResultsetStreaming=1;

Aktifkan S3 fetcher

Mengambil set hasil yang dihasilkan oleh Athena dari bucket Amazon S3 dengan berinteraksi langsung dengan Amazon S3.

Nama string koneksi	Jenis parameter	Nilai default	Contoh string koneksi
Aktifkan3Fetcher	Opsional	1	EnableS3Fetcher=1;

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, klien S3 single-threaded mencapai 1 Gbps, sementara klien S3 multi-threaded mencapai 4 Gbps throughput jaringan.

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
UseW CharForStringTypes	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 for 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 Hive, yang tidak memiliki presisi yang ditentukan, panjang default yang dilaporkan oleh Athena adalah 2147483647 (). INT_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 for 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 for 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 for Java Pengembang.

Nama string koneksi	Jenis parameter	Nilai default	Contoh string koneksi
RequestTimeout	Opsional	10000	RequestTimeout=30000;