共用方式為

Azure Synapse Analytics 已知問題

  • 發行項

此頁面列出 Azure Synapse Analytics 中的已知問題，以及其解決日期或可能的因應措施。 提交 Azure 支援 要求之前，請檢閱此清單，以查看您遇到的問題是否已已知且正在解決。

若要深入瞭解 Azure Synapse Analytics，請參閱 Azure Synapse Analytics 概觀和 Azure Synapse Analytics 的新功能？

作用中已知問題

Azure Synapse 元件 狀態 問題
Azure Synapse 專用 SQL 集區 客戶無法使用計量來監視其專用 SQL 集區的使用量 有因應措施
Azure Synapse 專用 SQL 集區 將 parquet 檔案擷取到具有 AUTO_CREATE_TABLE='ON' 的數據表時，查詢失敗 有因應措施
Azure Synapse 專用 SQL 集區 發生數據外洩錯誤的查詢失敗 有因應措施
Azure Synapse 專用 SQL 集區 UPDATE STATISTICS 語句失敗，並出現錯誤：「提供的統計數據數據流已損毀」。 有因應措施
Azure Synapse 無伺服器 SQL 集區 從無伺服器 SQL 集區到 Azure Cosmos DB 分析存放區的查詢失敗 有因應措施
Azure Synapse 無伺服器 SQL 集區 Azure Cosmos DB 分析存放區檢視會在數據行中傳播錯誤的屬性 有因應措施
Azure Synapse 無伺服器 SQL 集區 無伺服器 SQL 集區中的查詢失敗 有因應措施
Azure Synapse 無伺服器 SQL 集區 由於授權標頭太長，儲存體 存取問題 有因應措施
Azure Synapse 工作區 未列出具有使用者指派受控識別的 Blob 記憶體連結服務 有因應措施
Azure Synapse 工作區 無法刪除 Synapse 工作區和無法刪除虛擬網路 有因應措施
Azure Synapse 工作區 REST API PUT 作業或 ARM/Bicep 範本更新網路設定失敗 有因應措施
Azure Synapse 工作區 將方括弧 [] 併入Tags值的已知問題 有因應措施
Azure Synapse 工作區 在 GitHub 動作中使用 Synapse-workspace-deployment v1.8.0 搭配 ARM 範本的 Synapse 工作區部署失敗 有因應措施

Azure Synapse Analytics 專用 SQL 集區作用中已知問題摘要

客戶無法使用計量來監視其專用 SQL 集區的使用量

遙測排放邏輯的內部升級，旨在增強遙測數據的效能和可靠性，導致一些客戶監視其專用 SQL 集 tempdb區和數據倉儲數據 IO 計量的能力發生意外的問題。

因應措施：在識別問題時，我們的小組會採取動作來識別根本原因，並更新系統中的組態。 客戶可以暫停並繼續其實例來修正問題，這會還原實例的正常狀態和遙測數據流。

將 parquet 檔案擷取到具有 AUTO_CREATE_TABLE='ON' 的數據表時，查詢失敗

嘗試將 parquet 檔案內嵌至哈希分散式數據表 AUTO_CREATE_TABLE='ON' 的客戶可能會收到下列錯誤：

COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables

不支援使用AUTO_CREATE_TABLE擷入自動建立哈希分散式數據表。 先前使用此不支援案例載入的客戶，應將其數據 CTAS 放入新的數據表，並使用該數據表來取代舊數據表。

發生數據外洩錯誤的查詢失敗

從現有專用 SQL 集區建立的 Synapse 工作區會報告與數據外洩保護相關的查詢失敗，並在 Synapse Analytics 中關閉數據外洩保護時出現一般錯誤訊息：

Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.

因應措施：如果您遇到類似的錯誤，請洽詢 Microsoft 支援服務 小組以取得協助。

UPDATE STATISTICS 失敗

某些專用 SQL 集區在執行語句時可能會遇到例外狀況 UPDATE STATISTICS 。 此命令會產生「提供的統計數據數據流已損毀」訊息，且無法更新您的統計數據。

將新的條件約束新增至數據表時，會在散發中建立相關的統計數據。 如果數據表上也建立叢集索引，它必須包含與條件約束相同的數據行（順序相同），否則 UPDATE STATISTICS 這些數據行上的命令可能會失敗。

因應措施：識別數據表上是否存在條件約束和叢集索引。 如果是，則DROP條件約束和叢集索引。 之後，請重新建立叢集索引，然後確定兩者都以相同順序包含相同的數據行。如果數據表沒有條件約束和叢集索引，或上述步驟產生相同的錯誤，請連絡 Microsoft 支援服務 Team 以取得協助。

標籤更新似乎失敗

透過 Azure 入口網站 或其他方法變更專用 SQL 集區的標記時，即使成功進行變更，仍會出現錯誤訊息。

因應措施：您可以確認標籤的變更成功，並視需要忽略/隱藏錯誤訊息。

