Bagikan melalui


Mengkueri data di Azure Data Explorer menggunakan emulasi SQL Server

Pustaka dan aplikasi apa pun yang dapat tersambung ke Microsoft Azure SQL Database dengan autentikasi Microsoft Entra juga dapat tersambung ke Azure Data Explorer. Fungsionalitas ini dimungkinkan oleh titik akhir yang mematuhi TDS Azure Data Explorer, yang menimulasi Microsoft SQL Server. Titik akhir mendukung TDS versi 7.x dan 8.0.

Dengan emulasi SQL Server, Anda dapat terhubung ke Azure Data Explorer melalui berbagai metode, termasuk ODBC, JDBC, dan aplikasi umum seperti LINQPad dan Azure Data Studio.

Autentikasi

Azure Data Explorer memerlukan autentikasi melalui ID Microsoft Entra.

Untuk mengautentikasi perwakilan aplikasi, Anda perlu menyertakan ID penyewa dalam opsi penyetelan. Misalnya, lihat menyambungkan dengan ODBC.

Dimungkinkan untuk mengonfigurasi ID penyewa Microsoft Entra di tingkat kluster dan menghapus kebutuhan untuk menentukannya dari klien. Untuk mengubah ID penyewa di tingkat kluster, buka permintaan dukungan di portal Azure tentang mengonfigurasi SecuritySettings.TdsEndpointDefaultAuthority dengan ID penyewa yang diperlukan.

Opsi penyetelan

Untuk menyesuaikan Azure Data Explorer sesuai dengan persyaratan spesifik Anda, Anda mungkin perlu memberikan informasi tertentu yang tidak didukung oleh konfigurasi koneksi SQL Server standar.

Untuk mengizinkan parameter tersebut, Azure Data Explorer memungkinkan Anda memasukkan nilai-nilai ini ke dalam TDS Language dan Application properti. Sebaiknya gunakan Language properti jika memungkinkan.

Opsi penyetelan yang didukung

Tabel berikut ini menjelaskan opsi penyetelan yang didukung. Untuk mempelajari cara menggunakan opsi ini, lihat penjelasan sintaksis .

Opsi penyetelan Deskripsi
MaxStringSize Perilaku default Azure Data Explorer adalah mempertimbangkan nilai string sebagai NVARCHAR(MAX). Untuk aplikasi yang tidak berfungsi dengan baik dengan jenisnya NVARCHAR(MAX) , Anda dapat mentransmisian data ke NVARCHAR(n).
AadAuthority Digunakan untuk menentukan ID penyewa Microsoft Entra untuk autentikasi.

Sintaks

[ LanguageApplication | ] = ExpectedArguments@TuningOptions

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama Tipe Wajib Deskripsi
ExpectedArguments string ✔️ Nilai yang Language diharapkan untuk bidang atau Application di TDS.
TuningOptions string Nol atau lebih opsi penyetelan yang didukung yang dipisahkan koma. Setiap opsi penyetelan harus dalam format TuningOptionName:TuningOptionValue.

Contoh

Contoh berikut menentukan ID penyewa Microsoft Entra dalam string koneksi ODBC menggunakan Language properti dan opsi penyetelanAadAuthority.

Driver={ODBC Driver 17 for SQL Server};Server=myadxcluster.westeurope.kusto.windows.net;Database=mydatabase;Authentication=ActiveDirectoryServicePrincipal;Language=any@AadAuthority:57B489CD-590C-417F-A8B9-E75D2F9A04C8,MaxStringSize:5000;UID=A9BCAB99-8AAD-4411-A232-37E2116B935E;PWD=mysecret