Dela via


Fråga efter data i Azure Data Explorer med SQL Server-emulering

Alla bibliotek och program som kan ansluta till en Microsoft Azure SQL Database med Microsoft Entra-autentisering kan också ansluta till Azure Data Explorer. Den här funktionen möjliggörs av Azure Data Explorer SDS-kompatibla slutpunkt, som emulerar Microsoft SQL Server. Slutpunkten stöder TDS-versionerna 7.x och 8.0.

Med SQL Server emulering kan du ansluta till Azure Data Explorer med olika metoder, inklusive ODBC, JDBC och vanliga appar som LINQPad och Azure Data Studio.

Autentisering

Azure Data Explorer kräver autentisering via Microsoft Entra ID.

Om du vill autentisera ett programhuvudnamn måste du inkludera klientorganisations-ID:t i justeringsalternativen. Ett exempel finns i Ansluta med ODBC.

Det går att konfigurera Microsoft Entra klientorganisations-ID på klusternivå och ta bort behovet av att ange det från klienten. Om du vill ändra klientorganisations-ID:t på klusternivå öppnar du en supportbegäran i Azure Portal om att konfigurera SecuritySettings.TdsEndpointDefaultAuthority med det klient-ID som krävs.

Finjusteringsalternativ

Om du vill anpassa Azure Data Explorer enligt dina specifika krav kan du behöva ange viss information som inte stöds av standardkonfigurationen för SQL Server anslutning.

För att tillåta sådana parametrar kan du med Azure Data Explorer ange dessa värden i TDS Language och Application egenskaper. Vi rekommenderar att du använder egenskapen när det Language är möjligt.

Justeringsalternativ som stöds

I följande tabell beskrivs de justeringsalternativ som stöds. Information om hur du använder de här alternativen finns i syntaxförklaringen .

Justeringsalternativ Description
MaxStringSize Standardbeteendet för Azure Data Explorer är att betrakta strängvärden som NVARCHAR(MAX). För program som inte fungerar bra med NVARCHAR(MAX) typen kan du omvandla data till NVARCHAR(n).
AadAuthority Används för att ange Microsoft Entra klientorganisations-ID för autentisering.

Syntax

[ Language | Application ] =ExpectedArguments@TuningOptions

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
ExpectedArguments string ✔️ Det förväntade värdet för Language fältet eller Application i TDS.
TuningOptions string Noll eller fler kommaavgränsade justeringsalternativ som stöds. Varje justeringsalternativ måste ha formatet TuningOptionName:TuningOptionValue.

Exempel

I följande exempel anges Microsoft Entra klientorganisations-ID i en ODBC-anslutningssträng med hjälp av Language egenskapen och justeringsalternativetAadAuthority.

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