Partilhar via


Conectar-se ao Azure Data Explorer com ODBC

Open Database Connectivity (ODBC) é uma interface de programação de aplicativos (API) amplamente aceita para acesso ao banco de dados. O Azure Data Explorer é compatível com um subconjunto do protocolo de comunicação do SQL Server (MS-TDS). Essa compatibilidade permite o uso do driver ODBC para SQL Server com o Azure Data Explorer.

Consequentemente, você pode estabelecer uma conexão com o Azure Data Explorer a partir de qualquer aplicativo equipado com suporte para o driver ODBC para SQL Server.

Assista ao vídeo a seguir para saber como criar uma conexão ODBC.

Como alternativa, siga as etapas para se conectar ao cluster com ODBC.

Observação

Use conectores dedicados sempre que possível. Para obter uma lista de conectores disponíveis, consulte Visão geral de conectores.

Pré-requisitos

Conectar-se ao cluster com ODBC

Você pode se conectar ao cluster das seguintes maneiras.

A partir de um aplicativo que ofereça suporte à conexão ODBC, você pode se conectar ao cluster com uma cadeia de conexão do seguinte formato:

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

Observação

O Azure Data Explorer trata os valores de cadeia de caracteres como NVARCHAR(MAX), o que pode causar problemas com alguns aplicativos ODBC. Converta cadeias de caracteres para NVARCHAR(\<n\>) usando o Language parâmetro na cadeia de conexão. Por exemplo, Language=any@MaxStringSize:5000 codifica cadeias de caracteres como NVARCHAR(5000). Para obter mais informações, consulte Opções de ajuste.

Autenticação de aplicativos

Para usar a autenticação de entidade de aplicativo com ODBC, você deve fornecer a ID de locatário do Microsoft Entra. Você pode definir essa configuração na cadeia de conexão, no registro do Windows ou no arquivo odbc.ini. Veja exemplos nos separadores seguintes. Para obter mais informações, consulte Opções de ajuste.

Defina a entidade de segurança do aplicativo com Language=any@AadAuthority:<aad_tenant_id> na cadeia de conexão. Substitua <aad_tenant_id>, <aad_application_id>e pela <aad_application_secret> ID do locatário do Microsoft Entra, pela ID do aplicativo Microsoft Entra e pelo segredo do aplicativo Microsoft Entra, respectivamente.

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