CREATE WORKLOAD GROUP （Transact-SQL）

選取產品

在以下資料列中，選取您感興趣的產品名稱，隨即只會顯示該產品的資訊。

* SQL 伺服器 *  

SQL 受控執行個體

Azure Synapse
分析

 

SQL Server 與 SQL 受控執行個體

建立資源管理員工作負載群組，並將工作負載群組與資源管理員資源集區產生關聯。

資源管理員無法在每一版的 SQL Server 中使用。 如需 SQL Server 版本支援的功能清單，請參閱 SQL Server 2022 的版本和支援功能。

注意

若要修改 Azure SQL 受控實例中的資源管理員組態，您必須位於主要復本上 master 資料庫的內容中。

Transact-SQL 語法慣例。

語法

CREATE WORKLOAD GROUP group_name
[ WITH
    ( [ IMPORTANCE = { LOW | MEDIUM | HIGH } ]
      [ [ , ] REQUEST_MAX_MEMORY_GRANT_PERCENT = value ]
      [ [ , ] REQUEST_MAX_CPU_TIME_SEC = value ]
      [ [ , ] REQUEST_MEMORY_GRANT_TIMEOUT_SEC = value ]
      [ [ , ] MAX_DOP = value ]
      [ [ , ] GROUP_MAX_REQUESTS = value ]
      [ [ , ] GROUP_MAX_TEMPDB_DATA_MB = value ]
      [ [ , ] GROUP_MAX_TEMPDB_DATA_PERCENT = value ] )
]
[ USING {
    [ pool_name | [default] ]
    [ [ , ] EXTERNAL external_pool_name | [ default ] ]
    } ]
[ ; ]

引數

group_name

工作負載群組的使用者定義名稱。 group_name 英數位元，最多可以有 128 個字元，在 Database Engine 的實例內必須是唯一的，而且必須符合 資料庫標識符的規則。

IMPORTANCE = { LOW |MEDIUM |HIGH }

指定要求在工作負載群組中的相對重要性。 預設值為 MEDIUM。

IMPORTANCE 是包含工作負載群組的資源集區本機。 相同資源集區內不同重要性的工作負載群組彼此影響，但不會影響其他資源集區中的工作負載群組。

REQUEST_MAX_MEMORY_GRANT_PERCENT = 值

指定單一要求可從集區取得的最大查詢工作區內存數量。 值 是由 MAX_MEMORY_PERCENT所定義的資源集區大小百分比。 預設值為 25。

在 SQL Server 2017 （14.x） 和較舊版本中，值 是整數，允許的範圍是從 1 到 100。

從 SQL Server 2019 （15.x） 開始，值可以是使用 float 數據類型的小數。 允許的範圍是從 0 到 100。

重要

指定的數量只是指透過查詢記憶體授與取得的查詢工作區內存。

不建議設定 值 太大（例如大於 70），因為伺服器可能無法為其他並行查詢預留足夠的可用記憶體。 這可能會導致記憶體授與逾時，錯誤 8645。

將 值 設定為 0 或小型值，可能會防止對需要工作區內存的運算符進行查詢，例如 sort 和 hash，以免在使用者定義的工作負載群組中執行。 如果查詢記憶體需求超過此參數所定義的限制，就會發生下列行為：

• 針對使用者定義的工作負載群組，伺服器會嘗試減少要求 （DOP） 的平行處理原則程度（查詢），直到記憶體需求低於限制，或直到 DOP 等於 1 為止。 如果查詢記憶體需求仍然大於限制，就會發生錯誤 8657，且查詢失敗。
• 針對 internal 和 default 工作負載群組，伺服器允許查詢取得所需的記憶體。

在任一情況下，如果伺服器沒有足夠的物理記憶體，可能會發生 錯誤 8645。

REQUEST_MAX_CPU_TIME_SEC = 值

指定批次要求可以使用的最大CPU時間量，以秒為單位。 value 必須是 0 或正整數。 value 的預設設定為 0，這代表沒有限制。