Azure Synapse 工作區使用中已知問題摘要

以下是 Synapse 工作區的已知問題。

未列出具有使用者指派受控識別的 Blob 記憶體連結服務

在設定 Blob 記憶體連結服務以在 Azure Synapse Analytics 中使用「使用者指派的受控識別」驗證之後，數據中樞 ->Linked ->Azure Blob 儲存體 下可能無法看到連結服務。

因應措施：工程小組目前已察覺此行為並處理修正程式。 或者，使用「系統指派的受控識別」驗證方法，而不是「使用者指派的受控識別」。

無法刪除 Synapse 工作區和無法刪除虛擬網路

刪除 Synapse 工作區失敗，並出現錯誤訊息：

Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;

因應措施：重試刪除作業可以減輕問題。 工程小組知道此行為並處理修正程式。

REST API PUT 作業或 ARM/Bicep 範本更新網路設定失敗

使用 ARM 範本、Bicep 樣本或直接 REST API PUT 作業來變更 Synapse 工作區的公用網路存取設定和/或防火牆規則時，作業可能會失敗。

因應措施：使用 REST API PATCH 作業或 Azure 入口網站 UI 來反轉並重試所需的組態變更，可以減輕此問題。 工程小組知道此行為並處理修正程式。

將方括弧 [] 併入Tags值的已知問題

在 Azure Synapse 工作區內更新標籤的內容中，包含方括弧 （[]） 會導致更新作業失敗。

因應措施：目前的因應措施是在 Azure Synapse 工作區標籤值中使用方括號 （[]） 放棄。

在 GitHub 動作中使用 Synapse-workspace-deployment v1.8.0 搭配 ARM 範本的 Synapse 工作區部署失敗

在部署到生產環境期間發生失敗，且與包含具有雙反斜杠之主機名的觸發程序有關。

顯示的錯誤訊息為 Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057。

因應措施：可以採取下列動作來快速緩和：

  • 拿掉逸出字元： 在部署之前，手動從參數檔案中移除任何逸出字元 （\）。 這表示編輯檔案以排除在部署剖析或處理階段期間可能造成問題的字元。
  • 將逸出字元取代為正斜線： 將逸出字元 （\） 取代為正斜線 （/）。 這在檔案路徑中特別有用，其中許多系統接受正斜線做為有效的路徑分隔符。 此取代可能有助於略過逸出字元的問題，讓部署程式能夠成功。

套用上述任一因應措施並成功部署之後，請手動更新工作區內的必要設定，以確保一切都已正確設定。 這可能涉及編輯組態檔、調整設定，或執行與所部署之特定環境或應用程式相關的其他工作。

Azure Synapse Analytics 無伺服器 SQL 集區作用中已知問題摘要

從無伺服器 SQL 集區到 Azure Cosmos DB 分析存放區的查詢失敗

從無伺服器 SQL 集區到 Azure Cosmos DB 分析存放區的查詢可能會失敗，並出現下列其中一個錯誤訊息：

  • Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'
  • Resolving CosmosDB path has failed with error 'Key not found'

下列條件必須成立，才能確認此問題：

  1. Azure Cosmos DB 分析存放區的連線使用私人端點。
  2. 重試查詢成功。

因應措施：工程小組知道此行為，而且可以採取下列動作來快速緩和：

  1. 重試失敗的查詢。 其會自動重新整理過期的權杖。
  2. 停用私人端點。 套用這項變更之前，請先與您的安全性小組確認其符合公司的安全性原則。

Azure Cosmos DB 分析存放區檢視會在數據行中傳播錯誤的屬性

在 Cosmos DB 分析存放區上使用 Azure Synapse 無伺服器集區中的檢視時，如果 Cosmos DB 分析存放區中的檔案有所變更，則變更不會正確傳播至 SELECT 語句，客戶會在檢視上使用 。 因此，屬性會錯誤地對應至結果中的不同數據行。

因應措施：工程小組知道此行為，而且可以採取下列動作來快速緩和：

  1. 重新命名數據行以重新建立檢視。
  2. 盡可能避免使用檢視。

如果使用認證，改變資料庫範圍認證就會失敗

有時候，您可能無法執行 ALTER DATABASE SCOPED CREDENTIAL 查詢。 此問題的根本原因是認證在第一次使用之後快取，使其無法進行變更。 傳回的錯誤為：

  • Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.

因應措施：工程小組目前已察覺此行為，並正在處理修正程式。 作為因應措施，您可以DROP和 CREATE 認證，這也表示使用認證重新建立外部數據表。 或者，您可以與 Microsoft 支援服務 小組連絡以取得協助。

無伺服器 SQL 集區中的查詢失敗

令牌到期可能會導致其查詢執行期間發生錯誤，儘管使用者擁有記憶體的必要許可權。 這些錯誤訊息也可能因為常見的使用者錯誤而發生，例如當角色型訪問控制 （RBAC） 角色未指派給記憶體帳戶時。

