Share via

Conectar-se ao Azure Data Explorer com o ODBC

  • Artigo

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

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 saber como criar uma conexão ODBC.

Como alternativa, siga as etapas para configurar a fonte de dados ODBC.

Observação

É recomendável usar conectores dedicados para o Azure Data Explorer sempre que possível. Para obter uma lista de conectores disponíveis, consulte Visão geral dos conectores.

Pré-requisitos

Configurar a fonte de dados ODBC

Para configurar uma fonte de dados ODBC usando o driver ODBC para SQL Server:

  1. No Windows, pesquise Fontes de Dados ODBC e abra o aplicativo de desktop Fontes de Dados ODBC.

  2. Selecione Adicionar.

    Adicione a fonte de dados.

  3. Selecione Driver ODBC 17 para SQL Server e Concluir.

    Selecione o driver.

  4. Insira um nome e uma descrição para a conexão e o cluster ao qual você deseja se conectar e, em seguida, selecione Avançar. A URL do cluster deve estar no formato <NomeDoCluster>.<Região>.kusto.windows.net.

    Observação

    Ao inserir a URL do cluster, não inclua o prefixo "https://".

    Selecione o servidor.

  5. Selecione Integrado ao Active Directory e Avançar.

    Integrado ao Active Directory.

  6. Selecione o banco de dados com os dados de exemplo e Avançar.

    Altere o banco de dados padrão.

  7. Na próxima tela, deixe todas as opções como padrão e selecione Concluir.

  8. Selecione Testar Fonte de Dados.

    Teste a fonte de dados.

  9. Verifique se o teste foi realizado com sucesso e selecione OK. Se o teste falhou, verifique os valores especificados nas etapas anteriores e se você tem permissões suficientes para se conectar ao cluster.

    Teste realizado com sucesso.

Usar a fonte de dados ODBC

Em um aplicativo que dá suporte à conexão ODBC, você pode se conectar ao Azure Data Explorer com um 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 no cadeia de conexão. Por exemplo, Language=any@MaxStringSize:5000 codificará cadeias de caracteres 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 aplicativo com o ODBC, você deve fornecer a ID do locatário Microsoft Entra. Você pode definir essa configuração no 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> no cadeia de conexão. Substitua <aad_tenant_id>, <aad_application_id>e <aad_application_secret> pela ID do locatário Microsoft Entra, Microsoft Entra ID do aplicativo e o 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>"

Conteúdo relacionado