Oracle Database

總結

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

備註

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

先決條件

支援的 Oracle 版本：

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

從 2025 年 4 月版的 Power BI Desktop 及 2025 年 5 月的本地資料閘道開始，您可以使用內建的 Oracle 管理的 ODP.NET 驅動程式連接 Oracle 資料庫。啟用此功能後，你就不需要手動安裝 OCMT。自 2026 年 6 月起，您也可以建立與 Oracle Autonomous Database 或其他 Oracle 雲端端點的雲端連線，無需閘道。深入瞭解此功能。

如果你沒有使用內建的新 Oracle 驅動程式，必須使用企業本地資料閘道器，並在執行閘道器或 Power BI Desktop 的電腦上安裝 64 位元 Oracle Client for Microsoft Tools（OCMT）。如需詳細資訊，請參閱管理您的資料來源 - Oracle。

支援的功能

進口
DirectQuery （Power BI 語意模型）
進階選項
- 命令逾時時間（分鐘）
- SQL 語法
- 包含關聯性欄位
- 使用完整階層導航

使用 Oracle 用戶端 for Microsoft Tools （OCMT）選項

Oracle Client for Microsoft Tools 會安裝和設定 Oracle Data Provider for .NET （ODP.NET），以支援與 Oracle 內部部署和雲端資料庫的 32 位和 64 位Microsoft工具連線，包括 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 桌面和 Power BI 服務，請使用 64 位元的 OCMT。針對 32 位 Power BI Desktop，請使用 32 位 OCMT。

即使您已在 Power BI 用戶端上安裝 Oracle 用戶端或 ODP.NET，我們強烈建議您使用 OCMT 安裝程式來正確完成 Power BI 使用 Oracle 資料庫所需的所有組態步驟。

從 Power BI Desktop 連接本地 Oracle 資料庫

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

在連接器選取範圍中選取 [Oracle 資料庫] 選項。
指定 Oracle net 服務名稱/TNS 別名或 Easy Connect （Plus）連接字串，以在 伺服器中連線。 Easy Connect 是最簡單的方式，方法是將 [伺服器 ] 值設定為 Oracle 資料庫伺服器 Hostname/ServiceName，其中 ServiceName 是全域資料庫名稱。下列螢幕快照使用 net 服務名稱。
如果您要從 Power BI Desktop 連線，請選取 [匯入] 或 [DirectQuery 數據連線模式]。這些範例步驟的其餘部分會使用匯入數據連線模式。若要深入瞭解 DirectQuery，請移至在 Power BI Desktop 中使用 DirectQuery。
如果您第一次連線到此 Oracle 資料庫，請選取要使用的驗證類型，然後輸入您的認證。可用的驗證類型如下：
- Windows （Windows 驗證）
- 資料庫（使用者名稱與密碼）
- Microsoft帳戶（Microsoft Entra ID）
如需驗證的詳細資訊，請前往使用資料來源驗證。
在 Navigator中，選取您需要的數據，然後選取 [載入] [載入] 以載入數據，或 [轉換數據] 來轉換數據。

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

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

安裝及設定內部部署數據閘道。
從 Power Query Online 中，選取數據來源中的 Oracle 資料庫 選項。
在出現的 [Oracle 資料庫] 對話框中，指定 Oracle net service name/TNS 別名、Easy Connect Plus 連接字串，或連接描述元以連線到 伺服器。
提供 連線名稱，例如「testoracleserver」。
選取內部部署數據閘道的名稱。
如果您第一次連線到此 Oracle 資料庫，請在 [驗證類型] 中選取連線的認證類型。如果您打算使用 Oracle 使用者名稱和密碼登入，請選擇 [基本 ]。使用 Windows 作系統驗證時，選擇 Windows，並使用在 Windows 上執行的 Oracle 用戶端和伺服器。
輸入您的認證。
選取 下一步 以繼續。
在 [導覽器] 中，選取您需要的資料，然後選取 [轉換資料] 以轉換 Power Query 編輯器中的資料。

連接至 Oracle 自主資料庫

備註

