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 het OraProvCfg.exe hulpprogramma van Oracle gebruiken om de beheerde en niet-beheerde ODP.NET stuurprogramma's van Oracle te registreren, worden geleverd 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:
Installeer op de Downloadsite van Oracle de Oracle ODAC met Oracle Developer Tools for Visual Studio - OUI (32-bits).
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
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:
Installeer op de Oracle-downloadsite de Oracle 64-bits ODAC Oracle Universal Installer (OUI).
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
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.
Referentie
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.
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.