Share via

Oracle-Verbindungstyp (Power BI Report Builder)

  • Artikel

GILT FÜR:️ Power BI Report Builder ️Power BI Desktop

Wenn Sie Daten aus einer Oracle-Datenbank im Bericht verwenden möchten, benötigen Sie ein Dataset, das auf einer Berichtsdatenquelle vom Typ "Oracle" basiert. Dieser integrierte Datenquellentyp verwendet direkt den Oracle-Datenanbieter und erfordert eine Oracle-Clientsoftwarekomponente. In diesem Artikel wird erläutert, wie Sie Treiber für den Power BI Report Builder herunterladen und installieren.

Wichtig

Die folgenden Befehle, die das OraProvCfg.exe-Tool von Oracle verwendet, um die (nicht) verwalteten ODP.NET-Treiber von Oracle zu registrieren, können als Beispiele für die oben genannten Microsoft-Produkte verwendet werden. Für die Konfiguration der ODP.NET-Treiber, die für Ihre Umgebung spezifisch sind, müssen Sie sich möglicherweise an den Oracle-Support wenden oder die Oracle-Dokumentation zum Konfigurieren eines Oracle-Datenanbieters für .NET lesen.

32-Bit-Treiber für den Power BI Report Builder

Der Power BI-Berichts-Generator verwendet für die Erstellung paginierter Berichte eine verwaltete ODP.NET-Instanz. Die folgenden Schritte sind nur erforderlich, wenn Sie Oracle ODAC-Treiber der Version 12.2 oder höher verwenden. Andernfalls werden sie bei einer neuen Oracle-Installation standardmäßig in einer nicht für den gesamten Computer geltenden Konfiguration installiert. Bei diesen Schritten wird davon ausgegangen, dass Sie die ODAC 18.x-Dateien im Ordner „c:\oracle32“ installiert haben, in dem der Power BI Report Builder installiert ist. Führen Sie diese Schritte aus, um eine verwaltete ODP.NET-Instanz zu registrieren:

  1. Installieren Sie über die Oracle-Downloadwebsite „ODAC with Oracle Developer Tools for Visual Studio – OUI“ von Oracle (32-Bit).

  2. Registrieren Sie ODP.NET Managed Client bei 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. Fügen Sie ODP.NET Managed Client-Einträge zu „machine.config“ hinzu:

    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-Bit-Treiber für Power BI-Berichts-Generator

Hinweis

Die folgenden Anweisungen gelten für den Power BI-Berichts-Generator ab Version 15.7.01678.0001. Befolgen Sie für Versionen vor 15.7.01678.0001 die Anweisungen unter 32-Bit-Treiber für den Power BI Report Builder oben.

Der Power BI-Berichts-Generator verwendet für die Erstellung paginierter Berichte eine verwaltete ODP.NET-Instanz. Die folgenden Schritte sind nur erforderlich, wenn Sie Oracle ODAC-Treiber der Version 12.2 oder höher verwenden. Andernfalls werden sie bei einer neuen Oracle-Installation standardmäßig in einer nicht für den gesamten Computer geltenden Konfiguration installiert. Bei diesen Schritten wird davon ausgegangen, dass Sie die ODAC 18.x-Dateien im Ordner „c:\oracle64“ installiert haben, in dem auch der Power BI-Berichts-Generator installiert ist. Führen Sie diese Schritte aus, um eine verwaltete ODP.NET-Instanz zu registrieren:

  1. Installieren Sie den Oracle 64-Bit ODAC Oracle Universal Installer (OUI) von der Oracle-Downloadwebsite.

  2. Registrieren Sie ODP.NET Managed Client bei 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. Fügen Sie ODP.NET Managed Client-Einträge zu „machine.config“ hinzu:

    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

Verbindungszeichenfolge

Erfragen Sie bei Ihrem Datenbankadministrator die Verbindungsinformationen und die Anmeldeinformationen, die verwendet werden sollen, um eine Verbindung mit der Datenquelle herzustellen. In der Verbindungszeichenfolge im folgenden Beispiel wird eine Oracle-Datenbank auf dem Server "Oracle18" im Unicode-Format angegeben. Der Servername muss mit dem in der Konfigurationsdatei "Tnsnames.ora" definierten Oracle-Serverinstanzname übereinstimmen.

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

Weitere Beispiele für Verbindungszeichenfolgen finden Sie unter Erstellen von Datenverbindungszeichenfolgen: Power BI Report Builder.

Anmeldeinformationen

Anmeldeinformationen sind erforderlich, um Abfragen auszuführen und den Bericht lokal oder im Power BI-Webportal in der Vorschau anzuzeigen.

Nachdem Sie Ihren Bericht veröffentlicht haben, müssen Sie ihn möglicherweise an eine Power BI-Gatewayverbindung binden. Weitere Informationen finden Sie unter Verwalten der Datenquelle – Oracle.

Abfragen

Sie können ein Dataset erstellen, indem Sie in einer Dropdownliste eine gespeicherte Prozedur auswählen oder eine SQL-Abfrage erstellen. Zum Erstellen einer Abfrage muss der textbasierte Abfrage-Designer verwendet werden. Weitere Informationen finden Sie unter Benutzeroberfläche des textbasierten Abfrage-Designers (Power BI Report Builder)

Sie können gespeicherte Prozeduren angeben, die nur ein Resultset zurückgeben. Cursorbasierte Abfragen werden nicht unterstützt.

Parameter

Wenn die Abfrage Abfragevariablen enthält, werden automatisch entsprechende Berichtsparameter generiert. Benannte Parameter werden von dieser Erweiterung unterstützt. Für Oracle Version 9 oder höher werden Mehrwertparameter unterstützt.

Berichtsparameter werden mit Standardeigenschaftswerten erstellt, die Sie ggf. ändern müssen. Jeder Berichtsparameter ist z. B. vom Datentyp Text. Die Standardwerte müssen möglicherweise nach dem Erstellen der Berichtsparameter geändert werden.

Überlegungen und Einschränkungen

Bevor Sie eine Verbindung mit einer Oracle-Datenquelle herstellen können, muss der Systemadministrator die Version des .NET-Datenanbieters für Oracle installieren, die das Abrufen von Daten aus der Oracle-Datenbank unterstützt. Dieser Datenanbieter muss auf demselben Computer installiert werden wie Power BI Report Builder sowie auf dem Computer, der das Power BI-Gateway hostet. Weitere Informationen finden Sie unter Verwalten der Datenquelle – Oracle.

Problemumgehung für das Aufrufen gespeicherter Prozeduren

Wenn Sie eine Oracle-Datenquelle verwenden und für den paginierten Bericht der Abfragetyp „Gespeicherte Prozedur” festgelegt ist, kann der Bericht aufgrund einer Power BI Gateway-Einschränkung nicht im Power BI-Dienst ausgeführt werden. Wenn Sie Oracle 12 oder höher verwenden, legen Sie als Problemumgehung den Abfragetyp auf „Text” fest, und rufen Sie die gespeicherte Prozedur inline auf, wie im folgenden Beispiel gezeigt.

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;

Plattform- und Versionsinformationen

Weitere Informationen zur Plattform- und Versionsunterstützung finden Sie unter Unterstützte Datenquellen für paginierte Power BI-Berichte.

Zugehöriger Inhalt