Compartilhar via

Configurar o tipo de conexão Oracle com SSRS e um servidor de relatório do Power BI

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) Reporting Services e versões posteriores Power BI Report Builder Servidor de Relatórios do Power BI

Para usar dados de um banco de dados Oracle no seu relatório, é necessário ter um conjunto de dados baseado na fonte de dados do relatório do tipo Oracle. Esse tipo de fonte de dados interno usa o Provedor de Dados Oracle diretamente e exige um componente do software cliente Oracle. Este artigo explica como baixar e instalar drivers para o Reporting Services, o Servidor de Relatórios do Power BI, o Construtor de Relatórios e o Power BI Desktop.

Use as informações neste artigo para criar uma fonte de dados. Para ver instruções passo a passo, confira Adicionar e verificar uma conexão de dados (Report Builder e SSRS).

Importante

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

Drivers de 64 bits para os servidores de relatório

No site de download da Oracle, instale o OUI (Instalador Universal Oracle) ODAC de 64 bits da Oracle. Você só precisa das etapas a seguir ao usar os drivers do 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 todo o computador para uma nova instalação inicial do Oracle.

Pré-requisito: instalar os arquivos ODAC 18.x na pasta c:\oracle64.

Relatórios paginados (RDL) usam o ODP.NET Gerenciado

O Servidor de Relatórios do Power BI e o SQL Server Reporting Services 2016 e posteriores usam o ODP.NET Gerenciado para relatórios paginados (RDL).

Registrar ODP.NET gerenciado:

  1. Registre cliente do ODP.NET cliente gerenciado no GAC (Cache de Assembly Global):

    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 entradas do cliente gerenciado ODP.NET 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

Os relatórios do Power BI usam o ODP.NET não gerenciado

O Servidor de Relatórios do Power BI usa o ODP.NET Não Gerenciado para relatórios do Power BI.

Registrar ODP.NET não gerenciado:

  1. Registre o cliente não gerenciado ODP.NET 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\bin\4\Oracle.DataAccess.dll

  2. Adicione entradas de cliente não gerenciado ODP.NET a 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 Construtor de Relatórios da Microsoft

O Microsoft Report Builder usa o ODP.NET Gerenciado para criar relatórios paginados (RDL). Você só precisa das etapas a seguir para os drivers ODAC 12.2 e posteriores da Oracle. Caso contrário, eles são instalados por padrão em uma configuração que não abrange todo o computador para uma nova instalação inicial do Oracle.

Pré-requisito: instalar os arquivos ODAC 18.x na pasta c:\oracle32 em que o Microsoft Report Builder está instalado.

Registrar ODP.NET gerenciado:

  1. Instale o "ODAC com Oracle Developer Tools for Visual Studio – OUI" (32 bits) no site de download da Oracle.

  2. Registre o cliente gerenciado ODP.NET 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 entradas do cliente gerenciado ODP.NET 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 Power BI Report Builder

Observação

As instruções a seguir se aplicam ao Power BI Report Builder versão 15.7.01678.0001 e posteriores. Para versões anteriores à 15.7.01678.0001, siga as instruções de Drivers de 32 bits para o Microsoft Report Builder.

O Power BI Report Builder usa o ODP.NET Gerenciado para criar relatórios paginados (RDL). Você só precisa das etapas a seguir para os drivers ODAC 12.2 e posteriores da Oracle. Caso contrário, eles são instalados por padrão em uma configuração que não abrange todo o computador para uma nova instalação inicial do Oracle.

Pré-requisito: instalar os arquivos ODAC 18.x na pasta c:\oracle64 em que o Power BI Report Builder está instalado.

Registrar ODP.NET gerenciado:

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

  2. Registre o cliente gerenciado ODP.NET 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 entradas do cliente gerenciado ODP.NET 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

Drivers de 64 bits e 32 bits para o Power BI Desktop

O Power BI Desktop usa o ODP.NET Não Gerenciado para a criação de relatórios do Power BI. Você só precisa das etapas a seguir para os drivers ODAC 12.2 e posteriores da Oracle. Caso contrário, eles são instalados por padrão em uma configuração que não abrange todo o computador para uma nova instalação inicial do Oracle.

Pré-requisito: instalar os arquivos 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.

Registrar ODP.NET não gerenciado:

Power BI Desktop de 64 bits

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

  2. Registre o cliente não gerenciado ODP.NET 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\bin\4\Oracle.DataAccess.dll

  3. Adicione entradas de cliente não gerenciado ODP.NET a 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 "ODAC com Oracle Developer Tools for Visual Studio – OUI" (32 bits) no site de download da Oracle.

  2. Registre o cliente não gerenciado ODP.NET 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\bin\4\Oracle.DataAccess.dll

  3. Adicione entradas de cliente não gerenciado ODP.NET a 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 conexão

Contate o administrador do banco de dados para obter informações sobre a conexão e as credenciais que devem ser 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 com Unicode. O nome do servidor deve coincidir com a definição no arquivo de configuração Tnsnames.ora como o nome da instância do servidor Oracle.

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

Para ver mais exemplos de cadeias de conexão, consulte Criar cadeias de conexão de dados – Report Builder.

Credenciais

As credenciais são necessárias para executar consultas, visualizar o relatório localmente e visualizá-lo no servidor de relatório.

Após a publicação do relatório, talvez seja necessário alterar as credenciais da fonte de dados para que, quando o relatório for executado no servidor de relatório, as permissões recuperadas sejam válidas.

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

Consultas

Para criar um conjunto de dados, você pode selecionar um procedimento armazenado na lista suspensa ou criar uma consulta SQL. Para criar uma consulta, use o designer de consulta baseado em texto. Para obter mais informações, confira Interface do usuário do Designer de Consultas baseada em texto (Report Builder).

É possível especificar procedimentos armazenados que retornem apenas um conjunto de resultados. Não há suporte ao 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. Essa extensão oferece suporte a parâmetros nomeados. Para o 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 precisem ser modificados. 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 obter mais informações, consulteParâmetros de relatório paginado (Report Builder).

Comentários

Para que você possa se conectar a uma fonte de dados Oracle, o administrador do sistema deverá instalar a versão do .NET Data Provider for Oracle que oferece suporte à recuperação de dados do banco de dados Oracle. Você deve instalar o provedor de dados no mesmo computador que o Report Builder e também no servidor de relatório.

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

Extensões de dados alternativas

Você também pode recuperar dados de um banco de dados Oracle com o uso de um tipo de fonte de dados OLE DB. Para obter mais informações, consulte Tipo de conexão OLE DB (SSRS).

Modelos de relatório

Você pode criar modelos com base em um banco de dados Oracle.

Informações de plataforma e versão

Para obter mais informações sobre suporte a plataformas e versões, consulte Fontes de dados com suporte no Reporting Services (SSRS).

Conteúdo relacionado