Dela via


Ansluta till Azure Data Explorer med ODBC

Open Database Connectivity (ODBC) är ett allmänt godkänt API (Application Programming Interface) för databasåtkomst. Azure Data Explorer är kompatibelt med en delmängd av SQL Server kommunikationsprotokoll (MS-TDS). Den här kompatibiliteten möjliggör användning av ODBC-drivrutinen för SQL Server med Azure Data Explorer.

Därför kan du upprätta en anslutning till Azure Data Explorer från alla program som har stöd för ODBC-drivrutinen för SQL Server.

Titta på följande video om du vill lära dig att skapa en ODBC-anslutning.

Du kan också följa stegen för att konfigurera ODBC-datakällan.

Anteckning

Vi rekommenderar att du använder dedikerade anslutningsappar för Azure Data Explorer när det är möjligt. En lista över tillgängliga anslutningsappar finns i Översikt över anslutningsappar.

Förutsättningar

Konfigurera ODBC-datakällan

Så här konfigurerar du en ODBC-datakälla med ODBC-drivrutinen för SQL Server:

  1. I Windows söker du efter ODBC-datakällor och öppnar skrivbordsappen ODBC-datakällor.

  2. Välj Lägg till.

    Lägg till datakälla.

  3. Välj ODBC-drivrutin 17 för SQL Server och sedan Slutför.

    Välj drivrutin.

  4. Ange ett namn och en beskrivning för anslutningen och klustret som du vill ansluta till och välj sedan Nästa. Kluster-URL:en ska vara i formatet <ClusterName>.<Region.kusto.windows.net>.

    Anteckning

    När du anger kluster-URL:en ska du inte ta med prefixet "https://".

    Välj server.

  5. Välj Active Directory Integrerat och sedan Nästa.

    Active Directory Integrated.

  6. Välj databasen med exempeldata och sedan Nästa.

    Ändra standarddatabas.

  7. På nästa skärm lämnar du alla alternativ som standard och väljer sedan Slutför.

  8. Välj Testa datakälla.

    Testa datakällan.

  9. Kontrollera att testet lyckades och välj sedan OK. Om testet inte lyckades kontrollerar du de värden som du angav i föregående steg och kontrollerar att du har tillräcklig behörighet för att ansluta till klustret.

    Testet lyckades.

Använda ODBC-datakällan

Från ett program som stöder ODBC-anslutning kan du ansluta till Azure Data Explorer med en anslutningssträng i följande format:

"Driver={ODBC Driver 17 for SQL Server};Server=mykustocluster.kusto.windows.net;Database=mykustodatabase;Authentication=ActiveDirectoryIntegrated"

Anteckning

Azure Data Explorer betraktar strängvärden som NVARCHAR(MAX), vilket kanske inte fungerar bra med vissa ODBC-program. Omvandla data till NVARCHAR(n) med parametern Language i anslutningssträng. Till exempel Language=any@MaxStringSize:5000 kodar strängar som NVARCHAR(5000). Mer information finns i justeringsalternativ.

Programautentisering

Om du vill använda autentisering av programmets huvudnamn med ODBC måste du ange Microsoft Entra klientorganisations-ID. Du kan ange den här konfigurationen i anslutningssträng, Windows-registret eller odbc.ini-filen. Se exempel på följande flikar. Mer information finns i justeringsalternativ.

Ange programmets huvudnamn med Language=any@AadAuthority:<aad_tenant_id> i anslutningssträng. Ersätt <aad_tenant_id>, <aad_application_id>och <aad_application_secret> med Microsoft Entra klientorganisations-ID, Microsoft Entra program-ID och Microsoft Entra programhemlighet.

"Driver={ODBC Driver 17 for SQL Server};Server=<adx_cluster_name>.<region_name>.kusto.windows.net;Database=<adx_database_name>;Authentication=ActiveDirectoryServicePrincipal;Language=any@AadAuthority:<aad_tenant_id>;UID=<aad_application_id>;PWD=<aad_application_secret>"