範例錯誤訊息：

  • WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}
  • Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.
  • Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.
  • Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.
  • Error 16536: Cannot bulk load because the file "%ls" could not be opened.

因應措施：

解決方法會因驗證、 Microsoft Entra（先前稱為 Azure Active Directory） 或 受控服務識別 （MSI）而有所不同：

針對 Microsoft Entra 令牌到期：

  • 對於長時間執行的查詢，請切換至服務主體、受控識別或共用存取簽章 （SAS），而不是使用使用者身分識別。 如需詳細資訊，請參閱 控制 Azure Synapse Analytics 中無伺服器 SQL 集區的記憶體帳戶存取。

  • 重新啟動用戶端 （SSMS/ADS） 以取得新的權杖以建立連線。

針對 MSI 令牌到期：

  • 然後停用然後啟動集區，以清除令牌快取。 請洽詢 Microsoft 支援服務 小組以取得協助。

由於授權標頭太長，儲存體 存取問題

無伺服器 SQL 集區中的範例錯誤訊息：

  • File {path} cannot be opened because it does not exist or it is used by another process.
  • Content of directory on path {path} cannot be listed.
  • WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}

執行查詢時，會出現這些一般記憶體存取錯誤。 某個工作區中的使用者可能會發生此問題，但在其他工作區中運作正常。 此行為預期會因為令牌大小而造成。

在 PowerShell 中執行下列命令，以檢查 Microsoft Entra 令牌長度。 非 -ResourceUrl 公用雲端的參數值會有所不同。 如果令牌長度接近 11000 或更長，請參閱 風險降低 一節。

(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length

因應措施：

建議的因應措施如下：

  • 切換至受控識別記憶體授權，如記憶體訪問控制中所述。
  • 減少安全組數目（具有90個或更少的安全組會產生具有相容長度的令牌）。
  • 增加超過 200 個安全組的數目（因為變更令牌的建構方式，它會包含 MS Graph API URI，而不是完整的群組清單）。 在您需要將使用者新增至新建立的群組之後，藉由遵循 受控群組來新增虛擬/人工群組，即可達成此目的。

最近關閉的已知問題

Synapse 元件 問題 狀態 已解決日期
Azure Synapse 無伺服器 SQL 集區 使用 Microsoft Entra 驗證的查詢會在 1 小時後失敗 已解決 2023 年 8 月
Azure Synapse 無伺服器 SQL 集區 使用 OPENROWSET 讀取 Cosmos DB 數據時查詢失敗 已解決 2023 年 3 月
Azure Synapse Apache Spark 集區 在管線中使用筆記本時，無法使用 Azure Synapse 專用 SQL 集區從 Synapse Spark 寫入 SQL 專用集區 連線 或 Apache Spark 已解決 2023 年 6 月
Azure Synapse Apache Spark 集區 由於記憶體帳戶節流，某些Spark作業或工作太早失敗，錯誤碼503 已解決 2023 年 11 月

Azure Synapse Analytics 無伺服器 SQL 集區最近關閉的已知問題摘要

使用 Microsoft Entra 驗證的查詢會在 1 小時後失敗

使用 Microsoft Entra 驗證的 SQL 聯機會在 1 個多小時後保持作用中，開始失敗。 這包括使用 Microsoft Entra 傳遞驗證和與 Microsoft Entra 識別符互動的語句來查詢記憶體，例如 CREATE EXTERNAL PROVIDER。 這會影響每個讓連線保持作用中的工具，例如 SSMS 和 ADS 中的查詢編輯器。 開啟新連線以執行查詢的工具不會受到影響，例如 Synapse Studio。

狀態：已解決

使用 OPENROWSET 讀取 Azure Cosmos DB 數據時查詢失敗

使用 OPENROWSET 從無伺服器 SQL 集區到 Cosmos DB 分析存放區的查詢失敗，並出現下列錯誤訊息：

Resolving CosmosDB path has failed with error 'bad allocation'.

狀態：已解決

Azure Synapse Analytics Apache Spark 集區最近關閉的已知問題摘要

在管線中使用筆記本時，無法使用適用於 Apache Spark 的 Azure Synapse 專用 SQL 集區連接器從 Synapse Spark 寫入 SQL 專用集區

雖然在管線中使用 Azure Synapse 專用 SQL 集區 連線 或 Apache Spark 使用 Notebooks 撰寫 Azure Synapse 專用集區，但會看到錯誤訊息：

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.

狀態：已解決

由於記憶體帳戶節流，某些Spark作業或工作太早失敗，錯誤碼503

在 2023 年 10 月 3 日至 2023 年 11 月 16 日之間，少數 Azure Synapse Analytics Apache Spark 集區可能會因為記憶體 API 限制閾值而發生 Spark 作業/工作失敗。

狀態：已解決

相關內容