Wykonywanie zapytań o dane w usłudze Azure Data Explorer przy użyciu emulacji programu SQL Server
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