sp_configure (Transact-SQL)

Se aplica a: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Muestra o cambia las opciones de configuración global del servidor actual.

Nota:

Para ver las opciones de configuración de nivel de base de datos, consulte ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Para configurar Soft-NUMA, consulte Soft-NUMA (SQL Server) .

Convenciones de sintaxis de Transact-SQL

Sintaxis

-- Syntax for SQL Server  
  
sp_configure [ [ @configname = ] 'option_name'   
    [ , [ @configvalue = ] 'value' ] ]  

-- Syntax for Parallel Data Warehouse  
  
-- List all of the configuration options  
sp_configure  
[;]  
  
-- Configure Hadoop connectivity  
sp_configure [ @configname= ] 'hadoop connectivity',  
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }  
[;]  
RECONFIGURE  
[;]  

Argumentos

[ @configname = ] 'option_name' Es el nombre de una opción de configuración. option_name es varchar(35)y su valor predeterminado es NULL. El Motor de base de datos de SQL Server reconoce cualquier cadena única que forme parte del nombre de configuración. Si no se especifica, se devuelve la lista completa de opciones.

Para obtener información sobre las opciones de configuración disponibles y sus valores, vea Opciones de configuración del servidor (SQL Server).

[ @configvalue = ] 'value' Es la nueva configuración. value es de tipo inty su valor predeterminado es NULL. El valor máximo depende de la opción individual.

Para ver el valor máximo de cada opción, consulte la columna máxima de la vista de catálogo sys.configurations .

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Cuando se ejecuta sin parámetros, sp_configure devuelve un conjunto de resultados con cinco columnas y ordena alfabéticamente las opciones en orden ascendente, como se muestra en la tabla siguiente.

Los valores de config_value y run_value no son equivalentes automáticamente. Después de actualizar una configuración mediante sp_configure, el administrador del sistema debe actualizar el valor de configuración en ejecución mediante RECONFIGURE o RECONFIGURE WITH OVERRIDE. Para obtener más información, vea la sección Comentarios.

Nombre de la columna	Tipo de datos	Descripción
name	nvarchar(35)	Nombre de la opción de configuración.
Mínimo	int	Valor mínimo de la opción de configuración.
Máximo	int	Valor máximo de la opción de configuración.
config_value	int	Valor en el que se estableció la opción de configuración mediante sp_configure (valor en sys.configurations.value). Para obtener más información sobre estas opciones, vea Opciones de configuración del servidor (SQL Server) y sys.configurations (Transact-SQL).
run_value	int	Valor actualmente en ejecución de la opción de configuración (valor en sys.configurations.value_in_use). Consulte sys.configurations (Transact-SQL) para más información.

Comentarios

Use sp_configure para mostrar o cambiar la configuración de nivel de servidor. Para cambiar la configuración de nivel de base de datos, use ALTER DATABASE. Para cambiar la configuración que afecta solo a la sesión de usuario actual, use la SET instrucción .

Algunas opciones de configuración del servidor solo están disponibles a través de ALTER SERVER CONFIGURATION (Transact-SQL).

Clústeres de macrodatos de SQL Server

Ciertas operaciones, incluida la configuración del servidor (nivel de instancia) o la adición manual de una base de datos a un grupo de disponibilidad, requieren una conexión a la instancia de SQL Server. Las operaciones como sp_configure, RESTORE DATABASE o cualquier comando DDL en una base de datos que pertenezca a un grupo de disponibilidad requieren una conexión a la instancia de SQL Server. De forma predeterminada, un clúster de macrodatos no incluye un punto de conexión que permita una conexión a la instancia. Debe exponer este punto de conexión manualmente.

Para obtener instrucciones, consulte Conexión a las bases de datos de la réplica principal.

Actualizar el valor de configuración actual

Al especificar un nuevo valor para una opción, el conjunto de resultados muestra este valor en la columna config_value . Este valor inicialmente difiere del valor de la columna run_value , que muestra el valor de configuración actualmente en ejecución. Para actualizar el valor de configuración en ejecución en la columna run_value , el administrador del sistema debe ejecutar RECONFIGURE o RECONFIGURE WITH OVERRIDE.

RECONFIGURE y RECONFIGURE WITH OVERRIDE funcionan con todas las opciones de configuración. No obstante, la instrucción RECONFIGURE básica rechaza cualquier valor de opción que esté fuera de un intervalo razonable o que pueda ocasionar conflictos entre las opciones. Por ejemplo, RECONFIGURE genera un error si el valor del intervalo de recuperación es mayor que 60 minutos o si el valor de máscara de afinidad se superpone con el valor de máscara de E/S de afinidad. RECONFIGURE WITH OVERRIDE, por el contrario, admite cualquier valor de opción que contenga el tipo de datos correcto y obliga a realizar la reconfiguración con el valor especificado.

