Udostępnij za pośrednictwem

Wykonywanie zapytań o dane w usłudze Azure Data Explorer przy użyciu emulacji programu SQL Server

  • Artykuł

Dowolna biblioteka i aplikacja, która może łączyć się z bazą danych Microsoft Azure SQL Database za pomocą uwierzytelniania entra firmy Microsoft, może również łączyć się z usługą Azure Data Explorer. Ta funkcja jest możliwa przez punkt końcowy zgodny ze standardem TDS usługi Azure Data Explorer, który emuluje program Microsoft SQL Server. Punkt końcowy obsługuje usługi TDS w wersjach 7.x i 8.0.

Za pomocą emulacji programu SQL Server można nawiązać połączenie z usługą Azure Data Explorer za pomocą różnych metod, takich jak ODBC, JDBC i typowe aplikacje , takie jak LINQPad i Azure Data Studio.

Uwierzytelnianie

Usługa Azure Data Explorer wymaga uwierzytelniania za pomocą identyfikatora Entra firmy Microsoft.

Aby uwierzytelnić jednostkę aplikacji, należy uwzględnić identyfikator dzierżawy w opcjach dostrajania. Przykład można znaleźć w temacie Connect with ODBC (Nawiązywanie połączenia z odBC).

Istnieje możliwość skonfigurowania identyfikatora dzierżawy usługi Microsoft Entra na poziomie klastra i usunięcia konieczności określenia go z klienta. Aby zmienić identyfikator dzierżawy na poziomie klastra, otwórz żądanie pomocy technicznej w witrynie Azure Portal dotyczące konfigurowania elementu SecuritySettings.TdsEndpointDefaultAuthority z wymaganym identyfikatorem dzierżawy.

Opcje dostrajania

Aby dostosować usługę Azure Data Explorer zgodnie z określonymi wymaganiami, może być konieczne podanie pewnych informacji, które nie są obsługiwane przez standardową konfigurację połączenia z programem SQL Server.

Aby zezwolić na takie parametry, usługa Azure Data Explorer umożliwia wprowadzanie tych wartości do zestawu TDS Language i Application właściwości. Jeśli to Language możliwe, zalecamy użycie właściwości .

Obsługiwane opcje dostrajania

W poniższej tabeli opisano obsługiwane opcje dostrajania. Aby dowiedzieć się, jak używać tych opcji, zobacz wyjaśnienie składni .

Opcja dostrajania opis
MaxStringSize Domyślnym zachowaniem usługi Azure Data Explorer jest rozważenie wartości ciągów jako NVARCHAR(MAX). W przypadku aplikacji, które nie działają dobrze z typem NVARCHAR(MAX) , można rzutować dane na NVARCHAR(n).
AadAuthority Służy do określania identyfikatora dzierżawy entra firmy Microsoft na potrzeby uwierzytelniania.

Składnia

[ LanguageApplication | ] = ExpectedArguments@TuningOptions

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
Oczekiwaneargumenty string ✔️ Oczekiwana wartość Language pola lub Application w TDS.
DostrajanieOpcje string Zero lub więcej obsługiwanych opcji dostrajania rozdzielonych przecinkami. Każda opcja dostrajania musi być w formacie TuningOptionName:TuningOptionValue.

Przykład

W poniższym przykładzie określono identyfikator dzierżawy firmy Microsoft Entra w parametry połączenia ODBC przy użyciu Language właściwości i AadAuthority opcji dostrajania.

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

Powiązana zawartość