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:
在 Oracle 下載網站上,安裝 Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32 位元)。
向 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
將 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:
在 Oracle 下載網站上,安裝 Oracle 64-bit ODAC Oracle Universal Installer (OUI)。
向 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
將 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 或更新版本,請將查詢類型設定為文字,並內嵌呼叫預存程式,如下列範例所示。
DECLARE OUT_RPT_DATA SYS_REFCURSOR;
BEGIN
SYSTEM.<Procedure_Name>(OUT_RPT_DATA);
DBMS_SQL.RETURN_RESULT(OUT_RPT_DATA);
END;
平臺和版本資訊
如需平臺和版本支援的詳細資訊,請參閱 Power BI 編頁報表支持的數據源。
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應