Menyambungkan ke Azure Data Explorer dengan ODBC

  • Artikel

Open Database Connectivity (ODBC) adalah antarmuka pemrograman aplikasi (API) yang diterima secara luas untuk akses database. Azure Data Explorer kompatibel dengan subset protokol komunikasi SQL Server (MS-TDS). Kompatibilitas ini memungkinkan penggunaan driver ODBC untuk SQL Server dengan Azure Data Explorer.

Akibatnya, Anda dapat membuat koneksi ke Azure Data Explorer dari aplikasi apa pun yang dilengkapi dengan dukungan untuk driver ODBC untuk SQL Server.

Tonton video berikut untuk mempelajari cara membuat koneksi ODBC.

Atau, ikuti langkah-langkah untuk mengonfigurasi sumber data ODBC.

Catatan

Sebaiknya gunakan konektor khusus untuk Azure Data Explorer jika memungkinkan. Untuk daftar konektor yang tersedia, lihat Gambaran umum konektor.

Prasyarat

Mengonfigurasi sumber data ODBC

Untuk mengonfigurasi sumber data ODBC menggunakan driver ODBC untuk SQL Server:

  1. Di Windows, cari Sumber Data ODBC, dan buka aplikasi desktop Sumber Data ODBC.

  2. Pilih Tambahkan.

    Tambahkan sumber data.

  3. Pilih ODBC Driver 17 untuk SQL Server lalu Selesai.

    Pilih driver.

  4. Masukkan nama dan deskripsi untuk koneksi dan kluster yang ingin Anda sambungkan, lalu pilih Berikutnya. URL kluster harus dalam bentuk <ClusterName>.<Region.kusto.windows.net>.

    Catatan

    Saat memasukkan URL kluster, jangan sertakan awalan "https://".

    Pilih server.

  5. Pilih Direktori Aktif Terintegrasi lalu Berikutnya.

    Direktori Aktif Terintegrasi.

  6. Pilih database dengan data sampel lalu Berikutnya.

    Ubah database default.

  7. Pada layar berikutnya, biarkan semua opsi sebagai default lalu pilih Selesai.

  8. Pilih Uji Sumber Data.

    Menguji sumber data.

  9. Verifikasi bahwa pengujian berhasil lalu pilih OK. Jika pengujian tidak berhasil, periksa nilai yang Anda tentukan di langkah sebelumnya, dan pastikan Anda memiliki izin yang memadai untuk menyambungkan ke kluster.

    Pengujian berhasil.

Menggunakan sumber data ODBC

Dari aplikasi yang mendukung koneksi ODBC, Anda dapat tersambung ke Azure Data Explorer dengan string koneksi format berikut:

"Driver={ODBC Driver 17 for SQL Server};Server=mykustocluster.kusto.windows.net;Database=mykustodatabase;Authentication=ActiveDirectoryIntegrated"

Catatan

Azure Data Explorer mempertimbangkan nilai string sebagai NVARCHAR(MAX), yang mungkin tidak berfungsi dengan baik dengan beberapa aplikasi ODBC. Transmisikan data ke NVARCHAR(n) menggunakan Language parameter di string koneksi. Misalnya, Language=any@MaxStringSize:5000 akan mengodekan string sebagai NVARCHAR(5000). Untuk informasi selengkapnya, lihat opsi penyetelan.

Autentikasi aplikasi

Untuk menggunakan autentikasi utama aplikasi dengan ODBC, Anda harus memberikan ID penyewa Microsoft Entra. Anda dapat mengatur konfigurasi ini di string koneksi, registri Windows, atau file odbc.ini. Lihat contoh di tab berikut. Untuk informasi selengkapnya, lihat opsi penyetelan.

Atur perwakilan aplikasi dengan Language=any@AadAuthority:<aad_tenant_id> di string koneksi. Ganti <aad_tenant_id>, <aad_application_id>, dan <aad_application_secret> dengan ID penyewa Microsoft Entra, ID aplikasi Microsoft Entra, dan rahasia aplikasi Microsoft Entra masing-masing.

"Driver={ODBC Driver 17 for SQL Server};Server=<adx_cluster_name>.<region_name>.kusto.windows.net;Database=<adx_database_name>;Authentication=ActiveDirectoryServicePrincipal;Language=any@AadAuthority:<aad_tenant_id>;UID=<aad_application_id>;PWD=<aad_application_secret>"

Konten terkait