Tipo de conexão Oracle (SSRS e Servidor de Relatórios do Power BI)
Aplica-se a:
SQL Server 2016 (13.x) Reporting Services e posterior Construtor de Relatórios do Power BI 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 (Construtor de Relatórios 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 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. Essas etapas pressupõem que você instalou 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). Siga estas etapas para registrar o ODP.NET Gerenciado:
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.dllAdicione 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. Siga estas etapas para registrar o ODP.NET Não Gerenciado:
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.dllAdicione 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 Construtor de Relatórios da Microsoft usa o ODP.NET Gerenciado para criar relatórios paginados (RDL). Você só precisa das etapas a seguir ao usar 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. Essas etapas consideram que você já instalou os arquivos ODAC 18.x na pasta c:\oracle32 em que o Construtor de Relatórios da Microsoft está instalado. Siga estas etapas para registrar o ODP.NET Gerenciado:
No site de download da Oracle, instale o "ODAC com Oracle Developer Tools for Visual Studio – OUI" (32 bits).
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.dllAdicione 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 Construtor de Relatórios da Microsoft acima.
O Power BI Report Builder usa o ODP.NET Gerenciado para criar relatórios paginados (RDL). Você só precisa das etapas a seguir ao usar 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. Essas etapas consideram que você já instalou os arquivos ODAC 18.x na pasta c:\oracle64 em que o Power BI Report Builder está instalado. Siga estas etapas para registrar o ODP.NET Gerenciado:
No site de download da Oracle, instale o OUI (Instalador Universal Oracle) ODAC de 64 bits da Oracle.
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.dllAdicione 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 ao usar 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. Estas etapas pressupõem que você instalou 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. Siga estas etapas para registrar o ODP.NET Não Gerenciado:
Power BI Desktop de 64 bits
No site de download da Oracle, instale o OUI (Instalador Universal Oracle) ODAC de 64 bits da Oracle.
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.dllAdicione 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
No site de download da Oracle, instale o "ODAC com Oracle Developer Tools for Visual Studio – OUI" (32 bits).
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.dllAdicione 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 o 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 ver mais exemplos de cadeias de conexão, confira Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS.
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 Baseadas em Texto (Construtor de Relatórios).
É possível especificar procedimentos armazenados que retornem 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. Essa extensão dá 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, confira Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).
Comentários
Para que você possa se conectar a uma fonte de dados Oracle, o administrador do sistema deve ter instalado a versão do .NET Data Provider for Oracle que dê suporte à recuperação de dados do banco de dados Oracle. O provedor de dados deve ser instalado no mesmo computador que o Construtor de Relatórios e também no servidor de relatório.
Para obter mais informações, consulte os seguintes artigos:
- Como usar o Reporting Services para configurar e acessar uma fonte de dados Oracle
- Como adicionar permissões à entidade de segurança de NETWORK SERVICE
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, confira Tipo de conexão OLE DB (SSRS).
Modelos de relatório
Também é possível criar modelos com base em um banco de dados Oracle.
Informações sobre plataforma e versão
Saiba mais sobre suporte de versão e plataforma em Fontes de dados com suporte no Reporting Services (SSRS).
Consulte Também
Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios)
Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS)
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de