ALTER EXTERNAL RESOURCE POOL (Transact-SQL)

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores Azure SQL Managed Instance

Modifica un grupo externo de Resource Governor que especifica los recursos que pueden usarse en procesos externos.

Para R Services (en base de datos) en SQL Server 2016 (13.x), el grupo externo rige rterm.exe, BxlServer.exe y otros procesos generados por ellos.

En Machine Learning Services, el grupo externo rige rterm.exe, python.exe, BxlServer.exe y otros procesos generados por ellos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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 ]

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

{ pool_name | "default" }
Es el nombre de un grupo de recursos externos definidos por el usuario ya existente o el grupo de recursos externo predeterminado creado al instalar SQL Server. "default" debe ir entre comillas ("") o corchetes ([]) si se usa con ALTER EXTERNAL RESOURCE POOL para evitar el conflicto con DEFAULT, que es una palabra reservada del sistema.

MAX_CPU_PERCENT =value
Especifica el promedio máximo de ancho de banda de CPU que pueden recibir todas las solicitudes en el grupo de recursos externo cuando haya contención de CPU. value es un valor entero. El intervalo permitido para value es de 1 a 100.

MAX_MEMORY_PERCENT =value
Especifica la memoria total del servidor que puede ser usada por las solicitudes en este grupo de recursos externos. value es un valor entero. El intervalo permitido para value es de 1 a 100.

MAX_PROCESSES =value
Especifica el número máximo de procesos permitidos para el grupo de recursos externos. Especifique 0 para establecer un umbral ilimitado para el grupo, que estará enlazado solamente por recursos del equipo.

MAX_CPU_PERCENT =value
Especifica el promedio máximo de ancho de banda de CPU que pueden recibir todas las solicitudes en el grupo de recursos externo cuando haya contención de CPU. value es un valor entero. El intervalo permitido para value es de 1 a 100.

AFFINITY {CPU = AUTO | ( <CPU_range_spec> ) | NUMANODE = (<NUMA_node_range_spec>)}
Adjunte el grupo de recursos externos a las CPU específicas.

AFFINITY CPU = (<CPU_range_spec>) asigna el grupo de recursos externos a las CPU de SQL Server identificadas por los CPU_ID dados. When you use AFFINITY NUMANODE = (<NUMA_node_range_spec>), se establece una afinidad entre el grupo de recursos externos y las CPU físicas de SQL Server correspondientes al nodo o al intervalo de nodos NUMA especificado.

MAX_MEMORY_PERCENT =value
Especifica la memoria total del servidor que puede ser usada por las solicitudes en este grupo de recursos externos. value es un valor entero. El intervalo permitido para value es de 1 a 100.

MAX_PROCESSES =value
Especifica el número máximo de procesos permitidos para el grupo de recursos externos. Especifique 0 para establecer un umbral ilimitado para el grupo, que estará enlazado solamente por recursos del equipo.

Observaciones

El Motor de base de datos implementa el grupo de recursos al ejecutar la instrucción ALTER RESOURCE GOVERNOR RECONFIGURE.

Para obtener información general sobre los grupos de recursos, vea Grupo de recursos de servidor del regulador de recursos, sys.resource_governor_external_resource_pools (Transact-SQL) y sys.dm_resource_governor_external_resource_pool_affinity (Transact-SQL).

Para obtener información específica sobre el uso de grupos de recursos externos para controlar trabajos de aprendizaje automático, vea Resource governance for machine learning in SQL Server (Gobernanza de recursos para aprendizaje automático en SQL Server).

Permisos

Requiere el permiso CONTROL SERVER.

Ejemplos

La instrucción siguiente cambia un grupo externo, mediante la restricción del uso de CPU al 50 % y la memoria máxima al 25 % de la memoria disponible en el equipo.

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 también