Compartilhar via


Conectar-se ao Azure Data Explorer com o ODBC

ODBC é uma API (interface de programação de aplicativo) 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 de qualquer aplicativo equipado com suporte para o driver ODBC para SQL Server.

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

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

Observação

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

Pré-requisitos

Conectar-se ao cluster com ODBC

Você pode se conectar ao cluster das seguintes maneiras.

Em um aplicativo que dá 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 considera valores de cadeia de caracteres como NVARCHAR(MAX), o que pode não funcionar bem com alguns aplicativos ODBC. Converta os dados em NVARCHAR(n) usando o Language parâmetro na cadeia de conexão. Por exemplo, Language=any@MaxStringSize:5000 codificará strings como NVARCHAR(5000). Para obter mais informações, consulte opções de ajuste.

Autenticação do aplicativo

Para usar a autenticação da entidade de segurança do aplicativo com ODBC, você deve fornecer a ID do 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 nas guias a seguir. 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 <aad_application_secret> pela ID do locatário do Microsoft Entra, ID do aplicativo do Microsoft Entra e o segredo do aplicativo do 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>"