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 da 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:
No site de download da Oracle, instale o Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32 bits).
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.dllAdicione 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:
No site de download do Oracle, instale o Oracle ODAC Oracle Universal Installer (OUI) de 64 bits.
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.dllAdicione 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
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários