Interroger des données dans Azure Data Explorer à l’aide de l’émulation SQL Server
Toute bibliothèque et application pouvant se connecter à une base de données Microsoft Azure SQL Avec l’authentification Microsoft Entra peut également se connecter à Azure Data Explorer. Cette fonctionnalité est rendue possible par le point de terminaison TDS conforme à Azure Data Explorer, qui émule Microsoft SQL Server. Le point de terminaison prend en charge TDS versions 7.x et 8.0.
Avec l’émulation SQL Server, vous pouvez vous connecter à Azure Data Explorer via différentes méthodes, notamment ODBC, JDBC et des applications courantes telles que LINQPad et Azure Data Studio.
Authentification
Azure Data Explorer nécessite l’authentification via Microsoft Entra ID.
Pour authentifier un principal d’application, vous devez inclure l’ID de locataire dans les options de paramétrage. Pour obtenir un exemple, consultez la connexion avec ODBC.
Il est possible de configurer l’ID de locataire Microsoft Entra au niveau du cluster et de supprimer la nécessité de le spécifier du client. Pour modifier l’ID de locataire au niveau du cluster, ouvrez une demande de support dans le portail Azure sur la configuration de SecuritySettings.TdsEndpointDefaultAuthority avec l’ID de locataire requis.
Options de paramétrage
Pour personnaliser Azure Data Explorer en fonction de vos besoins spécifiques, vous devrez peut-être fournir certaines informations qui ne sont pas prises en charge par la configuration de connexion SQL Server standard.
Pour autoriser ces paramètres, Azure Data Explorer vous permet d’entrer ces valeurs dans les propriétés TDS Language et Application. Nous vous recommandons d’utiliser la propriété Language si possible.
Options de paramétrage prises en charge
Le tableau suivant décrit les options de réglage prises en charge. Pour savoir comment utiliser ces options, consultez l’explication de syntaxe.
| Option de paramétrage | Description |
|---|---|
MaxStringSize |
Le comportement par défaut d’Azure Data Explorer consiste à considérer les valeurs de chaîne comme NVARCHAR(MAX). Pour les applications qui ne fonctionnent pas correctement avec le type NVARCHAR(MAX), vous pouvez convertir les données en NVARCHAR(n). |
AadAuthority |
Utilisé pour spécifier l’ID de locataire Microsoft Entra pour l’authentification. |
Syntaxe
[ Language | Application ] =ExpectedArguments@TuningOptions
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| ExpectedArguments | string |
✔️ | Valeur attendue pour le champ Language ou Application dans TDS. |
| TuningOptions | string |
Aucune ou plusieurs options de réglage prises en charge séparées par des virgules. Chaque option de paramétrage doit être au format TuningOptionName:TuningOptionValue. |
Exemple
L’exemple suivant spécifie l’ID de locataire Microsoft Entra dans une chaîne de connexion ODBC à l’aide de la propriété Language et de l’option de paramétrage AadAuthority.
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