CREATE WORKLOAD GROUP (Transact-SQL)

Selecionar um produto

Na linha a seguir, selecione o nome do produto em que você tem interesse e somente as informações do produto serão exibidas.

* SQL Server *  

Instância Gerenciada de SQL

Azure Synapse
Análise

 

SQL Server e Instância Gerenciada de SQL

Cria um grupo de carga de trabalho do Administrador de recursos e o associa a um pool de recursos do Administrador de recursos. O Resource Governor não está disponível em todas as edições do SQL Server. Para obter uma lista de recursos com suporte nas edições do SQL Server, confira Edições e recursos com suporte no SQL Server 2022.

Convenções de sintaxe Transact-SQL.

Sintaxe

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 ] )
 ]
[ USING {
    [ pool_name | "default" ]
    [ [ , ] EXTERNAL external_pool_name | "default" ] ]
    } ]
[ ; ]

Argumentos

group_name

É o nome definido pelo usuário do grupo de carga de trabalho. group_name é alfanumérico, pode ter até 128 caracteres, deve ser exclusivo dentro de uma instância do SQL Server e deve obedecer às regras de identificadores de banco de dados.

IMPORTANCE = { LOW | MEDIUM | HIGH }

Especifica a importância relativa de uma solicitação no grupo de carga de trabalho. A importância é uma das seguintes, com MEDIUM sendo o padrão:

• LOW
• MEDIUM (padrão)
• HIGH

Observação

Internamente, cada configuração de importância é armazenada como um número usado para cálculos.

IMPORTANCE é local para o pool de recursos. Os grupos de carga de trabalho de importâncias diferentes no mesmo pool de recursos afetam uns aos outros, mas não afetam grupos de carga de trabalho em outro pool de recursos.

REQUEST_MAX_MEMORY_GRANT_PERCENT = valor

Especifica o máximo de memória que uma única solicitação pode usar do pool. valor é um percentual relativo ao tamanho do pool de recursos especificado por MAX_MEMORY_PERCENT. O valor padrão é 25.

valor é um inteiro até o SQL Server 2017 (14.x) e o intervalo permitido é de 1 a 100. Começando com SQL Server 2019 (15.x), o valor é um tipo de dados float e o intervalo permitido é de 0 a 100.

Importante

A quantidade especificada se refere apenas à memória de concessão de execução da consulta.

A configuração de value como 0 impede a execução de consultas com as operações SORT e HASH JOIN em grupos de cargas de trabalho definidos pelo usuário.

Não é recomendável definir value com um valor maior que 70, pois o servidor poderá não conseguir separar memória livre suficiente se outras consultas simultâneas estiverem sendo executadas. Isso pode eventualmente levar ao erro 8645, tempo limite da consulta excedido.

Se os requisitos de memória de consulta excederem o limite especificado por esse parâmetro, o servidor fará o seguinte:

• Para grupos de cargas de trabalho definidos pelo usuário, o servidor tenta reduzir o grau de paralelismo da consulta, até que o requisito de memória caia abaixo do limite, ou até que o grau de paralelismo seja igual a 1. Se o requisito de memória de consulta ainda for maior que o limite, ocorrerá o erro 8657.

• Para grupos de cargas de trabalho internos e padrão, o servidor permite que a consulta obtenha a memória necessária.

Esteja ciente de que ambos os casos estarão sujeitos ao erro de tempo limite 8645 se a memória física do servidor for insuficiente.

REQUEST_MAX_CPU_TIME_SEC = valor

Especifica o tempo máximo de CPU, em segundos, que uma solicitação pode usar. value precisa ser 0 ou um inteiro positivo. A configuração padrão de value é 0, o que significa ilimitado.

Observação

Por padrão, o Resource Governor não impedirá a continuação de uma solicitação se o tempo máximo for excedido. Porém, um evento será gerado. Para obter mais informações, consulte Classe de evento CPU Threshold Exceeded.

Importante

Começando com o SQL Server 2016 (13.x) SP2 e SQL Server 2017 (14.x) CU3 e usando o sinalizador de rastreamento 2422, o Resource Governor anulará uma solicitação quando o tempo máximo for excedido.

REQUEST_MEMORY_GRANT_TIMEOUT_SEC = valor

Especifica o tempo máximo, em segundos, que uma consulta pode esperar pela disponibilização de uma concessão de memória (memória do buffer do trabalho). value precisa ser 0 ou um inteiro positivo. A configuração padrão de value, 0, usa um cálculo interno baseado no custo da consulta para determinar o tempo máximo.

Observação

Nem sempre uma consulta falha quando o tempo limite de concessão de memória é atingido. A consulta falhará somente se houver muitas consultas simultâneas em execução. Caso contrário, a consulta poderá obter apenas a concessão de memória mínima, resultando em uma queda no desempenho de consulta.

MAX_DOP = valor

Especifica o grau máximo de paralelismo (MAXDOP) para execução de consulta paralela. value precisa ser 0 ou um inteiro positivo. O intervalo permitido para value é de 0 a 64. A configuração padrão para value, 0, usa a configuração global.

MAX_DOP é tratado como segue:

• MAX_DOP como dica de consulta será cumprido, contanto que não exceda o grupo de cargas de trabalho MAX_DOP.

• MAX_DOP como uma dica de consulta sempre substitui o 'grau máximo de paralelismo' sp_configure.

