Oracle Database

總結

房產 Value
連接器 Oracle 資料庫圖示。 Oracle 資料庫
產品 Excel
Power BI (語意模型)
Power Query Online
發行狀態 一般可用性
驗證類型 Windows (桌面/在線)
資料庫 (桌面)
基本 (線上)
Microsoft帳戶 (桌面版)
資料來源類型 Oracle
函數參考文檔 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 語法
    • 包含關聯性欄位
    • 使用完整階層導航

從 Power Query Desktop 連線

本地資料庫

若要進行連線,請執行下列步驟:

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

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

    Oracle 資料庫連線對話方塊的螢幕擷取畫面,您可以在其中輸入 Oracle 資料庫連線資訊。

  3. 如果你是從 Power BI Desktop 連線,請選擇 匯入 或 DirectQuery 資料連線模式。 這些範例步驟的其餘部分會使用匯入數據連線模式。 想了解更多關於 DirectQuery 的資訊,請前往「在 Desktop 中使用 DirectQueryPower BI」。

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

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

    如需驗證的詳細資訊,請前往 使用資料來源驗證。

    您輸入 Oracle 資料庫認證的驗證對話方塊的螢幕擷取畫面。

  5. 在 Navigator中,選取您需要的數據,然後選取 [載入] [載入] 以載入數據,或 [轉換數據] 來轉換數據。

從 Power Query Online 連線

本地資料庫

若要進行連線,請執行下列步驟:

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

  2. 從 Power Query Online 中,選取數據來源中的 Oracle 資料庫 選項。

  3. 在出現的 [Oracle 資料庫] 對話框中,指定 Oracle net service name/TNS 別名、Easy Connect Plus 連接字串,或連接描述元以連線到 伺服器。

    Oracle 資料庫視窗的螢幕擷取畫面,您可以在其中輸入 Oracle 資料庫線上連線資訊。

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

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

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

  7. 輸入您的認證。

  8. 選取 下一步 以繼續。

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

其他資訊

使用適用於 Microsoft Tools 的 Oracle 用戶端(OCMT)選項

Oracle Client for Microsoft Tools 會安裝和設定 Oracle Data Provider for .NET (ODP.NET), 以支援與 Oracle 內部部署和雲端資料庫的 32 位和 64 位Microsoft工具連線,包括 Oracle 自發資料庫(ADB)。 OCMT 是一種圖形化安裝程式,可自動化 Oracle 資料庫用戶端安裝程式。 它支援連接Power BI桌面、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 資料庫運作所需的所有設定步驟。

連接至 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 Autonomous 資料庫,您需要以下帳號和應用程式:

下載您的客戶端認證

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

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

  1. 在您的 Oracle 自發資料庫詳細數據頁面中,選取 [資料庫連線]。

    Autonomous Database 結果頁面的螢幕擷取畫面,其中強調「資料庫連線」選項。

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

    「資料庫連線」頁面的螢幕截圖,強調了「下載錢包」選項。

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

    下載錢包頁面的螢幕擷取畫面,您可以在其中輸入錢包密碼。

設定 Oracle ADB 認證

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

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

    錢包文件在錢包文件夾中解壓縮的屏幕截圖。

    備註

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

  3. 在編輯軟體中開啟 sqlnet.ora,例如 Notepad。

  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桌面。

  2. 選擇 取得資料。

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

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

    Oracle 資料庫對話方塊的螢幕擷取畫面,其中 contosomart_high 作為伺服器名稱並選取匯入模式。

  5. 如果你第一次從 Power BI 桌面登入這台伺服器,系統會要求你輸入你的登入憑證。 選取 [資料庫],然後輸入 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 資料庫。

使用 Microsoft Entra ID 單一登入來進行 Oracle 雲端連線

此Power BI服務支援 Microsoft Entra ID 單一登入(SSO),可直接連線至 Oracle 資料庫的雲端。

要使用雲端 SSO,Fabric 管理員必須在管理入口網站開啟啟用 Oracle SSO 租戶設定。 設定你的 Oracle 環境接受 Microsoft Entra ID 令牌。 欲了解更多資訊,請參閱「搭配 Oracle 使用 Microsoft Entra ID」。

Important

關閉 啟用 Oracle SSO 會讓現有已啟用 SSO 的 Oracle 雲端資料來源無法使用。

使用內建的 Oracle 驅動程式

桌面版中的匯入模式 Power BI

對於 Power BI Desktop 或內部部署資料閘道的 2026 年 6 月版本,預設會使用內建的 Oracle 受管理 ODP.NET 驅動程式進行連線。 這項功能可移除使用者安裝及管理驅動程式的必要條件。 你仍然可以透過以下指示選擇退出此功能。

