排除內部部署資料閘道器的問題

Note

我們已將內部部署資料閘道檔分割成 Power BI 特有的內容，以及套用至閘道支援之所有服務的一般內容。您目前位於 Power BI 內容中。若要提供本文或整體閘道文件體驗的意見反應，請捲動至文章底部。

本文討論當您搭配 Power BI 服務使用內部部署資料閘道時可能發生的常見問題。如果您遇到此處未列出的問題，請流覽 Power BI 社群或建立支援票證。

小提示

首先，確認您使用的是最新的閘道版本。許多連線和可靠性問題會在每月更新中解決。如需升級步驟，請參閱安裝和管理內部部署資料閘道。

Configuration

錯誤：Power BI 服務顯示本地資料閘道無法連線

設定結束時，會再次呼叫 Power BI 服務以驗證閘道。 Power BI 服務不會將閘道報告為即時。重新啟動 Windows 服務可能會讓通訊成功。若要取得詳細資訊，您可以收集和檢閱記錄，如從內部部署資料閘道應用程式收集記錄中所述。

帶上您自己的 Azure Relay

如果您已啟用自備（BYO） Azure 轉送，並遇到連線問題，請確定該轉送命名空間上未啟用 Private Link，閘道的 BYO 轉送功能目前不支援此設定。如果您不需要自訂「轉送」控制項，請停用「BYO 轉送」來還原為預設的受管理轉送。

數據源

Note

並非所有資料來源都有專門的文章詳細說明其連線設定或組態。對於許多資料來源和非 Microsoft 連接器，Power BI Desktop 與 Power BI 服務中的 [管理連線和閘道 ] 設定之間的連線選項可能會有所不同。在這種情況下，提供的預設設定是 Power BI 目前支援的案例。

錯誤：無法連線。詳細資料：「連線認證無效」

在 [顯示詳細資料] 中，會顯示從資料來源收到的錯誤訊息。針對 SQL Server，您會看到類似下列的訊息：

Login failed for user 'username'.

確認您擁有正確的使用者名稱和密碼。此外，請確認這些認證可以成功連線到資料來源。請確定所使用的帳戶符合驗證方法。

錯誤：無法連線。詳細資料：「無法連線到資料庫」

您能夠連接至伺服器，但無法連接至所提供的資料庫。驗證資料庫的名稱，以及使用者名稱和密碼是否具有存取該資料庫的適當許可權。

在 [顯示詳細資料] 中，會顯示從資料來源收到的錯誤訊息。針對 SQL Server，您會看到類似下列訊息的內容：

Cannot open database "AdventureWorks" requested by the login. The login failed. Login failed for user 'username'.

錯誤：無法連線。詳細資料：「資料閘道中的未知錯誤」

發生此錯誤的原因可能不同。請務必驗證您可以從裝載閘道的機器連線到資料來源。此狀況可能是無法存取伺服器的結果。

在 顯示詳細資料中，您可以看到錯誤代碼 DM_GWPipeline_UnknownError。

您也可以查看事件記錄、>應用程式和服務記錄>、內部部署資料閘道服務，以取得詳細資訊。如需詳細描述，請參閱事件記錄檔。

錯誤：我們在嘗試連線到 <伺服器>時遇到錯誤。詳細資料：「我們已連線到資料閘道，但閘道無法存取內部部署資料來源。」

您無法連線到指定的資料來源。請務必驗證為該資料來源提供的資訊。

在 顯示詳細資料中，您可以看到錯誤代碼 DM_GWPipeline_Gateway_DataSourceAccessError。

如果基礎錯誤訊息與下列錯誤訊息類似，則表示您用於資料來源的帳戶不是該 Analysis Services 執行個體的伺服器系統管理員。如需詳細資訊，請參閱將伺服器管理員許可權授與 Analysis Services 實例。

The 'CONTOSO\account' value of the 'EffectiveUserName' XML for Analysis property is not valid.

如果基礎錯誤訊息與下列錯誤訊息類似，則可能表示 Analysis Services 的服務帳戶可能遺漏 Token-Groups-Global-And-Universal （TGGAU）目錄屬性。