目前，您可以使用本節中的程式，從 Excel、Power BI Desktop、Power BI Service、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.com 帳戶（Oracle.com 帳戶註冊）
Oracle 雲端帳戶（Oracle 雲端帳戶註冊）
Oracle 自發資料庫（取得永遠免費的自發資料庫）
Power BI Desktop （取得 Power BI Desktop）或 Power BI 服務帳戶（為組織中的使用者授權 Power BI 服務）

下載您的客戶端認證

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

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

在您的 Oracle 自發資料庫詳細數據頁面中，選取 [資料庫連線]。
從 [ 資料庫連線] 頁面，選取 [ 下載錢包]。
輸入您想要搭配此錢包使用的密碼、確認密碼，然後選取 [ 下載]。

設定 Oracle ADB 認證

在 Windows 電腦上，移至您從 [ 下載客戶端認證] 下載 Oracle ADB 認證的資料夾。
將認證解壓縮到您在 OCMT 中指定的目錄作為 Oracle 組態檔目錄。在此範例中，認證會擷取至 c：\data\wallet\wallet_contosomart。

備註

tnsnames.ora 檔案會定義您的 Oracle 自發資料庫地址和連線資訊。
在編輯軟體中開啟 sqlnet.ora，例如 Notepad。
在 [WALLET_LOCATION] 底下，將 [目錄] 選項下您錢包資料夾的路徑變更為。在此範例中：

WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))
儲存並關閉 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

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

備註

您可以使用 Microsoft Entra ID 驗證，透過 Microsoft 帳戶 選項登入 Oracle Autonomous Database。

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

開啟contosomart_high資料庫的「導航器」螢幕擷取畫面。

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

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

資料庫名稱位於頂端的導覽器的螢幕擷取畫面，但會顯示錯誤，而不是資料。

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

使用進階選項進行連線

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

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

進階選項	說明
命令逾時時間（分鐘）	如果您的連線持續超過 10 分鐘（預設逾時），您可以在幾分鐘內輸入另一個值，讓連線保持開啟時間更長。此選項僅適用於Power Query Desktop。
SQL 語法	如需詳細資訊，請移至使用原生資料庫查詢從資料庫匯入資料。
包含關聯性欄位	如果勾選，則會包含可能與其他資料表有關聯的欄位。如果清除此方塊，這些欄位就不會出現。
使用完整階層導航	如果勾選，導覽器會顯示您所連接資料庫中資料表的完整階層。在清除後，導覽器將只顯示包含數據的表格。

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

使用內建的 Oracle 驅動程式

針對 Power BI Desktop 的匯入模式

在 2026 年 6 月版本的 Power BI Desktop 或本地資料閘道器中，預設使用內建的 Oracle 管理的 ODP.NET 驅動程式來連接。這項功能可移除使用者安裝及管理驅動程式的必要條件。你仍然可以透過以下指示選擇退出此功能。

若不使用這個內建驅動程式，請在 Power BI Desktop 中切換到選項與設定（檔案標籤下的>選項>預覽功能），然後勾選啟用「使用捆綁的 Oracle Managed ODP Provider 以導入模式」選項。

在 Power BI Desktop 中使用配套的 Oracle 受控 ODP 提供者啟用選項的螢幕快照。

針對 Power BI Desktop 中的 DirectQuery 模式（預覽版）

對於 DirectQuery 模式，內建的 Oracle 管理的 ODP.NET 驅動程式仍處於預覽階段。若要選擇加入，請按照下列說明操作。

若要在 Power BI Desktop 中使用此內建驅動程式，請前往「選項與設定」（在檔案標籤頁下的>選項>預覽功能），然後勾選勾選框以啟用「使用捆綁的 Oracle Managed ODP Provider 以啟用 DirectQuery 模式」選項。

針對內部部署閘道器中的匯入模式

自 2026 年 6 月版本起，本地資料閘道預設使用內建的 Oracle 管理的 ODP.NET 驅動程式進行連線。若要避免在本地資料閘道器中使用此內建驅動程式來進行匯入模式，請透過以下步驟更改閘道設定以更新該設定：MashupFlight_DisableOracleBundledOdacProviderV2

