Tipo de conexão Oracle (Power BI Report Builder)

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

Para usar dados de um banco de dados Oracle em seu relatório, você deve ter um conjunto de dados baseado em uma fonte de dados de relatório do tipo Oracle. Esse tipo de fonte de dados integrada usa o Oracle Data Provider diretamente e requer um componente de software cliente Oracle. Este artigo explica como baixar e instalar drivers para o Construtor de Relatórios do Power BI.

Importante

Os comandos a seguir que usam a ferramenta OraProvCfg.exe da Oracle para registrar os drivers de ODP.NET gerenciados e não gerenciados da Oracle são fornecidos como exemplos para uso com os produtos Microsoft acima. Para a configuração dos drivers de ODP.NET específicos para seu ambiente, talvez seja necessário entrar em contato com o suporte da Oracle ou consultar a documentação da Oracle para Configurando o Oracle Data Provider for .NET.

Drivers de 32 bits para o Construtor de Relatórios do Power BI

O Construtor de Relatórios do Power BI usa o ODP.NET Gerenciado para criar relatórios paginados (RDL). Você só precisa das etapas a seguir ao usar os drivers Oracle ODAC 12.2 e posteriores. Caso contrário, eles são instalados por padrão em uma configuração que não abrange toda a máquina para uma nova instalação doméstica do Oracle. Estas etapas pressupõem que você instalou os arquivos ODAC 18.x na pasta c:\oracle32 onde o Construtor de Relatórios do Power BI está instalado. Siga estas etapas para registrar o Managed ODP.NET:

1. No site de download da Oracle, instale o Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32 bits).

2. Registre ODP.NET cliente gerenciado no GAC:

   C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

3. Adicione ODP.NET entradas do Cliente Gerenciado a machine.config:

   C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

Drivers de 64 bits para o Construtor de Relatórios do Power BI

Nota

As instruções a seguir se aplicam ao Construtor de Relatórios do Power BI versão 15.7.01678.0001 e posterior. Para versões anteriores a 15.7.01678.0001, siga as instruções de drivers de 32 bits para o Construtor de Relatórios do Power BI acima.

O Construtor de Relatórios do Power BI usa o ODP.NET Gerenciado para criar relatórios paginados (RDL). Você só precisa das etapas a seguir ao usar os drivers Oracle ODAC 12.2 e posteriores. Caso contrário, eles são instalados por padrão em uma configuração que não abrange toda a máquina para uma nova instalação doméstica do Oracle. Estas etapas pressupõem que você instalou os arquivos ODAC 18.x na pasta c:\oracle64 onde o Construtor de Relatórios do Power BI está instalado. Siga estas etapas para registrar o Managed ODP.NET:

1. No site de download do Oracle, instale o Oracle ODAC Oracle Universal Installer (OUI) de 64 bits.

2. Registre ODP.NET cliente gerenciado no GAC:

   C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

3. Adicione ODP.NET entradas do Cliente Gerenciado a machine.config:

   C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

Connection string

Entre em contato com o administrador do banco de dados para obter informações de conexão e as credenciais a serem usadas para se conectar à fonte de dados. O exemplo de cadeia de conexão a seguir especifica um banco de dados Oracle no servidor chamado "Oracle18" usando Unicode. O nome do servidor deve corresponder ao que está definido no arquivo de configuração Tnsnames.ora como o nome da instância do servidor Oracle.

Data Source="Oracle18"; Unicode="True"  

Para obter mais exemplos de cadeia de conexão, consulte Criar cadeias de conexão de dados - Construtor de Relatórios do Power BI.

Credenciais

As credenciais são necessárias para executar consultas, visualizar o relatório localmente e visualizá-lo no portal da Web do Power BI.

Depois de publicar o relatório, talvez seja necessário vinculá-lo a uma conexão do Gateway do Power BI. Para obter mais informações, consulte Gerenciar sua fonte de dados - Oracle

Consultas

Para criar um conjunto de dados, você pode selecionar um procedimento armazenado em uma lista suspensa ou criar uma consulta SQL. Para criar uma consulta, você deve usar o designer de consulta baseado em texto. Para obter mais informações, consulte Interface do usuário do Designer de Consulta baseado em texto (Construtor de Relatórios do Power BI).

Você pode especificar procedimentos armazenados que retornam apenas um conjunto de resultados. Não há suporte para o uso de consultas baseadas em cursor.

Parâmetros

Se a consulta incluir variáveis de consulta, os parâmetros de relatório correspondentes serão gerados automaticamente. Os parâmetros nomeados são suportados por esta extensão. Para Oracle versão 9 ou posterior, há suporte para parâmetros de vários valores.

Os parâmetros de relatório são criados com valores de propriedade padrão que talvez seja necessário modificar. Por exemplo, cada parâmetro de relatório é do tipo de dados Text. Depois que os parâmetros de relatório forem criados, talvez seja necessário alterar os valores padrão.

Considerações e limitações

Antes de conectar uma fonte de dados Oracle, o administrador do sistema deve ter instalado a versão do .NET Data Provider for Oracle que oferece suporte à recuperação de dados do banco de dados Oracle. Esse provedor de dados deve ser instalado no mesmo computador que o Construtor de Relatórios do Power BI e também na máquina que hospeda o Power BI Gateway. Para obter mais informações, consulte Gerenciar sua fonte de dados - Oracle.

Solução alternativa para chamar procedimentos armazenados

Quando você usa uma fonte de dados Oracle, se o relatório paginado tiver o tipo de consulta definido como Procedimento Armazenado, ele não será executado no serviço do Power BI devido a uma limitação do Gateway do Power BI. Como solução alternativa, se você estiver usando o Oracle 12 ou superior, defina o tipo de consulta como texto e chame o procedimento armazenado embutido, como no exemplo a seguir.

DECLARE OUT_RPT_DATA SYS_REFCURSOR;
BEGIN
   SYSTEM.<Procedure_Name>(OUT_RPT_DATA);
   DBMS_SQL.RETURN_RESULT(OUT_RPT_DATA);
END;

Informações sobre a plataforma e a versão

Para obter mais informações sobre suporte a plataforma e versão, consulte Fontes de dados com suporte para relatórios paginados do Power BI.

Conteúdos relacionados

• Gerencie sua fonte de dados - Oracle
• Filtrar, agrupar e classificar dados (Construtor de Relatórios do Power BI)
• Expressões (Construtor de Relatórios do Power BI)