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

# Migrasi ke driver ODBC 2.x
<a name="odbc-v2-driver-migrating"></a>

Karena sebagian besar parameter koneksi Athena ODBC 2.x kompatibel dengan driver ODBC 1.x, Anda dapat menggunakan kembali sebagian besar string koneksi yang ada dengan driver Athena ODBC 2.x. Namun, parameter koneksi berikut memerlukan modifikasi.

## Tingkat log
<a name="odbc-v2-driver-migrating-log-level"></a>

Sementara driver ODBC saat ini menyediakan berbagai opsi logging yang tersedia, mulai dari `LOG_OFF (0)` hingga`LOG_TRACE (6)`, driver Amazon Athena ODBC 2.x awalnya hanya memiliki dua nilai: 0 (dinonaktifkan) dan 1 (diaktifkan). Dimulai dengan versi 2.0.6.0, driver sekarang mendukung lebih banyak level logging granular dengan kemampuan logging yang ditingkatkan:
+ `OFF`- Logging dinonaktifkan
+ `ERROR`- Hanya pesan kesalahan yang dicatat
+ `WARN`- Pesan peringatan dan kesalahan dicatat
+ `INFO`- Pesan informasi, peringatan, dan kesalahan dicatat
+ `DEBUG`- Informasi debug terperinci ditambah semua pesan tingkat bawah dicatat
+ `TRACE`- Tingkat logging yang paling rinci, termasuk semua pesan

Untuk informasi selengkapnya tentang mencatat driver ODBC 2.x, lihat. [Opsi pencatatan](odbc-v2-driver-logging-options.md)


****  

|  | Pengemudi ODBC 1.x | Pengemudi ODBC 2.x | 
| --- | --- | --- | 
| Nama string koneksi | LogLevel | LogLevel | 
| Jenis parameter | Opsional | Opsional | 
| Nilai default | 0 | OFF | 
| Nilai yang mungkin | 0-6 | Untuk versi sebelum 2.0.6.0: `0,1`<br />Untuk versi 2.0.6.0 dan yang lebih baru:`OFF`,,,,`ERROR`, `WARN` `INFO` `DEBUG` `TRACE` | 
| Contoh string koneksi | LogLevel=6; | LogLevel=INFO; | 

**catatan**  
Dalam versi 2.0.6.0 dan yang lebih baru, kerangka logging telah dioptimalkan untuk mengurangi penundaan operasional dan pembuatan file log yang berlebihan, sambil memberikan informasi diagnostik yang lebih rinci melalui tingkat log granular ini. Setiap level mencakup semua pesan dari level di bawahnya.

## MetadataRetrievalMethod
<a name="odbc-v2-driver-migrating-metadataretrievalmethod"></a>

Driver ODBC saat ini menyediakan beberapa opsi untuk mengambil metadata dari Athena. Driver ODBC Amazon Athena menghentikan dan selalu `MetadataRetrievalMethod` menggunakan Amazon Athena API untuk mengekstrak metadata.

Athena memperkenalkan bendera `QueryExternalCatalogs` untuk menanyakan katalog eksternal. Untuk menanyakan katalog eksternal dengan driver ODBC saat ini, setel ke. `MetadataRetrievalMethod` `ProxyAPI` Untuk menanyakan katalog eksternal dengan driver Athena ODBC, setel ke. `QueryExternalCatalogs` `1`


****  

|  | Pengemudi ODBC 1.x | Pengemudi ODBC 2.x | 
| --- | --- | --- | 
| Nama string koneksi | MetadataRetrievalMethod | QueryExternalCatalogs | 
| Jenis parameter | Opsional | Opsional | 
| Nilai default | Auto | 0 | 
| Nilai yang mungkin | Auto, AWS Glue, ProxyAPI, Query | 0,1 | 
| Contoh string koneksi | MetadataRetrievalMethod=ProxyAPI; | QueryExternalCatalogs=1; | 

## Tes koneksi
<a name="odbc-v2-driver-migrating-connection-test"></a>

Saat Anda menguji koneksi driver ODBC 1.x, driver menjalankan `SELECT 1` kueri yang menghasilkan dua file di bucket Amazon S3 Anda: satu untuk set hasil, dan satu untuk metadata. Koneksi pengujian dibebankan sesuai dengan kebijakan [Harga Amazon Athena](https://aws.amazon.com/athena/pricing/).

Saat Anda menguji koneksi driver ODBC 2.x, driver akan memanggil aksi [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html)Athena API. Panggilan menggunakan jenis otentikasi dan penyedia kredensi terkait yang Anda tentukan untuk mengambil kredensialnya. Tidak ada biaya untuk pengujian koneksi saat Anda menggunakan driver ODBC 2.x, dan pengujian tidak menghasilkan hasil kueri di bucket Amazon S3 Anda.