在安裝內部部署數據閘道的本機電腦上，流覽至 C：\Program Files\On-premises 數據閘道。
備份名為 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config的組態檔。
開啟原始 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config 組態檔，並找出 MashupFlight_DisableOracleBundledOdacProviderV2 條目。
將值更新 MashupFlight_DisableOracleBundledOdacProviderV2 為 True。
重新啟動閘道。

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>

備註

一旦你更改 MashupFlight_DisableOracleBundledOdacProviderV2 了 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config 檔案中的設定，這個設定就會在本地資料閘道升級後持續存在。

備註

如果你的語意模型仍使用個人閘道連接本地 Oracle 資料來源，升級為企業本地資料閘道或虛擬網路（VNET）閘道，或將雲端 Oracle 工作負載轉移至直接雲端連線。 更新後的 Oracle 連接器不支援個人本地資料閘道，這同時適用於匯入模式和 DirectQuery 模式。現有的語意模型可以繼續使用個人閘道，直到你更新資料連線綁定。更新綁定後，你就不能回到個人閘道器了。請依此規劃你的 Oracle 連線升級。

用於本地閘道器的 DirectQuery 模式（預覽版）

本地資料閘道器可使用內建的 Oracle 管理 ODP.NET 驅動程式以支援 DirectQuery。這項功能處於預覽狀態。

要解析 DirectQuery 的 TNS 別名，請使用環境變數。閘道服務帳號無法存取使用者範圍的變數，因此請在系統（機器）範圍內設定 TNS_ADMIN ，然後重新啟動本地資料閘道服務。

內建驅動程式不支援 Oracle 代理使用者認證。更多資訊與解決方法，請參閱 Oracle 代理使用者認證不支援。

支援的 Oracle 內建驅動程式中指定 TNS_ADMIN 的方法

有三種選項可以指定TNS_ADMIN：

OADC.config中設定 TNS_ADMIN
使用環境變數
使用先前安裝的 OADC 設定

在 ODAC.config 中設定TNS_ADMIN

如果你使用內建的 Oracle 驅動程式，並擁有修改程式檔案的權限，你可以在 ODAC.config 檔案中指定 TNS_ADMIN，該檔案是內建 Oracle 驅動程式所使用的設定檔。該檔案位於 Power BI Desktop 或本地資料閘道安裝位置的「ADO.NET Providers」子資料夾下。以下是一個指定TNS_ADMIN路徑「C：\network\admin」的範例。

這個設定值優先於其他選項。

範例設定

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

請注意，ODAC.config 中設定的TNS_ADMIN優先於環境中的TNS_ADMIN設定。

使用環境變數

如果使用者無法修改 ODAC.config，他們可以透過加入TNS_ADMIN環境變數來指定TNS_ADMIN。環境變數可以是系統環境變數，也可以是執行 Power BI Desktop 或本地資料閘道的使用者環境變數。例如，將TNS_ADMIN值設為「C：\network\admin」。

在環境中設定TNS_ADMIN（尤其是在系統層級）可能導致本機上執行的其他應用程式從TNS_ADMIN指向的位置取得網路設定檔（如 tnsnames.ora）。

使用先前安裝的 ODAC 設定

如果 ODAC 先前安裝並設定好 TNS_ADMIN，Power BI 會自動發現TNS_ADMIN。

從 Power Query Desktop 連線到 Oracle 資料庫的其餘設定與前幾節所述相同。

允許的財產清單

使用者可透過 connect 描述符（如 (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name)))）指定 Oracle 伺服器名稱。系統會強制執行哪些屬性可以在桌面和閘道中使用。預設允許的屬性 ODAC.config 列於以下章節。

