Share via


Oracle-verbindingstype (Power BI Report Builder)

VAN TOEPASSING OP: Power BI Report Builder Power BI Desktop

Als u gegevens uit een Oracle-database in uw rapport wilt gebruiken, moet u een gegevensset hebben die is gebaseerd op een rapportgegevensbron van het type Oracle. Dit ingebouwde gegevensbrontype maakt rechtstreeks gebruik van de Oracle-gegevensprovider en vereist een Oracle-clientsoftwareonderdeel. In dit artikel wordt uitgelegd hoe u stuurprogramma's voor Power BI Report Builder downloadt en installeert.

Belangrijk

De volgende opdrachten die gebruikmaken van het OraProvCfg.exe-hulpprogramma van Oracle om de stuurprogramma's beheerde en niet-beheerde ODP.NET van Oracle te registreren, worden gegeven als voorbeelden voor gebruik met de bovenstaande Microsoft-producten. Voor de configuratie van de ODP.NET stuurprogramma's die specifiek zijn voor uw omgeving, moet u mogelijk contact opnemen met de oracle-ondersteuning of verwijzen naar de documentatie van Oracle voor het configureren van Oracle Data Provider voor .NET.

32-bits stuurprogramma's voor Power BI Report Builder

Power BI Report Builder maakt gebruik van Beheerde ODP.NET voor het ontwerpen van gepagineerde (RDL)-rapporten. U hebt alleen de volgende stappen nodig wanneer u Oracle ODAC-stuurprogramma's 12.2 en hoger gebruikt. Anders worden ze standaard geïnstalleerd op een niet-machinebrede configuratie voor een nieuwe Oracle-thuisinstallatie. Bij deze stappen wordt ervan uitgegaan dat u de ODAC 18.x-bestanden hebt geïnstalleerd in de map c:\oracle32 waarop Power BI Report Builder is geïnstalleerd. Volg deze stappen om Managed ODP.NET te registreren:

  1. Installeer op de Downloadsite van Oracle de Oracle ODAC met Oracle Developer Tools for Visual Studio - OUI (32-bits).

  2. Registreer ODP.NET Beheerde client bij 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. Voeg ODP.NET beheerde clientvermeldingen toe aan 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
    

64-bits stuurprogramma's voor Power BI Report Builder

Notitie

De volgende instructies zijn van toepassing op Power BI Report Builder versie 15.7.01678.0001 en hoger. Voor versies vóór 15.7.01678.0001 volgt u de 32-bits stuurprogramma's voor power BI Report Builder-instructies hierboven.

Power BI Report Builder maakt gebruik van Beheerde ODP.NET voor het ontwerpen van gepagineerde (RDL)-rapporten. U hebt alleen de volgende stappen nodig wanneer u Oracle ODAC-stuurprogramma's 12.2 en hoger gebruikt. Anders worden ze standaard geïnstalleerd op een niet-machinebrede configuratie voor een nieuwe Oracle-thuisinstallatie. Bij deze stappen wordt ervan uitgegaan dat u de ODAC 18.x-bestanden hebt geïnstalleerd in de map c:\oracle64 waarin Power BI Report Builder is geïnstalleerd. Volg deze stappen om Managed ODP.NET te registreren:

  1. Installeer op de Oracle-downloadsite de Oracle 64-bits ODAC Oracle Universal Installer (OUI).

  2. Registreer ODP.NET Beheerde client bij 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. Voeg ODP.NET beheerde clientvermeldingen toe aan 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

Neem contact op met de databasebeheerder voor verbindingsgegevens en de referenties die u wilt gebruiken om verbinding te maken met de gegevensbron. In het volgende verbindingsreeks voorbeeld wordt een Oracle-database opgegeven op de server met de naam Oracle18 met Unicode. De servernaam moet overeenkomen met wat is gedefinieerd in het configuratiebestand Tnsnames.ora als de naam van het Oracle-serverexemplaren.

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

Zie Gegevens verbindingsreeks s maken - Power BI Report Builder voor meer verbindingsreeks voorbeelden.

Referenties

Referenties zijn vereist om query's uit te voeren, om lokaal een voorbeeld van het rapport te bekijken en om een voorbeeld van het rapport te bekijken in de Power BI-webportal.

Nadat u het rapport hebt gepubliceerd, moet u het mogelijk verbinden met een Power BI Gateway-verbinding. Zie Uw gegevensbron beheren - Oracle voor meer informatie

Query's

Als u een gegevensset wilt maken, kunt u een opgeslagen procedure selecteren in een vervolgkeuzelijst of een SQL-query maken. Als u een query wilt maken, moet u de ontwerpfunctie voor query's op basis van tekst gebruiken. Zie De gebruikersinterface van De ontwerpfunctie voor query's op basis van tekst (Power BI Report Builder) voor meer informatie.

U kunt opgeslagen procedures opgeven die slechts één resultatenset retourneren. Het gebruik van query's op basis van cursors wordt niet ondersteund.

Parameters

Als de query queryvariabelen bevat, worden bijbehorende rapportparameters automatisch gegenereerd. Benoemde parameters worden ondersteund door deze extensie. Voor Oracle versie 9 of hoger worden parameters met meerdere waarden ondersteund.

Rapportparameters worden gemaakt met standaardeigenschapswaarden die u mogelijk moet wijzigen. Elke rapportparameter is bijvoorbeeld gegevenstype Tekst. Nadat de rapportparameters zijn gemaakt, moet u mogelijk de standaardwaarden wijzigen.

Overwegingen en beperkingen

Voordat u verbinding kunt maken met een Oracle-gegevensbron, moet de systeembeheerder de versie van de .NET-gegevensprovider voor Oracle hebben geïnstalleerd die ondersteuning biedt voor het ophalen van gegevens uit de Oracle-database. Deze gegevensprovider moet zijn geïnstalleerd op dezelfde computer als Power BI Report Builder en ook op computers waarop Power BI Gateway wordt gehost. Zie Uw gegevensbron beheren - Oracle voor meer informatie.

Tijdelijke oplossing voor het aanroepen van opgeslagen procedures

Wanneer u een Oracle-gegevensbron gebruikt en het gepagineerde rapport een querytype heeft ingesteld als Opgeslagen procedure, kan het niet worden uitgevoerd in de Power BI-service vanwege een beperking van Power BI Gateway. Als tijdelijke oplossing, als u Oracle 12 of hoger gebruikt, stelt u het querytype in op tekst en roept u de opgeslagen procedure inline aan, zoals in het volgende voorbeeld.

Screenshot of the Dataset properties dialog.

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

Platform- en versiegegevens

Zie Ondersteunde gegevensbronnen voor gepagineerde Power BI-rapporten voor meer informatie over platform- en versieondersteuning.