Verbinding maken met Azure Data Explorer vanuit Data Explorer

Open Database Connectivity (ODBC) is een algemeen geaccepteerde Api (Application Programming Interface) voor databasetoegang. Azure Data Explorer is compatibel met een subset van het SQL Server communication protocol (MS-TDS). Deze compatibiliteit maakt het gebruik van het ODBC-stuurprogramma mogelijk voor SQL Server met Azure Data Explorer.

Daarom kunt u verbinding maken met Azure Data Explorer vanuit elke toepassing die is uitgerust met ondersteuning voor het ODBC-stuurprogramma voor SQL Server.

Bekijk de volgende video voor meer informatie over het maken van een ODBC-verbinding.

U kunt ook de stappen volgen om de ODBC-gegevensbron te configureren.

Notitie

We raden u aan om waar mogelijk toegewezen connectors voor Azure Data Explorer te gebruiken. Zie Overzicht van connectors voor een lijst met beschikbare connectors.

Vereisten

De ODBC-gegevensbron configureren

Een ODBC-gegevensbron configureren met behulp van het ODBC-stuurprogramma voor SQL Server:

  1. Zoek in Windows naar ODBC-gegevensbronnen en open de bureaublad-app ODBC-gegevensbronnen.

  2. Selecteer Toevoegen.

    Gegevensbron toevoegen.

  3. Selecteer ODBC-stuurprogramma 17 voor SQL Server selecteer vervolgens Voltooien.

    Selecteer stuurprogramma.

  4. Voer een naam en beschrijving in voor de verbinding en het cluster waarmee u verbinding wilt maken en selecteer vervolgens Volgende. De cluster-URL moet de notatie <ClusterName hebben>.<Region.kusto.windows.net>.

    Notitie

    Neem bij het invoeren van de cluster-URL het voorvoegsel 'https://' niet op.

    Selecteer server.

  5. Selecteer Active Directory Geïntegreerd en vervolgens Volgende.

    Active Directory geïntegreerd.

  6. Selecteer de database met de voorbeeldgegevens en vervolgens Volgende.

    Wijzig de standaarddatabase.

  7. Laat in het volgende scherm alle opties als standaardwaarden staan en selecteer vervolgens Voltooien.

  8. Selecteer Gegevensbron testen.

    Gegevensbron testen.

  9. Controleer of de test is geslaagd en selecteer VERVOLGENS OK. Als de test niet is geslaagd, controleert u de waarden die u in de vorige stappen hebt opgegeven en controleert u of u voldoende machtigingen hebt om verbinding te maken met het cluster.

    De test is voltooid.

De ODBC-gegevensbron gebruiken

Vanuit een toepassing die ODBC-verbinding ondersteunt, kunt u verbinding maken met Azure Data Explorer met een verbindingsreeks van de volgende indeling:

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

Notitie

Azure Data Explorer beschouwt tekenreekswaarden als NVARCHAR(MAX), wat mogelijk niet goed werkt met sommige ODBC-toepassingen. Cast de gegevens naar NVARCHAR(n) met behulp van de Language parameter in de verbindingsreeks. Coderen tekenreeksen bijvoorbeeld Language=any@MaxStringSize:5000 als NVARCHAR(5000). Zie Afstemmingsopties voor meer informatie.

Toepassingsverificatie

Als u toepassings-principalverificatie wilt gebruiken met ODBC, moet u de Microsoft Entra tenant-id opgeven. U kunt deze configuratie instellen in de verbindingsreeks, het Windows-register of het odbc.ini-bestand. Zie voorbeelden op de volgende tabbladen. Zie Afstemmingsopties voor meer informatie.

Stel de toepassings-principal in met Language=any@AadAuthority:<aad_tenant_id> in de verbindingsreeks. Vervang <aad_tenant_id>, <aad_application_id>en <aad_application_secret> door respectievelijk de Microsoft Entra tenant-id, Microsoft Entra toepassings-id en het Microsoft Entra toepassingsgeheim.

"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>"