ALTER EXTERNAL RESOURCE POOL (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Instância Gerenciada SQL do Azure

Altera um pool externo do Administrador de Recursos que especifica recursos que podem ser usados por processos externos.

Para os Serviços de Aprendizado de rterm.exeMáquina, o pool externo controla , python.exe, BxlServer.exee outros processos gerados por eles.

Transact-SQL convenções de sintaxe

Sintaxe

ALTER EXTERNAL RESOURCE POOL { pool_name | "default" }
[ WITH (
    [ MAX_CPU_PERCENT = value ]
    [ [ , ] MAX_MEMORY_PERCENT = value ]
    [ [ , ] MAX_PROCESSES = value ]
    )
]
[ ; ]

<CPU_range_spec> ::=
{ CPU_ID | CPU_ID  TO CPU_ID } [ ,...n ]

ALTER EXTERNAL RESOURCE POOL { pool_name | "default" }
[ WITH (
   [ MAX_CPU_PERCENT = value ]
   [ [ , ] AFFINITY CPU =
           {
               AUTO
             | ( <cpu_range_spec> )
             | NUMANODE = (( <NUMA_node_id> )
           } ]   
   [ [ , ] MAX_MEMORY_PERCENT = value ]
   [ [ , ] MAX_PROCESSES = value ]
   )
]
[ ; ]

<CPU_range_spec> ::=
{ CPU_ID | CPU_ID  TO CPU_ID } [ ,...n ]

Arguments

{ pool_name | "padrão" }
É o nome de um pool de recursos externos definido pelo usuário existente ou o pool de recursos externos padrão que é criado quando o SQL Server é instalado. "default" deve ser colocado entre aspas ("") ou colchetes ([]) quando usado com para evitar conflito com ALTER EXTERNAL RESOURCE POOLDEFAULT, que é uma palavra reservada do sistema.

MAX_CPU_PERCENT =valor
Especifica a largura de banda média máxima da CPU que todas as solicitações no pool de recursos externos podem receber quando há contenção de CPU. value é um inteiro. O intervalo permitido para o valor é de 1 a 100.

MAX_MEMORY_PERCENT =valor
Especifica a memória total do servidor que pode ser usada por solicitações nesse pool de recursos externos. value é um inteiro. O intervalo permitido para o valor é de 1 a 100.

MAX_PROCESSES =valor
Especifica o número máximo de processos permitidos para o pool de recursos externos. Especifique 0 para definir um limite ilimitado para o pool, que é vinculado apenas pelos recursos do computador.

MAX_CPU_PERCENT =valor
Especifica a largura de banda média máxima da CPU que todas as solicitações no pool de recursos externos podem receber quando há contenção de CPU. value é um inteiro. O intervalo permitido para o valor é de 1 a 100.

AFFINITY {CPU = AUTO | <( CPU_range_spec> ) | NUMANODE = (<NUMA_node_range_spec>)}
Anexe o pool de recursos externos a CPUs específicas.

AFFINITY CPU = (<CPU_range_spec>) mapeia o pool de recursos externos para as CPUs do SQL Server identificadas pelo CPU_IDs fornecido. Quando você usa AFFINITY NUMANODE = (<NUMA_node_range_spec>), o pool de recursos externos é afinizado às CPUs físicas do SQL Server que correspondem a determinado nó NUMA ou intervalo de nós.

MAX_MEMORY_PERCENT =valor
Especifica a memória total do servidor que pode ser usada por solicitações nesse pool de recursos externos. value é um inteiro. O intervalo permitido para o valor é de 1 a 100.

MAX_PROCESSES =valor
Especifica o número máximo de processos permitidos para o pool de recursos externos. Especifique 0 para definir um limite ilimitado para o pool, que é vinculado apenas pelos recursos do computador.

Observações

O Database Engine implementa o pool de recursos quando executa a ALTER RESOURCE GOVERNOR instrução RECONFIGURATION.

Para obter informações gerais sobre pools de recursos, consulte Pool de Recursos do Administrador de Recursos, sys.resource_governor_external_resource_pools (Transact-SQL) e sys.dm_resource_governor_external_resource_pool_affinity (Transact-SQL).

Para obter informações específicas sobre o uso de pools de recursos externos para governar trabalhos de aprendizado de máquina, consulte Governança de recursos para aprendizado de máquina no SQL Server...

Permissions

Requer CONTROL SERVER permissão.

Examples

A instrução a seguir altera um pool externo, restringindo o uso da CPU a 50% e a memória máxima a 25% da memória disponível no computador.

ALTER EXTERNAL RESOURCE POOL ep_1
WITH (
    MAX_CPU_PERCENT = 50
    , MAX_MEMORY_PERCENT = 25
);
GO
ALTER RESOURCE GOVERNOR RECONFIGURE;
GO
ALTER EXTERNAL RESOURCE POOL ep_1
WITH (
    MAX_CPU_PERCENT = 50
    , AFFINITY CPU = AUTO
    , MAX_MEMORY_PERCENT = 25
);
GO
ALTER RESOURCE GOVERNOR RECONFIGURE;
GO

Consulte também