ODBC

Resumo

Item Descrição
Estado da liberação Disponibilidade geral
Produtos Excel
Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Malha (fluxo de dados Gen2)
Power Apps (Fluxos de dados)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticação compatíveis Banco de dados (nome de usuário/senha)
Windows
Padrão ou Personalizada
Documentação de referência da função Odbc.DataSource
Odbc.Query

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a cronogramas de implantação e funcionalidades específicas do host.

Pré-requisitos

Antes de começar, verifique se você configurou corretamente a conexão no Administrador de Fonte de Dados ODBC do Windows. O processo exato aqui depende do driver.

Funcionalidades com suporte

  • Importação
  • Opções avançadas
    • Cadeia de conexão (propriedades não relacionadas à credencial)
    • SQL statement
    • Cláusulas de redução de linha com suporte

Conectar-se a uma fonte de dados ODBC do Power Query Desktop

Para fazer a conexão, execute as seguintes etapas:

  1. Selecione a opção ODBC na seleção Obter Dados.

  2. Em Do ODBC, selecione o nome da fonte de dados (DSN) na caixa suspensa DSN (nome da fonte de dados). Neste exemplo, um nome DSN do Banco de Dados do SQL Server é usado.

    Construtor de conexões ODBC no Power Query Desktop.

    Você também pode escolher Opções avançadas para inserir outras informações de conexão opcionais. Mais informações: Conectar usando opções avançadas

  3. Quando terminar, selecione OK.

  4. Se você estiver se conectando a esse banco de dados pela primeira vez, selecione o tipo de autenticação e insira suas credenciais quando solicitado.

    Autenticação do ODBC no Power Query Desktop.

    Os tipos de autenticação disponíveis são:

    • Padrão ou Personalizada: selecione esse tipo de autenticação quando você não especificar nenhuma credencial, caso esteja usando o DSN configurado com um nome de usuário e uma senha. Ou, se você precisar incluir credenciais como propriedades de cadeia de conexão.
    • Windows: selecione esse tipo de autenticação se quiser se conectar usando a autenticação do Windows. Opcionalmente, inclua as propriedades de cadeia de conexão necessárias.
    • Banco de dados: selecione esse tipo de autenticação para usar um nome de usuário e uma senha para acessar uma fonte de dados com um driver ODBC. Opcionalmente, inclua as propriedades de cadeia de conexão necessárias. Essa é a seleção padrão.

    Mais informações: Autenticação com uma fonte de dados

  5. Ao terminar, selecione Conectar.

  6. No Navegador, selecione as informações desejadas do banco de dados e clique em Carregar para carregar os dados ou Transformar Dados para continuar transformando os dados no Editor do Power Query.

    navegador.

Conectar-se a uma fonte de dados ODBC por meio do Power Query Online

Para fazer a conexão, execute as seguintes etapas:

  1. Na página Fontes de dados, selecione ODBC.

  2. Na página ODBC, insira sua cadeia de conexão do ODBC. No exemplo a seguir, a cadeia de conexão é dsn=SQL Server Database.

    Imagem da página ODBC, com a cadeia de conexão definida para o banco de dados do SQL Server

  3. Se necessário, selecione um gateway de dados local em Gateway de dados.

  4. Escolha o tipo de autenticação para iniciar sessão e, em seguida, insira suas credenciais.

  5. Selecione Avançar.

  6. No Navegador, selecione as informações desejadas do banco de dados e, em seguida, selecione Transformar dados para continuar transformando os dados no Editor do Power Query.

Conectar usando opções avançadas

O Power Query tem um conjunto de opções avançadas que você pode adicionar à sua consulta, se necessário.

Opções avançadas do ODBC.

Opção avançada Descrição
Cadeia de conexão (propriedades não relacionadas à credencial) Fornece uma cadeia de conexão opcional que pode ser usada em vez da seleção DSN (nome da fonte de dados) no Power BI Desktop. Se o DSN (nome da fonte de dados) estiver definido como (Nenhum),você poderá inserir uma cadeia de conexão aqui. Por exemplo, as seguintes cadeias de conexão são válidas: dsn=<myDSN> ou driver=<myDriver>;port=<myPortNumber>;server=<myServer>;database=<myDatabase>;. Use caracteres { } para escapar caracteres especiais. As chaves para cadeias de conexão variam entre diferentes drivers ODBC. Consulte o provedor do driver ODBC para obter mais informações sobre cadeias de conexão válidas.
SQL statement Fornece uma instrução SQL, dependendo das funcionalidades do driver. Peça mais informações ao fornecedor ou acesse Importar dados de um banco de dados usando a consulta de banco de dados nativa.
Cláusulas de redução de linha com suporte Habilita o suporte de dobragem para Table.FirstN. Selecione Detectar para localizar cláusulas de redução de linha com suporte ou selecione uma das opções suspensas (TOP, LIMIT e OFFSET, LIMIT ou ANSI compatível com SQL). Essa opção não é aplicável ao usar uma instrução SQL nativa. Disponível somente no Power Query Desktop.

Limitações e problemas conhecidos

Atributos de cadeia de conexão

Se um DSN for especificado na cadeia de conexão ODBC, os atributos após a especificação DSN não serão incluídos. Se você quiser usar atributos adicionais, atualize-os no próprio DSN, em vez de na cadeia de conexão.