Azure Synapse SQL 中的散發建議程式

發行項
01/10/2024

適用於： Azure Synapse Analytics 專用 SQL 集區（先前稱為 SQL DW）

在 Azure Synapse SQL 中，每個數據表都是使用客戶選擇的策略來散發（迴圈配置資源、哈希分散式、復寫的）。選擇的散發策略可能會大幅影響查詢效能。

Azure Synapse SQL 的散發建議程式（DA）功能會分析客戶查詢，並建議數據表的最佳散發策略以改善查詢效能。建議程式要考慮的查詢可由客戶提供，或從 DMV 中提供的歷史查詢提取。

注意

散發建議程式目前為 Azure Synapse Analytics 預覽版。預覽功能僅供測試之用，不應用於生產執行個體或生產資料。作為預覽功能，Distribution Advisor 可能會變更行為或功能。如果數據很重要，請保留測試數據的複本。散發建議程式不支援多數據行分散式數據表。

必要條件

執行 T-SQL 語句 SELECT @@version ，以確保您的 Azure Synapse Analytics 專用 SQL 集區是 10.0.15669 版或更高版本。如果您的版本較低，新版本應該會在維護週期期間自動到達布建的專用SQL集區。
在執行建議程式之前，請確定統計數據可供使用且處於最新狀態。如需詳細資訊，請參閱管理數據表統計數據、CREATE STATISTICS 和 UPDATE STATISTICS 文章，以取得統計數據的詳細數據。
使用 SET RECOMMENDATIONS T-SQL 命令，為目前會話啟用 Azure Synapse 散發建議程式。

分析工作負載併產生散發建議

下列教學課程說明使用 Distribution Advisor 功能的範例使用案例，以分析客戶查詢，並建議最佳的散發策略。

Distribution Advisor 只會分析用戶數據表上執行的查詢。

1.建立 Distribution Advisor 預存程式

若要輕鬆地執行建議程式，請在資料庫中建立兩個新的預存程式。執行可從 GitHub 下載的CreateDistributionAdvisor_PublicPreview腳稿：

Command	描述
`dbo.write_dist_recommendation`	定義 DA 將分析的查詢。您可以手動提供查詢，或從sys.dm_pdw_exec_requests中實際工作負載讀取最多 100 個過去的查詢。
`dbo.read_dist_recommendation`	執行建議程式並產生建議。

以下是如何執行 Advisor 的範例。

2a. 在 DMV 中的過去工作負載上執行 Advisor

執行下列命令，以讀取工作負載中最後 100 個查詢，以進行分析和散發建議：

EXEC dbo.write_dist_recommendation <Number of Queries max 100>, NULL
go
EXEC dbo.read_dist_recommendation;
go

若要查看 DA 分析的查詢，請執行可從 GitHub 下載的 e2e_queries_used_for_recommendations.sql 腳本。

2b. 在選取的查詢上執行 Advisor

中的 dbo.write_dist_recommendation 第一個參數應該設定為 0，而第二個參數是 DA 將分析最多 100 個查詢的分號分隔清單。在下列範例中，我們想要查看兩個以分號分隔的語句分佈建議， select count (*) from t1; 以及 select * from t1 join t2 on t1.a1 = t2.a1;。

EXEC dbo.write_dist_recommendation 0, 'select count (*) from t1; select * from t1 join t2 on t1.a1 = t2.a1;'
go
EXEC dbo.read_dist_recommendation;
go

3. 檢視建議

系統 dbo.read_dist_recommendation 預存程式會在執行完成時，以下列格式傳回建議：

數據行名稱	說明
Table_name	DA 分析的數據表。不論建議的變更為何，每個數據表各有一行。
Current_Distribution	目前的數據表散發策略。
Recommended_Distribution	建議的散發。這與建議的變更可能相同 `Current_Distribution` 。
Distribution_Change_Command	要實作建議的 CTAS T-SQL 命令。

4. 實作建議

執行 Distribution Advisor 提供的 CTAS 命令，以使用建議的散發策略建立新的數據表。
修改查詢以在新數據表上執行。
在舊數據表和新數據表上執行查詢，以比較效能改進。

注意

若要協助我們改善散發建議程式，請填寫此快速問卷。

疑難排解

本節包含常見的疑難解答案例和您可能會遇到的常見錯誤。

1.先前執行 Advisor 的過時狀態

1a. 徵兆：

您在執行 Advisor 時看到此錯誤訊息：

Msg 110813, Level 16, State 1, Line 1
Calling GetLastScalarResult() before executing scalar subquery.

1b. 避免方法：

確認您使用單引號 '' 在選取的查詢上執行 Advisor。
在 SSMS 中啟動新的工作階段，然後執行建議程式。

2.執行建議程式期間發生錯誤

2a. 徵兆：

[結果] 窗格如下所示 CommandToInvokeAdvisorString ，但未顯示 RecommendationOutput 下列內容。

例如，您只會 Command_to_Invoke_Distribution_Advisor 看到結果集。

Screenshot of the output of a T-SQL result showing the Command_to_Invoke_Distribution_Advisor.

但不包含包含資料表的第二個結果集會變更 T-SQL 命令：

Screenshot of the output of a T-SQL result showing the Command_to_Invoke_Distribution_Advisor with a second resultset containing table change T-SQL commands.

2b. 避免方法：

檢查上述的 CommandToInvokeAdvisorString 輸出。
拿掉可能不再有效的查詢，這些查詢可能已從手動選取的查詢或透過編輯 WHERE 子句從 DMV 新增： DA 所考慮的查詢。

3.建議輸出后處理期間發生錯誤

3a. 徵兆：

您會看到下列錯誤訊息。

Invalid length parameter passed to the LEFT or SUBSTRING function.

3b. 避免方法：

請確定您擁有 GitHub 中最新版的預存程式：

Azure Synapse 產品群組意見反應