Suporte ao gateway do Power BI e ao Construtor de Relatórios para fontes de dados ODBC

APLICA-SE A: Power BI Report Builder Power BI Desktop

Este artigo explica como configurar fontes de dados ODBC (Open Database Connectivity) no gateway do Power BI e como usar fontes de dados ODBC no Construtor de Relatórios do Power BI.

O Nome da Fonte de Dados (DSN) e as cadeias de conexão do driver são suportados.

Antes de instalar o gateway do Power BI

Você precisa de uma versão do gateway do Power BI em fevereiro de 2021 ou posterior. Recomendamos instalar o gateway em um computador separado do Construtor de Relatórios do Power BI ou do Power BI Desktop. Existem alguns cenários em que usar o mesmo computador pode causar problemas.

Instalar e configurar o Construtor de Relatórios do Power BI para fonte de dados ODBC

A versão mais recente do Construtor de Relatórios do Power BI já contém a extensão de dados ODBC.

1. Instale a versão mais recente do Construtor de Relatórios do Power BI.
2. Instale o driver ODBC de 64 bits que você planeja usar com o Construtor de Relatórios do Power BI.

Instalar o gateway do Power BI, configurar fontes de dados ODBC

Siga estas etapas para configurar o gateway do Power BI para fontes de dados ODBC.

1. Baixe o gateway do Power BI mais recente.

   Nota

   Não há suporte para gateways pessoais para relatórios paginados, porque exigem suporte ao DirectQuery.

2. Consulte o artigo O que é um gateway de dados local? para obter informações sobre como configurá-lo.

3. Instale o driver ODBC de 64 bits que você planeja usar no computador gateway.

   Nota

   Não há suporte para DSNs de arquivos. Se você quiser usar um DSN, crie um DSN de sistema de 64 bits no computador gateway.

4. Para configurar uma fonte de dados ODBC no serviço do Power BI, selecione Gerenciar conexões e gateways em Configurações:

   

5. Selecione Novo na parte superior da faixa de opções para adicionar uma nova fonte de dados. Em seguida, escolha Adicionar tipo de fonte de dados ODBC da fonte>de dados:

   

6. Cole na cadeia de conexão (DSN do sistema ou driver) e selecione um método de autenticação. Para fontes de dados ODBC, os seguintes métodos de autenticação são suportados:

   • Básica
   • Windows

7. Quando você seleciona o botão Adicionar , o serviço do Power BI se conecta à fonte de dados ODBC usando a cadeia de conexão e as credenciais fornecidas para validar se o gateway pode se conectar.

Exemplos de cadeia de conexão ODBC

Aqui estão alguns exemplos de cadeia de conexão ODBC para um DSN do sistema, bem como vários drivers ODBC:

• "dsn=Vento Norte"
• "driver={Driver do Microsoft Access (*.mdb, *.accdb)}; dbq=c:\Dados\Northwind.mdb"
• "driver={SnowflakeDSIIDriver}; armazém=DEMO_WH; servidor=org.snowflakecomputing.com"
• "driver={Amazon Redshift (x64)}; servidor=org.us-west-2.redshift.amazonaws.com; banco de dados = dev"

Determinados drivers e configurações podem não suportar todos os métodos de autenticação.

Além de criar fontes de dados ODBC no gateway antecipadamente, você pode criar fontes de dados ODBC sob demanda ao carregar um relatório paginado. Se uma fonte de dados ODBC não existir, o processo de carregamento solicitará que você crie uma:

Limitações e considerações

Em geral, todas as limitações que se aplicam ao uso da extensão de dados ODBC no Construtor de Relatórios do Power BI também se aplicam ao uso das extensões de dados ODBC no gateway do Power BI.

Aqui estão algumas das limitações:

• Para a maioria dos drivers ODBC, os parâmetros DateTime exigem alterações no texto do comando no conjunto de dados RDL para converter um valor de parâmetro DateTime para o formato apropriado para uma determinada fonte de dados ODBC.

  Consulta de exemplo:
  SELECT * FROM DEMO_DB.PUBLIC.DATES WHERE DATE < DATE(?)

  Nota

  Algumas fontes de dados podem exigir formatação específica. Você pode usar uma expressão para formatar o parâmetro no exemplo anterior. Por exemplo, =Format(Parameters!Date.Value, "yyyy-MM-dd").

• Para alguns drivers ODBC, há uma diferença de comportamento entre o gateway e o Construtor de Relatórios do Power BI. Isso pode se aplicar a todos, alguns ou apenas um driver. Um exemplo é que a consulta Simba-BigQuery requer a conversão do parâmetro se ele não for um tipo de cadeia de caracteres.

  Exemplo de cadeia de erro: "Uma fonte de dados usada por este relatório retornou um erro. Uma exceção encontrada ao acessar a fonte de dados de destino ERRO [42000] [Simba][BigQuery] (70) Consulta inválida: Nenhuma assinatura correspondente para o operador = para tipos de argumento: INT64, STRING. Assinatura suportada: ANY = ANY em [2:7]"

  Exemplo de consulta com conversão adequada para uma coluna INT64:
  SELECT * FROM 'teamplz.Sample.SampleTable' WHERE DataID=CAST(? as INT64)

• Não há suporte para quaisquer tipos de dados especiais expostos por um determinado driver ODBC ou back-end que não sejam simplesmente mapeados para um tipo de dados ADO.Net . Um exemplo é o tipo de dados Snowflake Array.

• Cenários em que drivers ODBC usam procedimentos armazenados sem parâmetros geralmente não são suportados. No entanto, o driver do Amazon Redshift tem parâmetros de entrada/saída suportados.