若不要在 Power BI Desktop 中使用此內建驅動程式,請前往 選項與設定(在 檔案 索引標籤下)>選項>預覽功能,然後清除核取方塊以停用 啟用使用隨附的 Oracle Managed ODP Provider for Import Mode 選項。

在桌面啟用內建 Oracle Managed ODP Provider Power BI 的選項截圖。

適用於 Power BI Desktop 中的 DirectQuery 模式(預覽版)

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

若要在 Power BI Desktop 中使用此內建驅動程式,請前往選項與設定(檔案標籤下的>選項>預覽功能),然後清除核取方塊以啟用使用捆綁的 Oracle Managed ODP Provider for DirectQuery 模式選項。

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

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

  1. 在安裝內部部署數據閘道的本機電腦上,流覽至 C:\Program Files\On-premises 數據閘道。
  2. 備份名為 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config的組態檔。
  3. 開啟原始 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config 組態檔,並找出 MashupFlight_DisableOracleBundledOdacProviderV2 條目。
  4. 將值更新 MashupFlight_DisableOracleBundledOdacProviderV2 為 True。
  5. 重新啟動閘道。
<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

備註

一旦您在 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config 檔案中變更了 MashupFlight_DisableOracleBundledOdacProviderV2 設定,此設定在內部部署資料閘道升級後仍會保留。

備註

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

用於本地閘道器的 DirectQuery 模式(預覽版)

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

設定 FetchSize 以提升效能

內建的 Oracle 驅動程式使用以下預設 FetchSize 值:

Connection Gateway 版本發佈 預設 FetchSize
閘道匯入 2026年10月及以後 8 MB
閘道器 DirectQuery 2026 年 10 月 256 KB
Power BI Service Cloud 連線 不適用 8 MB

對於閘道器 DirectQuery,預計 2026 年 11 月的閘道器版本將預設 FetchSize 提高至 8 MB,並支援與匯入模式相同的 ODAC.config 設定。

從 2026 年 10 月的閘道版本開始,你可以在 ODAC.config 中將 FetchSize 設定為匯入模式。 該檔案位於 ADO.NET Providers 閘道安裝資料夾的子資料夾中。

若要設定 FetchSize:

  1. 備份 ODAC.config,然後用文字編輯器打開檔案。

  2. 在 oracle.manageddataaccess.client>version>settings 下新增或更新FetchSize該條目。 以位元組為單位指定值。 以下範例設定 FetchSize 為 16,777,216 位元組(16 MB):

    <configuration>
      <oracle.manageddataaccess.client>
        <version number="*">
          <settings>
            <setting name="FetchSize" value="16777216" />
          </settings>
        </version>
      </oracle.manageddataaccess.client>
    </configuration>
    

    把設定合併到你現有的設定裡。 保留其他設定,例如 TNS_ADMIN。

  3. 儲存 ODAC.config,然後重新啟動本地資料閘道服務。

閘道升級會覆蓋 ODAC.config。 保留你的設定變更副本,升級後可以重新套用。

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

有三種選項可以指定TNS_ADMIN:

在 ODAC.config 中設定TNS_ADMIN

如果你使用內建的 Oracle 驅動程式,並擁有修改程式檔案的權限,你可以在 ODAC.config 檔案中指定 TNS_ADMIN,該檔案是內建 Oracle 驅動程式所使用的設定檔。 該檔案位於 Power BI 桌面或「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 或內部部署資料閘道服務。

限制與考量

Power BI 在語意模型刷新到 Oracle 資料庫後,會話仍可在 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 錯誤。

如果你是從 Microsoft Store 下載 Power BI Desktop,可能因為 Oracle 驅動程式問題而無法連線到 Oracle 資料庫。 如果你遇到這個問題,回傳的錯誤訊息是:物件參考未設定。為了解決這個問題,請從下載中心下載Power BI桌面版,而不是從 Microsoft Store。

如果你透過本地資料閘道連接 Oracle 資料庫時,在 中出現 Power BI 錯誤訊息,請依照 管理你的資料來源 - Oracle 中的指示操作。

如果您使用的是 Power BI Report Server,請參考 Oracle 連線類型 文章中的指引。

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

以下已知問題僅限於內建的 Oracle 管理 ODP.NET 驅動程式。 關於設定選項,請參閱 使用內建的 Oracle 驅動程式。

網路共用上的 TNS 別名無法解析

適用於本地資料閘道,無論是在匯入(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 桌面、本地資料閘道,以及 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 的 全球化支援 文件。

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