Oracle Database

  • 發行項

摘要

項目 說明
發行狀態 正式發行
產品 Excel
Power BI （語意模型）
Power BI （數據流）
網狀架構 （資料流 Gen2）
Power Apps （數據流）
Dynamics 365 Customer Insights
Analysis Services
支援的驗證類型 Windows （桌面/在線）
資料庫 （桌面）
基本 （線上）
Microsoft 帳戶 （桌面版）
函式參考檔 Oracle.Database

注意

某些功能可能會存在於一個產品中，但由於部署排程和主機特定功能，而不存在其他功能。

必要條件

支援的 Oracle 版本：

  • Oracle 資料庫伺服器 12c （12.1.0.2） 和更新版本
  • Oracle 自發資料庫 - 所有版本

您必須先安裝 Oracle Client for Microsoft Tools （OCMT），才能使用 Power Query 連線到 Oracle 資料庫。

若要使用 內部部署數據閘道連線到 Oracle 資料庫，必須在執行閘道的電腦上安裝 64 位 OCMT。 如需詳細資訊，請移至 管理您的數據源 - Oracle。

支援的功能

  • Import
  • DirectQuery （Power BI 語意模型）
  • 進階選項
    • 以分鐘為單位的命令逾時
    • SQL statement
    • 包含關聯性資料行
    • 使用完整階層架構巡覽

下載並安裝 Oracle Client for Microsoft Tools

Oracle Client for Microsoft Tools 會安裝及設定 Oracle Data Provider for .NET （ODP.NET），以支援 32 位和 64 位的 Microsoft 工具連線與 Oracle 內部部署和雲端資料庫，包括 Oracle 自發資料庫（ADB）。 OCMT 是一種圖形化安裝程式，可自動化 Oracle 資料庫用戶端安裝程式。 它支援使用 Power BI Desktop、Power BI 服務、Fabric（Dataflow Gen2）、Excel、SQL Server Analysis Services、SQL Server Data Tools、SQL Server Integration Services、SQL Server Reporting Services 和 BizTalk Server 進行聯機。

OCMT 是免費的軟體。 您可以從 Oracle Client for Microsoft Tools 頁面下載。 針對 64 位 Power BI Desktop 和 Power BI 服務，請使用 64 位 OCMT。 針對 32 位 Power BI Desktop，請使用 32 位 OCMT。

即使您已在Power BI用戶端上安裝Oracle用戶端或 ODP.NET，強烈建議您使用OCMT安裝程序正確完成Power BI 需要使用Oracle 資料庫的所有設定步驟。

從 Power Query Desktop 連線 至內部部署 Oracle 資料庫

若要進行連線，請執行下列步驟：

  1. 在連接器選取範圍中選取 [ Oracle 資料庫] 選項。

  2. 指定 Oracle net service name/TNS 別名或 Easy 連線 （Plus） 連接字串 以在 Server 中連線。 簡單 連線 是最簡單的方式，方法是將 [伺服器] 值設定為 Oracle 資料庫伺服器 Hostname/ServiceName，其中 ServiceName 是全域資料庫名稱。 下列螢幕快照使用 net 服務名稱。

    輸入 Oracle 資料庫連線。

  3. 如果您要從 Power BI Desktop 連線，請選取 [匯入] 或 [DirectQuery 數據連線模式]。 這些範例步驟的其餘部分會使用匯入數據連線模式。 若要深入瞭解 DirectQuery，請移至 在 Power BI Desktop 中使用 DirectQuery。

  4. 如果您第一次連線到此 Oracle 資料庫，請選取要使用的驗證類型，然後輸入您的認證。 可用的驗證類型如下：

    • Windows （Windows 驗證）
    • 資料庫 （使用者名稱與密碼 ）
    • Microsoft 帳戶 （Microsoft Entra ID）

    如需驗證的詳細資訊，請移至 使用數據源進行驗證。

    輸入您的 Oracle 資料庫認證。

  5. 在 [導覽器] 中，選取您需要的數據，然後選取 [載入 ] 以載入資料或 [轉換數據 ] 來轉換數據。

從 Power Query Online 連線 至內部部署 Oracle 資料庫