超過最大 CPU 時間時，會產生 cpu_threshold_exceeded 擴充事件和追蹤事件。 如需詳細資訊，請參閱 CPU 閾值超過事件類別。

在 Azure SQL 受控實例中，超過 CPU 時間上限時，資源管理員會中止要求，並出現錯誤 10961。

在 SQL Server 中，資源管理員預設不會中止要求。 不過，從 SQL Server 2016 （13.x） SP2 和 SQL Server 2017 （14.x） CU3 開始，資源管理員會在啟用追蹤旗標 2422 時中止要求，並超過最大 CPU 時間時發生錯誤 10961。

注意

CPU 時間使用量的偵測間隔為五秒。 如果查詢超過指定的限制至少五秒，就會產生事件。 不過，如果查詢超過指定的臨界值少於五秒，可能會根據查詢的時間和上次偵測掃掠的時間而遺漏其偵測。

REQUEST_MEMORY_GRANT_TIMEOUT_SEC = 值

指定查詢可以等候查詢工作區內存授與可用的最大時間，以秒為單位。 value 必須是 0 或正整數。 value 的預設設定 0 會根據查詢成本使用內部計算來判斷最大時間。

達到記憶體授與逾時時，查詢不一定會失敗。 只有執行太多並行查詢時，查詢才會失敗。 否則，查詢可能只會獲得最小記憶體授與，因而降低查詢效能。

MAX_DOP = 值

指定平行查詢執行的最大平行處理原則程度 （MAXDOP）。 value 允許範圍是從 0 至 64。 value 的預設設定 0 會使用全域設定。

如需詳細資訊，請參閱 MAXDOP。

GROUP_MAX_REQUESTS = 值

指定在工作負載群組中可允許執行的最大同時要求數。 value 必須是 0 或正整數。 value 的預設值為 0，會允許無限制的要求。 達到最大並行要求時，可以建立該群組中的會話，但會處於等候狀態，直到並行要求數目低於指定的值為止。

GROUP_MAX_TEMPDB_DATA_MB = 價值

指定工作負載群組可在數據檔中 tempdb 耗用的最大空間量，以 MB 為單位。 值 必須是 0、正數或 NULL。 允許小數值。

當值為 0 時， tempdb 不允許工作負載群組中的會話配置空間。 未設定值時，資源管理員不會限制 tempdb 工作負載群組的空間耗用量。

限制是工作負載群組中所有會話所耗用 tempdb 的總空間。

當在工作負載群組中執行的要求嘗試增加 tempdb 工作負載群組超過所設定 GROUP_MAX_TEMPDB_DATA_MB限制的數據空間耗用量時，資源管理員會中止要求，並出現錯誤 1138。 如需詳細資訊，請參閱 Tempdb 空間資源治理。

GROUP_MAX_TEMPDB_DATA_PERCENT = 價值

指定工作負載群組可在數據檔中 tempdb 取用的最大空間量，以大小上限 tempdb 的百分比表示。 如需大小上限 tempdb 的定義，請參閱 百分比限制設定。 值 必須在 0 到 100 之間，或為 NULL。 允許小數值。

當值為 0 時， tempdb 不允許工作負載群組中的會話配置空間。 未設定值時，資源管理員不會限制 tempdb 工作負載群組的空間耗用量。 設定時 GROUP_MAX_TEMPDB_DATA_MB ，或未定義大小上限時 tempdb ， GROUP_MAX_TEMPDB_DATA_PERCENT 沒有任何作用。

限制是工作負載群組中所有會話所耗用 tempdb 的總空間。

當在工作負載群組中執行的要求嘗試增加 tempdb 工作負載群組超過所設定 GROUP_MAX_TEMPDB_DATA_PERCENT限制的數據空間耗用量時，資源管理員會中止要求，並出現錯誤 1138。 如需詳細資訊，請參閱 Tempdb 空間資源治理。

USING { pool_name |[default] }

