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

# Opsi lanjutan
<a name="odbc-v2-driver-advanced-options"></a>

## Ambil ukuran
<a name="odbc-v2-driver-advanced-options-fetch-size"></a>

Jumlah maksimum hasil (baris) untuk kembali dalam permintaan ini. Untuk informasi parameter, lihat [GetQuery MaxResults](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetQueryResults.html#athena-GetQueryResults-request-MaxResults). Untuk API streaming, nilai maksimumnya adalah 10000000.


****  

| **Nama string koneksi** | **Jenis parameter** | **Nilai default** | **Contoh string koneksi** | 
| --- | --- | --- | --- | 
| RowsToFetchPerBlock | Opsional | `1000`untuk non-streaming<br />`20000`untuk streaming | RowsToFetchPerBlock=20000; | 

## Pengambil hasil
<a name="odbc-v2-driver-advanced-options-result-fetcher"></a>

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
<a name="odbc-v2-driver-advanced-options-enable-result-reuse"></a>

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
<a name="odbc-v2-driver-advanced-options-result-reuse-max-age"></a>

Menentukan, dalam hitungan menit, usia maksimum hasil query sebelumnya yang Athena harus mempertimbangkan untuk digunakan kembali. Untuk informasi parameter, lihat [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| **Nama string koneksi** | **Jenis parameter** | **Nilai default** | **Contoh string koneksi** | 
| --- | --- | --- | --- | 
| ReusedResultMaxAgeInMinutes | Opsional | 60 | ReusedResultMaxAgeInMinutes=90; | 

## Gunakan beberapa utas S3
<a name="odbc-v2-driver-advanced-options-use-multiple-s3-threads"></a>

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](https://aws.amazon.com/ec2/instance-types/c5/), 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
<a name="odbc-v2-driver-advanced-options-use-single-catalog-and-schema"></a>

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
<a name="odbc-v2-driver-advanced-options-use-query-to-list-tables"></a>

Untuk jenis `LAMBDA` katalog, memungkinkan driver ODBC mengirimkan [SHOW TABLES](show-tables.md) kueri untuk mendapatkan daftar tabel yang tersedia. Ini adalah pengaturan default. Jika parameter ini disetel ke 0, driver ODBC menggunakan [ListTableMetadata](https://docs.aws.amazon.com/athena/latest/APIReference/API_ListTableMetadata.html)Athena 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
<a name="odbc-v2-driver-advanced-options-use-wchar-for-string-types"></a>

Secara default, driver ODBC menggunakan `SQL_CHAR` dan `SQL_VARCHAR` untuk Athena `char` tipe data string`varchar`,,,`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
<a name="odbc-v2-driver-query-advanced-options-external-catalogs"></a>

Menentukan apakah driver perlu query katalog eksternal dari Athena. Untuk informasi selengkapnya, lihat [Migrasi ke driver ODBC 2.x](odbc-v2-driver-migrating.md).


****  

| **Nama string koneksi** | **Jenis parameter** | **Nilai default** | **Contoh string koneksi** | 
| --- | --- | --- | --- | 
| QueryExternalCatalogs | Opsional | 0 | QueryExternalCatalogs=1; | 

## Verifikasi SSL
<a name="odbc-v2-driver-advanced-options-verify-ssl"></a>

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](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html) 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
<a name="odbc-v2-driver-advanced-options-s3-result-block-size"></a>

Menentukan, dalam byte, ukuran blok yang akan diunduh untuk satu permintaan API Amazon [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)S3. 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
<a name="odbc-v2-driver-advanced-options-string-column-length"></a>

Menentukan panjang kolom untuk kolom dengan tipe `string` data. Karena Athena menggunakan [tipe data string Apache Hive](https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Types#LanguageManualTypes-StringsstringStrings), 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
<a name="odbc-v2-driver-advanced-options-complex-type-column-length"></a>

Menentukan panjang kolom untuk kolom dengan tipe data yang kompleks seperti`map`,`struct`, dan`array`. Seperti [StringColumnLength](#odbc-v2-driver-advanced-options-string-column-length), 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
<a name="odbc-v2-driver-advanced-options-trusted-ca-certificate"></a>

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](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html) 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
<a name="odbc-v2-driver-advanced-options-min-poll-period"></a>

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
<a name="odbc-v2-driver-advanced-options-max-poll-period"></a>

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
<a name="odbc-v2-driver-advanced-options-poll-multiplier"></a>

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
<a name="odbc-v2-driver-advanced-options-max-poll-duration"></a>

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
<a name="odbc-v2-driver-advanced-options-connection-timeout"></a>

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](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/section-client-configuration.html) di *Panduan AWS SDK untuk Java Pengembang*.


****  

| **Nama string koneksi** | **Jenis parameter** | **Nilai default** | **Contoh string koneksi** | 
| --- | --- | --- | --- | 
| ConnectionTimeout | Opsional | 0 | ConnectionTimeout=2000; | 

## Permintaan waktu habis
<a name="odbc-v2-driver-advanced-options-request-timeout"></a>

Menentukan batas waktu baca soket untuk klien HTTP. Nilai ini ditetapkan untuk `ClientConfiguration.requestTimeoutMs` parameter klien Athena. Untuk informasi parameter, lihat [Konfigurasi Klien](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/section-client-configuration.html) di *Panduan AWS SDK untuk Java Pengembang*.


****  

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