若要進行連線，請執行下列步驟：

  1. 安裝及設定內部部署數據閘道。

  2. 從 Power Query Online 中，選取 數據源選取專案中的 [Oracle 資料庫 ] 選項。

  3. 在出現的 [Oracle 資料庫] 對話框中，指定 Oracle net service name/TNS 別名、Easy 連線 Plus 連接字串，或連接描述項以在 Server 中聯機。

    輸入 Oracle 資料庫線上連線。

  4. 提供 連線 名稱，例如 「testoracleserver」。

  5. 選取內部部署數據閘道的名稱。

    注意

    您必須選取此連接器的內部部署數據閘道，不論 Oracle 資料庫位於您的局域網路或網站上。

  6. 如果您第一次連線到此 Oracle 資料庫，請在 [驗證類型] 中選取連線的認證類型。 如果您打算使用 Oracle 使用者名稱和密碼登入，請選擇 [基本 ]。 使用 Windows 作業系統驗證時，選擇 Windows，並使用在 Windows 上執行的 Oracle 用戶端和伺服器。

  7. 輸入您的認證。

  8. 選取下一步以繼續。

  9. 在 [導覽器] 中，選取您需要的數據，然後選取 [轉換數據] 以轉換 Power Query 編輯器 中的數據。

連線 至 Oracle 自發資料庫

注意

目前，您可以使用本節中的程式，從 Excel、Power BI Desktop、Power BI 服務、Fabric（Dataflow Gen2）、Power Apps、SQL Server Analysis Services 和 BizTalk Server 聯機到 Oracle 自發資料庫。 這些工具會使用 Unmanaged ODP.NET 進行連線。 其他 Microsoft 工具，包括 SQL Server Data Tools、SQL Server Integration Services 和 SQL Server Reporting Services，都使用受控 ODP.NET，使用基本上類似的程式連接到 Oracle 自發資料庫。

若要將 Power BI 連線到 Oracle 自發資料庫，您需要下列帳戶和應用程式：

下載您的客戶端認證

設定 Oracle 自發資料庫連線的第一個步驟是下載您的客戶端認證。

若要下載您的客戶端認證：

  1. 在 Oracle 自發資料庫詳細數據頁面中，選取 [DB 連線 ion]。

    資料庫 連線。

  2. 從 [資料庫 連線 ion] 頁面中，選取 [下載錢包]。

    下載錢包。

  3. 輸入您想要搭配此錢包使用的密碼、確認密碼，然後選取 [ 下載]。

    錢包密碼。

設定 Oracle ADB 認證

  1. 在 Windows 電腦上，移至您從 [下載客戶端認證] 下載 Oracle ADB 認證的資料夾。

  2. 將認證解壓縮到您在 OCMT 中指定的目錄作為 Oracle 組態檔目錄。 在此範例中，認證會擷取至 c：\data\wallet\wallet_contosomart。

    將錢包檔案解壓縮到錢包資料夾中的影像。

    注意

    tnsnames.ora 檔案會定義您的 Oracle 自發資料庫地址和連線資訊。

  3. 在編輯器中開啟 sqlnet.ora，例如 記事本。

  4. 在 [WALLET_LOCATION] 底下，將 [目錄] 選項下您錢包資料夾的路徑變更為 。 在此範例中：

    WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

  5. 儲存並關閉 sqlnet.ora 檔案。

開啟錢包資料夾中的 tnsnames.ora 檔案。 檔案包含您可以連線的ADB net 服務名稱清單。 在此範例中，名稱是contosomart_high、contosomart_low和contosomart_medium。 您的ADB Net服務名稱不同。

具有三個範例 TNS 名稱、contosomart_high、contosomart_low和contosomart_medium的影像。

連線 Power BI Desktop 至 Oracle ADB

  1. 開啟 Power BI Desktop。

  2. 選取 [取得資料]。

  3. 從 [取得數據]，選取 [資料庫>Oracle 資料庫]。

  4. 輸入您要連線之 Oracle 自發資料庫伺服器的 net 服務名稱。 在此範例中 ，伺服器 是contosomart_high。 然後選取確定。

    [Oracle 資料庫] 對話框的影像，其中已選取contosomart_high作為伺服器名稱和匯入模式。

  5. 如果您是第一次從Power BI Desktop 登入此伺服器，系統會要求您輸入認證。 選取 [ 資料庫]，然後輸入 Oracle 資料庫的使用者名稱和密碼。 您在此處輸入的認證是您要連線之特定 Oracle 自發資料庫的使用者名稱和密碼。 在此範例中，會使用資料庫的初始系統管理員使用者名稱和密碼。 然後選取 [連線]。

    認證對話框的影像，其中已選取 [資料庫]，以及輸入的預設資料庫使用者名稱和密碼。

    注意

    您可以使用 Microsoft Entra 識別符驗證，透過 Microsoft 帳戶 選項登入 Oracle 自發資料庫。

此時， 導覽器 隨即出現並顯示連接數據。

開啟導覽器的影像，以及顯示其所有contosomart_high資料庫

您可能也會遇到數個錯誤之一，因為設定尚未正確設定。 這些錯誤會在疑難解答中討論。

此初始測試 中可能發生的一個錯誤發生在 Navigator 中，其中資料庫似乎已連線，但不包含任何數據。 相反地，Oracle：ORA-28759：無法開啟檔案錯誤會出現取代數據。