將工作負載群組與 pool_name所識別的使用者定義資源集區產生關聯，或與 default 資源集區建立關聯。 如果未提供 pool_name，或未指定 USING 自變數，工作負載群組會與內建 default 集區相關聯。

default 是保留字，在 USING中指定時，必須以方括號（[]）或引號（""） 括住。

內建資源集區和工作負載群組會使用所有小寫名稱，例如 default。 在使用區分大小寫定序的伺服器上，使用小寫 default。 不區分大小寫定序的伺服器會將 default、Default和 DEFAULT 視為相同的值。

EXTERNAL external_pool_name |[ default ]

適用於：SQL Server 2016 (13.x) 和更新版本。

工作負載群組可指定外部資源集區。 您可以定義工作負載群組，並將它與兩個集區產生關聯：

• Database Engine 工作負載的資源集區。
• 一個用於外部處理的外部資源集區。 如需詳細資訊，請參閱 sp_execute_external_script。

備註

如需詳細資訊，請參閱 Resource Governor 和 Resource Governor 工作負載群組。

MAXDOP

針對指定的查詢，會決定有效的 MAXDOP，如下所示：

• 只要查詢提示未超過工作負載群組 MAXDOP 設定，MAX_DOP 就會接受。
• MAXDOP 查詢提示一律會覆寫 max degree of parallelism 伺服器組態。 如需詳細資訊，請參閱 伺服器組態：平行處理原則的最大程度。
• 工作負載群組 MAX_DOP 會覆寫 max degree of parallelism 伺服器組態和 MAXDOP資料庫範圍設定。

MAXDOP 限制是以工作為基礎。 它不是根據要求或查詢限制。 在平行查詢執行期間，單一要求可能會繁衍指派給 排程器的多個工作。 如需詳細資訊，請參閱 線程和工作架構指南。

當查詢在編譯時期標示為序列時（MAXDOP = 1），不論工作負載群組或伺服器組態設定為何，在運行時間都無法使用平行處理原則執行。 判斷查詢 MAXDOP 之後，只能因為記憶體壓力而降低。 工作負載群組重新設定不會影響在記憶體授與佇列中等候的查詢。

索引建立

基於效能考慮，允許索引建立使用比最初授與更多的記憶體工作區。 資源管理員支援此特殊處理。 不過，初始授與和任何其他記憶體授與會受限於工作負載群組和資源集區設定。

在數據分割數據表上建立非對齊索引所耗用的記憶體，與所涉及的分割區數目成正比。 如果所需的記憶體總計超過 REQUEST_MAX_MEMORY_GRANT_PERCENT 工作負載群組設定強制執行的每個查詢限制，索引建立可能會失敗。 由於 default 工作負載群組允許查詢超過每個查詢限制，且所需的記憶體下限為回溯相容性，因此，如果 default 資源集區有足夠的記憶體總計，您可以使用 default 工作負載群組來建立相同的索引。

權限

需要 CONTROL SERVER 許可權。

範例

在 newReports 資源集區中建立名為 default 的工作負載群組，並限制記憶體授與上限、要求的最大 CPU 時間，以及 MAXDOP。

CREATE WORKLOAD GROUP newReports
WITH (
     REQUEST_MAX_MEMORY_GRANT_PERCENT = 2.5,
     REQUEST_MAX_CPU_TIME_SEC = 100,
     MAX_DOP = 4
     )
USING [default];

相關內容

• 教學課程：資源管理員設定範例和最佳做法
• 資源管理員
• Resource Governor 工作負載群組
• 建立工作負載群組
• ALTER WORKLOAD GROUP （Transact-SQL）
• DROP WORKLOAD GROUP （Transact-SQL）
• CREATE RESOURCE POOL （Transact-SQL）
• ALTER RESOURCE POOL （Transact-SQL）
• DROP RESOURCE POOL （Transact-SQL）
• ALTER RESOURCE GOVERNOR （Transact-SQL）
• sys.resource_governor_workload_groups
• sys.dm_resource_governor_workload_groups