The username or password is incorrect.

具有 Windows 2000 之前相容性存取權的網域已啟用 TGGAU 屬性。大多數新建立的網域預設不會啟用此屬性。如需詳細資訊，請參閱某些應用程式和 API 需要存取帳戶物件的授權資訊。

若要確認屬性是否已啟用，請遵循下列步驟。

連線到 SQL Server Management Studio 內的 Analysis Services 電腦。在進階連線屬性中，為相關使用者包含 EffectiveUserName，查看此新增是否會重現錯誤。
您可以使用 dsacls Active Directory 工具來驗證是否列出屬性。此工具位於域控制器上。您需要知道帳戶的可分辨域名是什麼，並將該名稱傳遞給工具。
```
dsacls "CN=John Doe,CN=UserAccounts,DC=contoso,DC=com"
```
您想要在結果中看到類似下列輸出的內容：
```
Allow BUILTIN\Windows Authorization Access Group
                                SPECIAL ACCESS for tokenGroupsGlobalAndUniversal
                                READ PROPERTY
```

若要修正此問題，您必須在用於 Analysis Services Windows 服務的帳戶上啟用 TGGAU。

「使用者名稱或密碼不正確」的另一種可能性。

如果 Analysis Services 伺服器位於與使用者不同的網域中，而且未建立雙向信任，也可能會造成此錯誤。

請與您的網域管理員合作，以驗證網域之間的信任關係。

無法在 Power BI 服務中使用 Analysis Services 的資料取得功能時看到資料閘道的資料來源。

請確定您的帳戶列在閘道組態內資料來源的 [ 使用者 ] 索引標籤中。如果您無法存取閘道，請洽詢閘道的管理員，並要求他們進行驗證。只有 [ 使用者 ] 清單中的帳戶才能看到 [Analysis Services ] 清單中列出的資料來源。

錯誤：您沒有為此資料集中的資料來源安裝或設定任何閘道

請確定您已將一或多個資料來源新增至閘道，如新增資料來源中所述。如果閘道未出現在系統管理入口網站的 [管理連線和閘道] 底下，請清除瀏覽器快取或登出服務，然後重新登入。在語意模型設定中，閘道區段只會列出具備與所有使用的內部部署來源相符資料來源定義的閘道。

錯誤：無法重新整理您的資料來源，因為認證無效

您可以連線並重新整理語意模型，而不會發生連線的執行階段錯誤，但在 Power BI 服務中會出現此錯誤列。當使用者嘗試使用已知良好的認證來更新認證時，會出現錯誤，指出提供的認證無效。

當閘道嘗試測試連線時，即使提供的認證是可接受的，且重新整理作業成功，也可能會發生此錯誤。當閘道執行連線測試時，它目前會省略選用參數（例如，Snowflake 倉儲、角色或其他進階設定），而某些連接器需要這些值。

如果重新整理正確完成，而且您沒有遇到執行階段錯誤，您可以忽略需要選擇性參數之資料來源的這些測試連線錯誤。

語意模型

錯誤：此列沒有足夠的空間

如果單一匯入的資料列超過大約 4 MB （壓縮儲存引擎限制），就會發生此錯誤。在匯入之前，識別來源中有問題的資料列，並篩選或分割資料行（例如，減少大型文字/Blob 欄位）。

錯誤：提供的伺服器名稱不符合 SQL Server SSL 憑證上的伺服器名稱

當憑證一般名稱適用於伺服器的完整網域名稱（FQDN），但您只提供伺服器的 NetBIOS 名稱時，可能會發生此錯誤。此狀況會導致憑證不相符。若要解決此問題，請讓閘道資料來源內的伺服器名稱和 PBIX 檔案使用伺服器的 FQDN。

錯誤：當您設定排程重新整理時，您看不到內部部署資料閘道

一些不同的案例可能會導致此錯誤：

