Ligar ao Azure Data Explorer com ODBC

  • Artigo

Open Database Connectivity (ODBC) é uma interface de programação de aplicações (API) amplamente aceite para acesso à base de dados. O Azure Data Explorer é compatível com um subconjunto do protocolo de comunicação SQL Server (MS-TDS). Esta compatibilidade permite a utilização do controlador ODBC para SQL Server com o Azure Data Explorer.

Consequentemente, pode estabelecer uma ligação ao Azure Data Explorer a partir de qualquer aplicação equipada com suporte para o controlador ODBC para SQL Server.

Veja o seguinte vídeo para saber como criar uma ligação ODBC.

Em alternativa, siga os passos para configurar a origem de dados ODBC.

Nota

Recomendamos a utilização de conectores dedicados para o Azure Data Explorer sempre que possível. Para obter uma lista de conectores disponíveis, veja Descrição geral dos conectores.

Pré-requisitos

Configurar a origem de dados ODBC

Para configurar uma origem de dados ODBC com o controlador ODBC para SQL Server:

  1. No Windows, procure Origens de Dados ODBC e abra a aplicação de ambiente de trabalho Origens de Dados ODBC.

  2. Selecione Adicionar.

    Adicionar origem de dados.

  3. Selecione Controlador ODBC 17 para SQL Server, em seguida, Concluir.

    Selecione controlador.

  4. Introduza um nome e uma descrição para a ligação e o cluster ao qual pretende ligar e, em seguida, selecione Seguinte. O URL do cluster deve estar no formulário <ClusterName>.<Region.kusto.windows.net>.

    Nota

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

    Selecione servidor.

  5. Selecione Active Directory Integrado e Seguinte.

    Integrado do Active Directory.

  6. Selecione a base de dados com os dados de exemplo e , em seguida, Seguinte.

    Alterar a base de dados predefinida.

  7. No ecrã seguinte, deixe todas as opções como predefinições e, em seguida, selecione Concluir.

  8. Selecione Testar Origem de Dados.

    Testar a origem de dados.

  9. Verifique se o teste foi executado com êxito e, em seguida, selecione OK. Se o teste não tiver sido bem-sucedido, verifique os valores que especificou nos passos anteriores e certifique-se de que tem permissões suficientes para ligar ao cluster.

    Teste com êxito.

Utilizar a origem de dados ODBC

A partir de uma aplicação que suporte a ligação ODBC, pode ligar-se ao Azure Data Explorer com uma cadeia de ligação do seguinte formato:

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

Nota

O Azure Data Explorer considera os valores de cadeia como NVARCHAR(MAX), o que pode não funcionar bem com algumas aplicações ODBC. Despeja os dados para NVARCHAR(n) utilizando o Language parâmetro no cadeia de ligação. Por exemplo, Language=any@MaxStringSize:5000 irá codificar cadeias como NVARCHAR(5000). Para obter mais informações, veja opções de otimização.

Autenticação de aplicação

Para utilizar a autenticação principal da aplicação com o ODBC, tem de fornecer o ID do inquilino Microsoft Entra. Pode definir esta configuração no cadeia de ligação, no registo do Windows ou no ficheiro odbc.ini. Veja exemplos nos seguintes separadores. Para obter mais informações, veja opções de otimização.

Defina o principal da aplicação com Language=any@AadAuthority:<aad_tenant_id> no cadeia de ligação. Substitua <aad_tenant_id>, <aad_application_id>e <aad_application_secret> pelo ID do inquilino Microsoft Entra, Microsoft Entra ID da aplicação e o segredo da aplicação Microsoft Entra, respetivamente.

"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