Configure o tipo de ligação Oracle com SSRS e um servidor de relatórios Power BI

Aplica-se a: SQL Server 2016 (13.x) Serviços de Relatórios e versões posteriores Power BI Report Builder Power BI Report Server

Para usar dados de uma base de dados Oracle no seu relatório, deve ter um conjunto de dados baseado numa 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 descarregar e instalar drivers para Reporting Services, Power BI Report Server, Report Builder e Power BI Desktop.

Use a informação deste artigo para construir uma fonte de dados. Para instruções passo a passo, consulte Adicionar e verificar uma ligação de dados (Construtor de Relatórios e SSRS).

Drivers de 64 bits para os servidores de relatórios

No site de download do Oracle, instale o Oracle ODAC Oracle Universal Installer (OUI) de 64 bits. Só precisa dos seguintes passos para os drivers Oracle Data Access Components (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.

Pré-requisito: Instalar os ficheiros ODAC 18.x na pasta c:\oracle64.

Os relatórios paginados (RDL) utilizam ODP.NET gerido

O Power BI Report Server e o SQL Server Reporting Services 2016 e posteriores utilizam todos o Managed ODP.NET para relatórios paginados (RDL).

Registo de Gestão de ODP.NET:

1. Registar o Cliente Gerenciado do ODP.NET na Global Assembly Cache (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
   

2. 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
   

Relatórios do Power BI utilizam ODP.NET não gerenciado

O Power BI Report Server utiliza o ODP.NET Unmanaged nos relatórios do Power BI.

Registar os ODP.NET Não Geridos:

1. Registar ODP.NET Cliente Não Gerenciado na 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\bin\4\Oracle.DataAccess.dll
   

2. Adicionar entradas do ODP.NET Cliente Unmanaged à machine.config:

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

Drivers de 32 bits para o Microsoft Report Builder

O Microsoft Report Builder utiliza ODP.NET gerida para criar relatórios paginados (RDL). Só precisa dos seguintes passos para 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.

Pré-requisito: Instalar os ficheiros ODAC 18.x na pasta c:\oracle32 onde o Microsoft Report Builder está instalado.

Registo Gerido ODP.NET:

1. Instale o Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32-bit) no site de downloads da Oracle.

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

O Power BI Report Builder utiliza ODP.NET gerida para criar relatórios paginados (RDL). Só precisa dos seguintes passos para 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.

Pré-requisito: Instalar os ficheiros ODAC 18.x na pasta c:\oracle64 onde o Power BI Report Builder está instalado.

Registo Gerido ODP.NET:

1. Instale o Oracle ODAC Universal Installer (OUI) de 64 bits no site de downloads da Oracle.

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
   

Controladores de 64 e 32 bits para Power BI Desktop

O Power BI Desktop utiliza o ODP.NET não gerido para criar relatórios Power BI. Só precisa dos seguintes passos para 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.

Pré-requisito: Instale os ficheiros ODAC 18.x na pasta c:\oracle64 para o Power BI Desktop de 64 bits ou na pasta c:\oracle32 para o Power BI Desktop de 32 bits.

Registar ODP.NET Não Geridos:

Power BI Desktop de 64 bits

1. Instale o Oracle ODAC Universal Installer (OUI) de 64 bits no site de downloads da Oracle.

2. Registe ODP.NET Cliente Não Gerido na 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\bin\4\Oracle.DataAccess.dll
   

3. Adicionar entradas de Cliente Nativo do ODP.NET ao machine.config:

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

Power BI Desktop de 32 bits

1. Instale o Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32-bit) no site de downloads da Oracle.

2. Registar Cliente Não Gerenciado ODP.NET na 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\bin\4\Oracle.DataAccess.dll
   

3. Adicionar as entradas do Cliente Não Gerido do ODP.NET ao machine.config:

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

Cadeia de ligação

Contacte o administrador da sua base de dados para obter informações de ligação e credenciais para se ligar à fonte de dados. O seguinte exemplo de string de ligação especifica uma base de dados Oracle no servidor nomeada Oracle18 usando Unicode. O nome do servidor deve corresponder à definição no ficheiro de configuração Tnsnames.ora como nome da instância do servidor Oracle:

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

Para mais exemplos de cadeias de ligação, veja Criar cadeias de ligação de dados no Construtor de Relatórios.

Credentials

São necessárias credenciais para executar consultas, pré-visualizar o relatório localmente e pré-visualizar o relatório a partir do servidor de relatórios.

Depois de publicar o seu relatório, pode ser necessário alterar as credenciais da fonte de dados para que, quando o relatório for executado no servidor de relatórios, as permissões para recuperar os dados sejam válidas.

Para mais informações, consulte Especificar informações de credenciais e ligação para fontes de dados de relatório.

Queries

Para criar um conjunto de dados, pode selecionar um procedimento armazenado numa lista suspensa ou criar uma consulta SQL. Para criar uma consulta, você deve usar o designer de consulta baseado em texto. Para mais informações, consulte Interface de utilizador do designer de consultas baseada em texto (Construtor de Relatórios).

Você pode especificar procedimentos armazenados que retornam apenas um conjunto de resultados. Consultas baseadas em cursor não são suportadas.

Parâmetros

Se a consulta incluir variáveis de consulta, os parâmetros de relatório correspondentes serão gerados automaticamente. Esta extensão suporta parâmetros nomeados. 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 Texto. Depois que os parâmetros de relatório forem criados, talvez seja necessário alterar os valores padrão. Para mais informações, consulte Parâmetros de relatório paginados no Construtor de Relatórios.

Observações

Antes de poder ligar uma fonte de dados da Oracle, o administrador do sistema deve instalar a versão do .NET Data Provider para a Oracle que suporta a recuperação de dados da base de dados da Oracle. Deve instalar o fornecedor de dados no mesmo computador do Construtor de Relatórios e também no servidor de relatórios.

Para obter mais informações, consulte os seguintes artigos:

• Configurar a fonte de dados Oracle para os Serviços de Relatórios SQL Server (SSDT e Servidor de Relatórios)
• Os Serviços de Relatórios não conseguem executar relatórios contra bases de dados Oracle

Extensões alternativas de dados

Pode recuperar dados de uma base de dados Oracle usando um tipo de fonte de dados OLE DB. Para mais informações, consulte o tipo de ligação OLE DB (SSRS).

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

Para mais informações sobre suporte a plataformas e versões, consulte Fontes de Dados suportadas pelos Serviços de Relatórios (SSRS).

Conteúdo relacionado

• Parâmetros de relatórios paginados no Construtor de Relatórios
• Filtrar, agrupar e ordenar dados em relatórios paginados do Construtor de Relatórios
• Expressões num relatório paginado (Construtor de Relatórios)