伺服器和資料庫名稱不符合在 Power BI Desktop 中輸入的名稱，以及針對閘道設定的資料來源。這些名稱必須相同（不區分大小寫）。
您的帳戶不會列在閘道組態內資料來源的 [ 使用者 ] 索引標籤中。閘道管理員需要將您新增至該清單。
您的 Power BI Desktop 檔案有多個資料來源，而且並非所有這些資料來源都定義在閘道中。每個內部部署來源都必須有相符的閘道資料來源條目。

錯誤：閘道用戶端上收到的未壓縮資料已超出限制

限制是重新整理期間每個表格區段 10 GB 的未壓縮資料。若要最佳化：

用代理鍵替換重複的長字符串。
移除未使用的高基數文字欄。
分割非常寬的表格或篩選歷史分區。
請考慮針對非常大的事實數據表使用 DirectQuery。

錯誤：DM_GWPipeline_Gateway_SpooledOperationMissing

一些不同的情況可能會導致此錯誤：

閘道 Windows 服務會在語意模型重新整理或查詢進行中時重新啟動（例如，OS 修補或服務損毀）。
安裝閘道後，將虛擬機器映像複製，導致暫存狀態的重複。

避免在安裝後複製電腦 - 在新主機上執行全新閘道安裝。查看在錯誤時間戳記附近的閘道服務日誌以找出重新啟動事件。

Reports

錯誤：報表無法存取資料來源，因為您無法透過內部部署資料閘道存取我們的資料來源

此錯誤通常是由下列其中一項所造成：

資料來源資訊與基礎資料集中的資訊不符。伺服器和資料庫名稱必須符合針對內部部署資料閘道定義的資料來源，與您在 Power BI Desktop 內提供的資料之間相符。如果您在 Power BI Desktop 中使用 IP 位址，內部部署資料閘道的資料來源也必須使用 IP 位址。
組織內的任何閘道上都沒有可用的資料來源。您可以在新的或現有的內部部署資料閘道上設定資料來源。

錯誤：資料來源存取錯誤（請聯絡閘道管理員）

如果此報表使用即時 Analysis Services 連線，您可能會遇到傳遞至 EffectiveUserName 的值無效或缺少 Analysis Services 伺服器許可權的問題。一般而言，驗證問題會發生，因為 EffectiveUserName 值不符合本機使用者主體名稱（UPN）。

若要確認有效使用者名稱，請依照下列步驟操作。

在閘道記錄中尋找有效的使用者名稱。
傳遞值之後，請驗證值是否正確。如果是您的使用者，您可以從命令提示符使用下列命令來檢視 UPN。 UPN 看起來像一個電子郵件地址。
```
whoami /upn
```

或者，您可以查看 Power BI 從 Microsoft Entra ID 取得的內容。

瀏覽至 [圖形總管]。
選取右上角的登入。
執行下列 Microsoft Graph 查詢（Azure AD Graph 已淘汰）：

https://graph.microsoft.com/v1.0/me

在 JSON 回應中尋找 userPrincipalName 屬性。

如果您的 Microsoft Entra UPN 與本機 Active Directory UPN 不相符，您可以使用對應使用者名稱功能將其替換為有效的值。或者，請與您的 Power BI 系統管理員或本機 Active Directory 系統管理員合作，以對齊 UPN。

Kerberos

如果基礎資料庫伺服器和內部部署資料閘道器未適當設定用於 Kerberos 限制委派，請在閘道器上啟用額外的記錄。然後，根據閘道記錄檔中的錯誤或追蹤進行調查，作為疑難排解的起點。若要收集閘道記錄以供檢視，請參閱從內部部署資料閘道應用程式收集記錄。

ImpersonationLevel

ImpersonationLevel 與伺服器主體名稱（SPN）設定或本機原則設定相關。

[DataMovement.PipeLine.GatewayDataAccess] About to impersonate user DOMAIN\User (IsAuthenticated: True, ImpersonationLevel: Identification)

解決方案（模擬權限等級）

請依照下列步驟解決問題。

設定內部部署閘道的 SPN。
在 Active Directory 中設定受限制的委派。

FailedToImpersonateUserException：無法為使用者 userid 建立 Windows 身分識別信息