<configuration>
 ...
  <AllowLists>
    <!--
      Oracle connection strings can contain connection properties, for example  CONNECT_TIMEOUT.   Only connection properties explicitly set to true in the list below will
      be allowed with Power BI Desktop and the On Premises Data Gateway. Using our example, you can add "CONNECT_TIMEOUT":true to the list to enable it. To disable it you
      can remove it from the list, or set the value to false. This list will be enforced on all connection string types including connect descriptors and aliases
      referencing a tnsnames.ora entry. The use of any disallowed property in a connection string will result in an ORA-50122 error. Restart Power BI Desktop or the On-premises
      Data Gateway service after applying ODAC.config changes.
      For more information see https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/InstallConnectionConfigurationRestriction.html
    -->
    <OnPremAllowList>{"DataSource":{"HOST":true,"PORT":true,"PROTOCOL":true,"HTTPS_PROXY":true,"HTTPS_PROXY_PORT":true,"ENABLE":true,"EXPIRE_TIME":true,"FAILOVER":true,"LOAD_BALANCE":true,"RECV_BUF_SIZE":true,"SDU":true,"SEND_BUF_SIZE":true,"SOURCE_ROUTE":true,"TYPE_OF_SERVICE":true,"COLOCATION_TAG":true,"CONNECTION_ID_PREFIX":true,"FAILOVER_MODE":true,"GLOBAL_NAME":true,"HS":true,"INSTANCE_NAME":true,"POOL_BOUNDARY":true,"POOL_CONNECTION_CLASS":true,"POOL_NAME":true,"POOL_PURITY":true,"RDB_DATABASE":true,"SHARDING_KEY":true,"SHARDING_KEY_ID":true,"SUPER_SHARDING_KEY":true,"SERVER":true,"SERVICE_NAME":true,"SID":true,"TUNNEL_SERVICE_NAME":true,"SSL_CLIENT_AUTHENTICATION":true,"SSL_CERTIFICATE_ALIAS":true,"SSL_CERTIFICATE_THUMBPRINT":true,"SSL_VERSION":true,"SSL_SERVER_DN_MATCH":true,"SSL_SERVER_CERT_DN":true,"WALLET_LOCATION":true,"CONNECT_TIMEOUT":true,"RETRY_COUNT":true,"RETRY_DELAY":true,"TRANSPORT_CONNECT_TIMEOUT":true,"RECV_TIMEOUT":true,"COMPRESSION":true,"COMPRESSION_LEVELS":true,"USE_SNI":true,"AUTHENTICATION_SERVICE":true,"IGNORE_ANO_ENCRYPTION_FOR_TCPS":true,"OCI_CONFIG_FILE":true,"OCI_DATABASE":true,"OCI_IAM_URL":true,"OCI_PROFILE":true,"OCI_TENANCY":true,"PASSWORD_AUTH":true,"REDIRECT_URI":true,"TENANT_ID":true,"TLS_VERSION":true,"TOKEN_AUTH":true,"TOKEN_LOCATION":true}}
    </OnPremAllowList>
  </AllowLists>
 ...
</configuration>

使用者若需要新增屬性或移除清單以執行更嚴格規則，可以修改此允許屬性清單。

備註

重要限制

搭配 DirectQuery 使用的內建 Oracle 受控 ODP.NET 驅動程式目前為預覽版。欲了解更多資訊，請參閱前述 DirectQuery 章節。
檔案 ODAC.config 可能需要管理員權限才能編輯，而 Power BI 商店應用程式不允許修改這個檔案。
ODAC.config 所做的變更會在升級時被覆蓋，你需要先把檔案存到另一個位置才能升級。
要讓本地資料閘道正常運作，請確保閘道服務所依據的使用者能存取TNS_ADMIN所指向的資料夾。
在套用設定變更後，重新啟動 Power BI Desktop 或本地資料閘道服務。

限制與考量

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

故障排除

當命名語法不正確或設定不當時，您可能會遇到多種來自 Oracle 的錯誤：

ORA-12154: TNS: could not resolve the connect identifier specified.
ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
ORA-12541: TNS: no listener.
ORA-12170: TNS: connect timeout occurred.
ORA-12504: TNS: listener was not given the SERVICE_NAME in CONNECT_DATA.

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

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

當你透過內建的 Oracle 驅動程式透過本地資料閘道使用 DirectQuery 時，以下錯誤可能表示 TNS 別名無法解決：