在頂端具有資料庫名稱的導覽器影像，但會出現錯誤，而不是數據。

如果發生此錯誤，請確定您在 sqlnet.ora 中提供的錢包資料夾路徑是錢包資料夾的完整且正確的路徑。

設定閘道

  1. 安裝及設定內部部署數據閘道。

  2. 在 Power BI 服務 中，選取右上方的齒輪圖示，然後選取 [管理網關]。

    開啟 Power BI 服務 影像、選取齒輪圖示，以及強調 [管理網關] 的 [管理網關] 功能表。

  3. 在 [新增數據源] 中，選取 [新增數據源] 以使用閘道。

    Power BI 服務 中 [新增數據源] 視窗的影像，其中已強調 [新增數據源] 以使用閘道。

  4. 在 [數據源名稱] 中，輸入您想要用來作為數據源設定的名稱。

  5. 在 [數據源類型] 中，選取 [Oracle]。

  6. 在 [伺服器] 中，輸入要連線之 Oracle 自發資料庫伺服器的 net 服務名稱。

  7. 在 [驗證方法] 中，選取 [ 基本]。

  8. 輸入 Oracle 自發資料庫的使用者名稱和密碼。 在此範例中，會使用預設資料庫管理員用戶名稱 （ADMIN） 和密碼。

  9. 選取 [新增]。

    [數據源 設定] 視窗的影像，其中已填入所有數據源設定。

如果所有專案都已正確安裝並設定，就會顯示 連線 成功訊息。 您現在可以使用從 Power Query Online 連線 至內部部署 Oracle 資料庫中所述的步驟，連線到 Oracle 自發資料庫。

使用進階選項 連線

Power Query Desktop 和 Power Query Online 提供一組進階選項，您可以視需要新增至查詢。

下表列出您可以在Power Query Desktop和Power Query Online 中設定的所有進階選項。

進階選項 描述
以分鐘為單位的命令逾時 如果您的連線持續超過 10 分鐘（預設逾時），您可以在幾分鐘內輸入另一個值，讓連線保持開啟時間更長。 此選項僅適用於Power Query Desktop。
SQL statement 如需詳細資訊，請移至 使用原生資料庫查詢從資料庫匯入數據。
包含關聯性資料行 如果核取，則包含可能與其他數據表有關聯性的數據行。 如果清除此方塊，就不會顯示這些數據行。
使用完整階層架構巡覽 如果核取，導覽器會顯示您要連線之資料庫中數據表的完整階層。 如果清除，導覽器只會顯示其數據行和數據列包含數據的數據表。

選取所需的進階選項之後，請在Power Query Desktop或Power Query Online 中選取 [確定]，以聯機到 Oracle 資料庫。

已知問題與限制

在將語意模型重新整理到該 Oracle 資料庫之後，Power BI 會話仍可在 Oracle 資料庫上使用約 30 分鐘。 只有在大約 30 分鐘之後，這些會話才會在 Oracle 資料庫上變成非使用中/移除。 這是依照設計的行為。

疑難排解

當命名語法不正確或未正確設定時，您可能會遇到 Oracle 中任何一個錯誤：

  • ORA-12154：TNS：無法解析指定的聯機標識碼。
  • ORA-12514：TNS：接聽程式目前不知道連線描述元中所要求的服務。
  • ORA-12541：TNS：沒有接聽程式。
  • ORA-12170：TNS：發生連線逾時。
  • ORA-12504：TNS：接聽程式未在 CONNECT_DATA 中指定SERVICE_NAME。

如果 Oracle tnsnames.ora 資料庫連接描述元設定錯誤、提供的 net 服務名稱拼錯，或 Oracle 資料庫接聽程式未執行或無法連線，例如封鎖接聽程式或資料庫埠的防火牆，可能會發生這些錯誤。 請確定您符合最低安裝必要條件。 其他資訊：先決條件

請流覽 Oracle 資料庫錯誤說明入口網站，以檢閱您遇到的特定 Oracle 錯誤常見原因和解決方法。 在入口網站搜尋列中輸入您的 Oracle 錯誤。

如果您從 Microsoft Store 下載 Power BI Desktop，可能會因為 Oracle 驅動程式問題而無法連線到 Oracle 資料庫。 如果您遇到此問題，傳回的錯誤訊息是： 未設定對象參考。 若要解決此問題，請執行下列動作：

  • 從下載中心下載 Power BI Desktop，而不是 Microsoft Store。

如果您使用內部部署數據網關聯機到 Oracle 資料庫時，對象參考未設定錯誤訊息，請遵循管理數據來源 - Oracle 中的指示。

如果您使用 Power BI 報表伺服器，請參閱 Oracle 連線 ion 類型一文中的指引。

下一步

在展開數據表數據行時優化Power Query