Precaución

Un valor de opción inapropiado puede afectar negativamente a la configuración de la instancia de servidor. Utilice RECONFIGURE WITH OVERRIDE con precaución.

La instrucción RECONFIGURE actualiza algunas opciones dinámicamente; para otras opciones es necesario detener y reiniciar el servidor. Por ejemplo, las opciones memoria mínima del servidor y memoria máxima del servidor se actualizan dinámicamente en la Motor de base de datos; por lo tanto, puede cambiarlas sin reiniciar el servidor. Por el contrario, volver a configurar el valor en ejecución de la opción factor de relleno requiere reiniciar el Motor de base de datos.

Después de ejecutar RECONFIGURE en una opción de configuración, puede ver si la opción se ha actualizado dinámicamente ejecutando sp_configure'option_name'. Los valores de las columnas run_value y config_value deben coincidir para una opción actualizada dinámicamente. También puede comprobar qué opciones son dinámicas examinando la columna is_dynamic de la vista de catálogo sys.configurations .

El cambio también se escribe en el registro de errores de SQL Server.

Nota:

Si un valor especificado es demasiado alto para una opción, la columna run_value refleja el hecho de que el Motor de base de datos tiene como valor predeterminado la memoria dinámica en lugar de usar una configuración que no es válida.

Para obtener más información, vea RECONFIGURE (Transact-SQL).

Opciones avanzadas

Algunas opciones de configuración, como la máscara de afinidad y el intervalo de recuperación, se designan como opciones avanzadas. De forma predeterminada, estas opciones no están disponibles para verlas o modificarlas. Para que estén disponibles, establezca la opción mostrar opciones avanzadas en 1.

Precaución

Cuando la opción Mostrar opciones avanzadas está establecida en 1, esta configuración se aplica a todos los usuarios. Se recomienda usar solo este estado temporalmente y volver a 0 cuando haya terminado con la tarea que requería ver las opciones avanzadas.

Para obtener más información sobre las opciones de configuración y sus valores, vea Opciones de configuración del servidor (SQL Server).

Permisos

De forma predeterminada, todos los usuarios tienen permisos de ejecución en sp_configure sin ningún parámetro o solo con el primero. Para ejecutar sp_configure con ambos parámetros para cambiar una opción de configuración o para ejecutar la instrucción RECONFIGURE, se le debe conceder el permiso de nivel de servidor ALTER SETTINGS. Los roles fijos de servidor sysadmin y serveradmin tienen el permiso ALTER SETTINGS de forma implícita.

Ejemplos

A Enumerar las opciones de configuración avanzadas

En este ejemplo se muestra cómo establecer y enumerar todas las opciones de configuración. Para ver las opciones de configuración avanzadas, primero hay que establecer en show advanced options el valor de 1. A continuación, si se ejecuta sp_configure sin parámetros, se mostrarán todas las opciones de configuración.

USE master;  
GO  
EXEC sp_configure 'show advanced options', '1';  

Este es el mensaje: "Se ha cambiado la opción de configuración 'show advanced options' de 0 a 1. Ejecute la instrucción RECONFIGURE para instalar".

Ejecute RECONFIGURE y muestre todas las opciones de configuración:

RECONFIGURE;  
EXEC sp_configure;  

B. Cambiar una opción de configuración

En el siguiente ejemplo se establece el recovery interval (intervalo de recuperación) del sistema en 3 minutos.

USE master;  
GO  
EXEC sp_configure 'recovery interval', '3';  
RECONFIGURE WITH OVERRIDE;  

Ejemplos: Sistema de la plataforma de análisis (PDW)

C. Lista de todas las opciones de configuración disponibles

En este ejemplo se muestra cómo enumerar todas las opciones de configuración.

EXEC sp_configure;  

El resultado devuelve el nombre de opción seguido por los valores mínimo y máximo de la opción. El config_value es el valor que Azure Synapse Analytics usará cuando se complete la reconfiguración. El valor run_value es el valor que se está usando actualmente. Los valores config_value y run_value son normalmente los mismos, a menos que el valor se esté modificando.

D. Lista de las opciones de configuración para un nombre de configuración

EXEC sp_configure @configname='hadoop connectivity';  

E. Establecer la conectividad de Hadoop

La configuración de la conectividad de Hadoop requiere algunos pasos más además de ejecutar sp_configure. Para obtener el procedimiento completo, consulte CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Consulte también

ALTER SERVER CONFIGURATION (Transact-SQL)
RECONFIGURE (Transact-SQL)
Instrucciones SET (Transact-SQL)
Opciones de configuración de servidor (SQL Server)
ALTER DATABASE (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)
sys.configurations (Transact-SQL)
ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
Soft-NUMA (SQL Server)