• O grupo de carga de trabalho MAX_DOP substitui o 'grau máximo de paralelismo' sp_configure.

• Se a consulta for marcada como serial (MAX_DOP = 1) em tempo de compilação, ela não poderá ser revertida a paralela em tempo de execução, independentemente do grupo de carga de trabalho ou da configuração sp_configure.

Depois de ser configurado, o DOP só pode ser reduzido sob pressão de concessão de memória. A reconfiguração do grupo de carga de trabalho não é visível durante a espera na fila de concessão de memória.

Observação

O grupo de carga de trabalho MAX_DOP substitui a configuração do servidor para o grau máximo de paralelismo e a configuração no escopo do MAXDOP banco de dados.

Dica

Para fazer isso no nível da consulta, use a dica de MAXDOP consulta. Definir o grau máximo de paralelismo como uma dica de consulta funciona, desde que não exceda o grupo de carga de trabalho do MAX_DOP. Se o valor de dica de consulta MAXDOP exceder o valor que está configurado usando o Resource Governor, o Mecanismo de Banco de Dados do SQL Server usará o valor MAX_DOP do Resource Governor. A dica de consulta do MAXDOP sempre substitui a configuração de servidor para o grau máximo de paralelismo.

Para fazer isso no nível do banco de dados, use a configuração no escopo do MAXDOP banco de dados.

Para fazer isso no nível do servidor, use o MAXDOP (grau máximo de paralelismo) na opção de configuração do servidor.

GROUP_MAX_REQUESTS = valor

Especifica o número máximo de solicitações simultâneas permitido para execução no grupo de carga de trabalho. value precisa ser 0 ou um inteiro positivo. A configuração padrão de valor é 0 e permite solicitações ilimitadas. Quando as solicitações simultâneas máximas são alcançadas, um usuário nesse grupo pode fazer logon, mas é colocado em um estado de espera até que as solicitações simultâneas sejam ignoradas abaixo do valor especificado.

USING { pool_name | "default" }

Associa o grupo de carga de trabalho ao pool de recursos definido pelo usuário, identificado por pool_name. Na realidade, isso coloca o grupo de carga de trabalho no pool de recursos. Se pool_name não é fornecido ou se o argumento USING não é usado, o grupo de carga de trabalho é colocado no pool padrão predefinido do Resource Governor.

"default" é uma palavra reservada e, quando usada com USING, deve ficar entre aspas ("") ou colchetes ([]).

Observação

Grupos de cargas de trabalho e pools de recursos predefinidos usam nomes em letras minúsculas, como "default". Isso deve ser levado em consideração nos servidores que usam ordenação com diferenciação de maiúsculas e minúsculas. Servidores com ordenação sem diferenciação de maiúsculas e minúsculas, como SQL_Latin1_General_CP1_CI_AS, tratarão "default" e "Default" da mesma forma.

EXTERNAL external_pool_name | "padrão"

Aplica-se a: SQL Server 2016 (13.x) e posterior.

O grupo de carga de trabalho pode especificar um pool de recursos externo. Você pode definir um grupo de carga de trabalho e associá-lo a dois pools:

• Um pool de recursos para cargas de trabalho e consultas do SQL Server
• Um pool de recursos externo para processos externos. Para obter mais informações, confira sp_execute_external_script (Transact-SQL).

Comentários

Quando REQUEST_MEMORY_GRANT_PERCENT é usado, a criação de índice tem permissão para usar mais memória do workspace do que a concedida inicialmente, para melhorar o desempenho. Esse tratamento especial tem o suporte do Resource Governor no SQL Server. Porém, a concessão inicial e qualquer concessão de memória adicional estão limitadas pelas configurações de pool de recursos e de grupo de carga de trabalho.

O limite de MAX_DOP é definido por tarefa. Não é um limite por solicitação ou por consulta. Isso significa que, durante uma execução de consulta paralela, uma solicitação única pode gerar várias tarefas que são atribuídas a um agendador. Para saber mais, confira o Guia de arquitetura de threads e tarefas.

Quando MAX_DOP for usado e uma consulta for marcada como serial em tempo de compilação, ela não poderá ser revertida a paralela em tempo de execução, independentemente do grupo de carga de trabalho ou da definição de configuração do servidor. Depois de configurar o MAX_DOP, ele só poderá ser reduzido devido à pressão de memória. A reconfiguração do grupo de carga de trabalho não é visível durante a espera na fila de concessão de memória.

Criação de índice em uma tabela particionada

A memória consumida pela criação de índice na tabela particionada não alinhada é proporcional ao número de partições envolvidas. Se a memória total necessária exceder o limite por consulta REQUEST_MAX_MEMORY_GRANT_PERCENT imposto pela configuração de grupo de cargas de trabalho do Resource Governor, poderá ocorrer uma falha na criação do índice. Como o grupo de carga de trabalho "default" permite que uma consulta exceda o limite por consulta com o mínimo de memória necessária, o usuário talvez possa executar a mesma criação de índice no grupo de carga de trabalho "default" caso o pool de recursos "default" tenha memória total suficiente configurada para executar tal consulta.

Permissões

Requer a permissão CONTROL SERVER.

Exemplo

Crie um grupo de carga de trabalho chamado newReports, que usa as configurações padrão do Resource Governor e está no pool padrão desse Resource Governor. O exemplo especifica o pool default, mas isso não é necessário.

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

Confira também

• 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)