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
- Microsoft ODBC Driver for SQL Server versão 17.2.0.1 ou posterior para o sistema operacional.
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>"