ORA-12154: TNS name resolution failure
ORA-50201: Failed to connect to server

如果遇到這些錯誤，請確認 TNS_ADMIN 已設定為系統（機器）範圍，且閘道服務帳戶可以存取其所指向的資料夾，然後重新啟動內部部署資料閘道服務。欲了解更多資訊，請參閱「支援的 Oracle 內建驅動程式指定TNS_ADMIN 方法」及 Oracle 的 Oracle 網路服務故障排除指南。

內建 Oracle 驅動程式的已知問題

以下已知問題僅限於內建的 Oracle 管理 ODP.NET 驅動程式。部分解決方法會退回到 ODP.NET 非管理驅動程式，方法是關閉內建驅動程式。關於每個表面的關閉步驟——Power BI Desktop 匯入與 DirectQuery，以及閘道匯入與 DirectQuery——請參見「使用 Oracle 內建驅動程式」。

適用於本地資料閘道，無論是在匯入（Import）或 DirectQuery 中。

當你的 Oracle 網路設定檔（tnsnames.ora 或目錄 TNS_ADMIN ）儲存在網路共享（UNC 路徑）時，內建驅動程式會持續無法解析網路服務名稱（TNS 別名）。您可能會看到 ORA-12154: TNS:could not resolve the connect identifier specified 或 ORA-50201: Failed to connect to server。相同的別名在 ODP.NET 非管理驅動程式中也能正確解析，或當檔案位於本地路徑時。內建的託管驅動程式無法可靠地從 UNC 位置讀取 Oracle 網路設定檔。

請使用以下其中一種變通方法：

複製 tnsnames.ora （如果你 sqlnet.ora 用的話）到本地硬碟的資料夾，然後把驅動程式指向那個資料夾。請參閱支援的 Oracle 內建驅動程式中指定 TNS_ADMIN的方法。對於閘道 DirectQuery，請在系統（機器）範圍內設定 TNS_ADMIN ，因為閘道服務帳號無法讀取使用者作用域的變數，然後重新啟動閘道服務。
確保運行閘道器的服務帳號能存取網路共享。
直接在 Server 輸入 Easy Connect 描述符（例如 host:port/service_name），而非別 tnsnames.ora 名，因此不需要網路設定檔。
關閉內建驅動程式，以退回 ODP.NET 非管理驅動程式，該驅動程式可以讀取共享檔案。

NLS_LANG被忽視了

適用於 Power BI Desktop、本地資料閘道，以及 Power BI 服務雲端連線，涵蓋匯入與 DirectQuery。

內建驅動程式時，Oracle 會話語言、區域，以及數字和日期格式會遵循機器的 .NET 文化（Windows 區域與格式設定），而非NLS_LANG環境變數。設定或更改 NLS_LANG 都沒有影響。根據機器的區域不同，這種行為可能導致數字或日期用錯誤的分隔符或日期順序解析，查詢回傳零列或錯誤值，或出現錯誤如 ORA-01722、 ORA-01858、 ORA-01861ORA-01843、。例如，在設定為英文的機器（美國）上撰寫的報告，在設定為英文的機器（英國）上可能會回傳零列或錯誤。受管理的 ODP.NET 驅動程式其國家語言支援（NLS）設定來自 .NET 執行緒文化，而非 NLS_LANG，與 ODP.NET 非管理驅動程式不同，後者會NLS_LANG尊重。

請使用以下其中一種變通方法：

將機器的區域設定與你的資料和查詢設計的地點相匹配。
關閉內建驅動程式以退回到 ODP.NET 非管理驅動程式，該驅動程式會NLS_LANG尊重。

關於受管理驅動程式全球化行為的背景，請參閱 Oracle 的全球化支援文件。

`FetchSize` 登錄檔中沒有被內建驅動程式使用

適用於 Power BI Desktop 及本地資料閘道，適用於 Oracle 匯入模型。

