分享方式:


Oracle 連線類型 (Power BI 報表產生器)

適用於:Power BI 報表產生器 Power BI Desktop

若要在報表中使用來自 Oracle 資料庫的資料,您必須具有以 Oracle 類型的報表資料來源為基礎的資料集。 此內建資料來源類型會直接使用 Oracle 資料提供者,並且需要 Oracle 用戶端軟體元件。 本文說明如何下載並安裝Power BI 報表產生器的驅動程式。

重要

下列提供的命令使用 Oracle 的 OraProvCfg.exe 工具來註冊 Oracle 受控和非受控 ODP.NET 驅動程式,可作為搭配上述 Microsoft 產品使用的範例。 若要設定環境特定的 ODP.NET 驅動程式,您可能需要連絡 Oracle 支援人員,或參考 Oracle 的文件:Configuring Oracle Data Provider for .NET (設定 Oracle Data Provider for .NET)。

Power BI 報表產生器 的 32 位驅動程式

Power BI 報表產生器使用受控 ODP.NET 來撰寫編頁 (RDL) 報表。 只有在使用 Oracle ODAC 驅動程式 12.2 和更新版本時,才需要執行下列步驟。 否則,預設會對新 Oracle 主目錄的非電腦全域組態安裝這些驅動程式。 這些步驟假設您已將 ODAC 18.x 檔案安裝到安裝 Power BI 報表產生器 的 c:\oracle32 資料夾。 請遵循這些步驟來註冊受控 ODP.NET:

  1. 在 Oracle 下載網站上,安裝 Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32 位元)

  2. 向 GAC 註冊 ODP.NET 受控用戶端:

    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. 將 ODP.NET 受控用戶端項目新增至 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
    

適用於 Power BI 報表產生器的 64 位元驅動程式

注意

下列指示適用於 Power BI 報表產生器版本 15.7.01678.0001 和更新版本。 針對 15.7.01678.0001 之前的版本,請遵循上述 Power BI 的 32 位驅動程式 報表產生器 指示。

Power BI 報表產生器使用受控 ODP.NET 來撰寫編頁 (RDL) 報表。 只有在使用 Oracle ODAC 驅動程式 12.2 和更新版本時,才需要執行下列步驟。 否則,預設會對新 Oracle 主目錄的非電腦全域組態安裝這些驅動程式。 這些步驟假設您已將 ODAC 18.x 檔案安裝至 Power BI 報表產生器安裝所在的 c:\oracle64 資料夾。 請遵循這些步驟來註冊受控 ODP.NET:

  1. 在 Oracle 下載網站上,安裝 Oracle 64-bit ODAC Oracle Universal Installer (OUI)

  2. 向 GAC 註冊 ODP.NET 受控用戶端:

    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. 將 ODP.NET 受控用戶端項目新增至 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

請洽詢資料庫管理員,以取得用來連接資料來源的連接資訊和認證。 下列連接字串範例會使用 Unicode 來指定名為 "Oracle18" 之伺服器上的 Oracle 資料庫。 伺服器名稱必須符合 Tnsnames.ora 組態檔中定義為 Oracle 伺服器執行個體名稱的內容。

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

如需更多 連接字串 範例,請參閱建立數據 連接字串 - Power BI 報表產生器

認證

需要認證才能執行查詢、在本機預覽報表,以及在Power BI入口網站上預覽報表。

發佈報表之後,您可能需要將它系結至 Power BI 網關聯機。 如需詳細資訊,請參閱 管理您的數據源 - Oracle

查詢

若要建立資料集,您可以從下拉式清單中選取預存程序,或是建立 SQL 查詢。 若要建立查詢,您必須使用以文字為基礎的查詢設計工具。 如需詳細資訊,請參閱以文字為基礎的查詢設計工具使用者介面(Power BI 報表產生器)。

您可以指定只傳回一個結果集的預存程序。 不支援使用數據指標型查詢。

參數

如果查詢包含查詢變數,就會自動產生對應的報表參數。 此延伸模組支援具名參數。 針對 Oracle 第 9 版或更新版本,支援多重值參數。

報表參數是透過預設屬性值建立,您可能會需要修改這些值。 例如,每一個報表參數的資料類型都是 [文字]。 建立報表參數後,您可能必須變更預設值。

考量與限制

系統管理員必須先安裝支援從 Oracle 資料庫擷取資料的 .NET Data Provider for Oracle 版本,您才能夠連接 Oracle 資料來源。 此數據提供者必須安裝在與 Power BI 報表產生器 相同的電腦上,以及裝載 Power BI 閘道的電腦上。 如需詳細資訊,請參閱 管理您的數據源 - Oracle

呼叫預存程式的因應措施

當您使用 Oracle 資料源時,如果編頁報表的查詢類型設定為預存程式,則因為 Power BI 閘道限制而無法在 Power BI 服務 中執行。 因應措施是,如果您使用 Oracle 12 或更新版本,請將查詢類型設定為文字,並內嵌呼叫預存程式,如下列範例所示。

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;

平臺和版本資訊

如需平臺和版本支援的詳細資訊,請參閱 Power BI 編頁報表支持的數據源。