當閘道無法代表其他使用者模擬時，就會發生 FailedToImpersonateUserException。如果被模擬的帳戶位於不同的網域中，而未設定必要的信任，也可能發生此錯誤。

解決方案（FailedToImpersonateUserException）

根據上一個「ImpersonationLevel」一節中的步驟，確認設定正確無誤。
請確定它嘗試模擬的使用者識別碼是有效的 Active Directory 帳戶。

一般錯誤：剖析通訊協定時發生 1033 錯誤

如果使用者是透過使用 UPN（alias@domain.com）來模擬，且 SAP HANA 中設定的外部識別碼與登入不符，您會收到 1033 錯誤。您會在錯誤記錄檔頂端看到「原始 UPN 'alias@domain.com' 取代為新的 UPN 'alias@domain.com'」，如下所示：

[DM.GatewayCore] SingleSignOn Required. Original UPN 'alias@domain.com' replaced with new UPN 'alias@domain.com.'

解決方案（1033 錯誤）

SAP HANA 需要模擬使用者使用 sAMAccountName Active Directory 中的屬性（使用者別名）。如果此屬性不正確，您會看到 1033 錯誤。
在記錄中，您會看到 sAMAccountName （別名），而不是 UPN，這是別名後面接著網域（alias@domain.com）。

  <setting name="ADUserNameReplacementProperty" serializeAs="String">
    <value>sAMAccountName</value>
  </setting>
  <setting name="ADServerPath" serializeAs="String">
    <value />
  </setting>
  <setting name="CustomASDataSource" serializeAs="String">
    <value />
  </setting>
  <setting name="ADUserNameLookupProperty" serializeAs="String">
    <value>AADEmail</value>
  </setting>

SAP HANA 通訊連結失敗：-10709 連線失敗（Kerberos 認證無法使用）

如果您的委派未在 Active Directory 中正確設定，您會收到「-10709 連線失敗」錯誤訊息。

解決方案（SAP HANA Kerberos -10709）

請確定您在閘道服務帳戶的 Active Directory 中的 [委派] 索引標籤上有 SAP HANA 伺服器。

匯出支援單的記錄

需要閘道日誌才能進行疑難排解和建立支援票證。使用下列步驟來擷取這些日誌。

識別閘道叢集。

如果您是語意模型擁有者，請先檢查與您的語意模型相關聯的閘道叢集名稱。在下圖中， IgniteGateway 是閘道叢集。
檢查閘道屬性。

然後，閘道管理員應檢查叢集中的閘道成員數目，以及是否已啟用負載平衡。

如果啟用負載平衡，則應對所有閘道成員重複步驟 3。如果未啟用，則在主要閘道上匯出記錄就足夠了。
擷取並匯出閘道記錄。

接下來，閘道管理員（也是閘道系統的管理員）應該執行下列步驟：
1. 登入閘道機器，然後啟動內部部署資料閘道應用程式以登入閘道。
2. 啟用其他記錄。
3. （選用）啟用效能監控功能並包含效能日誌。
4. 執行您要擷取閘道日誌之場景。
5. 匯出閘道日誌。

重新整理記錄

當您使用閘道進行排程重新整理時， 重新整理歷程記錄 可協助您查看發生的錯誤。如果您需要建立支援請求，它也可以提供有用的資料。您可以檢視排程和按需重新整理。下圖顯示如何取得重新整理歷程記錄。

在語意模型的詳細數據頁面上，選取功能區中的 [重新整理 ]，然後選取 [重新整理歷程記錄]。

在語意模型下 [重新整理] 功能中的 [重新整理歷史] 選項

您也可以從語意模型設定存取 [重新整理歷程記錄 ]。選取功能區中的 [檔案]，然後選取 [設定]。

導覽至語意模型設定以存取重新整理歷程記錄

刷新歷史記錄表，以列出排程與隨選的重新整理作業

如需疑難排解重新整理案例的詳細資訊，請參閱疑難排解重新整理案例。如果您的排程重新整理意外中止執行，請檢閱設定排程重新整理中所述的非活動狀態下的行為。

其他問題嗎？嘗試 Power BI 社群。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-09-18