切換到內建驅動程式後，Oracle 匯入模型的刷新速度可能會比使用 ODP.NET 非管理驅動程式慢。內建的管理型 ODP.NET 提供者不會從登錄檔讀取該FetchSize屬性。 ODP.NET 非管理與受管理提供者的預設FetchSize為 128 KB，在 23.26.2 版本及更早版本中，包含 Power BI 所包含的 23.6 提供者。受管理的提供者會忽略登錄檔中設定的任何 FetchSize 覆蓋。

關閉內建驅動程式，可以退回到 ODP.NET 非管理驅動程式，該驅動程式會遵守登錄檔FetchSize設定。在本地資料閘道器，在閘道設定中的 bundled-provider 設定中設定MashupFlight_DisableOracleBundledOdacProviderV2為。True

Oracle 代理與使用者身份驗證不支援

適用於本地資料閘道（2026 年 6 月版本及以後版本），用於使用 Oracle 代理帳號的 Oracle Import 與 DirectQuery。

升級到 2026 年 6 月的閘道器後，該閘道預設為內建的託管服務提供者，使用 Oracle 代理帳號連接 Oracle 的 Power BI 報告在匯入和 DirectQuery 都失敗。當連線使用非代理的 Oracle 帳號時，同一資料來源仍可運作。 Oracle 資料庫代理使用者認證——以一個資料庫使用者代表另一個結構（例如User Id=proxy_user[target_schema]表單）連線——目前隨 Power BI 附帶的內建管理型 ODP.NET 服務提供者版本 23.6 不支援。

請使用以下其中一種變通方法：

盡可能使用非代理的 Oracle 帳號。
對於匯入，請將閘道內建的匯入驅動程式設為 MashupFlight_DisableOracleBundledOdacProviderV2True關閉，讓閘道器退回到支援代理帳號的 ODP.NET 非管理驅動程式。
對於 DirectQuery，匯入設定不適用。請聯絡 Microsoft 支援服務，關閉閘道 DirectQuery 路徑的內建驅動程式。這種配置如今已不再是自助式。

無法更新 Oracle 個人雲端連線憑證

適用於 Power BI 服務，適用於 Oracle 個人雲端連線。

在 Power BI 服務的「管理連線與閘道」頁面，更新 Oracle 個人雲端連線的憑證無法運作。請從語意模型設定欄格更新憑證：

打開語意模型設定窗格，進入 閘道與雲端連線。
設定資料來源使用個人雲端連線。
在 資料來源憑證（Data source credentials）中，編輯該資料來源的憑證。

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

如果您透過內部部署資料網關連接到 Oracle 資料庫時出現 "對象參考未設定" 錯誤訊息，請遵循 "管理您的資料來源 - Oracle" 中的指示。

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

擴充數據表數據列時優化Power Query

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-08-14

Oracle Database

總結

先決條件

支援的功能

使用 Oracle 用戶端 for Microsoft Tools （OCMT） 選項

從 Power BI Desktop 連接本地 Oracle 資料庫

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

連接至 Oracle 自主資料庫

下載您的客戶端認證

設定 Oracle ADB 認證

將 Power BI Desktop 連線至 Oracle ADB

使用進階選項進行連線

使用內建的 Oracle 驅動程式

針對 Power BI Desktop 的匯入模式

針對 Power BI Desktop 中的 DirectQuery 模式（預覽版）

針對內部部署閘道器中的匯入模式

用於本地閘道器的 DirectQuery 模式（預覽版）

支援的 Oracle 內建驅動程式中指定 TNS_ADMIN 的方法

在 ODAC.config 中設定TNS_ADMIN

使用環境變數

使用先前安裝的 ODAC 設定

允許的財產清單

限制與考量

故障排除

內建 Oracle 驅動程式的已知問題

網路共享上的 TNS 別名不會被解決

NLS_LANG被忽視了

FetchSize 登錄檔中沒有被內建驅動程式使用

Oracle 代理與使用者身份驗證不支援

無法更新 Oracle 個人雲端連線憑證

相關內容

意見反應

其他資源

使用 Oracle 用戶端 for Microsoft Tools （OCMT）選項

`FetchSize` 登錄檔中沒有被內建驅動程式使用