Compartir a través de

sp_configure (Transact-SQL)

  • Artículo

Se aplica a: SQL Server Azure SQL Managed Instance No admitida. 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. Para configurar Soft-NUMA, consulte Soft-NUMA (SQL Server) .

Convenciones de sintaxis de Transact-SQL

Sintaxis

Sintaxis para SQL Server.

sp_configure
    [ [ @configname = ] 'configname' ]
    [ , [ @configvalue = ] configvalue ]
[ ; ]

Sintaxis para Analytics Platform System (PDW).

sp_configure
[ ; ]

Argumentos

[ @configname = ] 'configname'

Nombre de una opción de configuración. @configname es varchar(35), con un valor predeterminado de 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, consulte Opciones de configuración del servidor.

[ @configvalue = ] configvalue

Nueva configuración. @configvalue es int, con un valor predeterminado de NULL.

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

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto 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, también 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 Notas.

Nombre de la columna Tipo de datos Descripción
name nvarchar(35) Nombre de la opción de configuración.
minimum int Valor mínimo de la opción de configuración.
maximum 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, consulte Opciones de configuración del servidor y sys.configurations.
run_value int Valor actualmente en ejecución de la opción de configuración (valor en sys.configurations.value_in_use).

Para más información, consulte sys.configurations.

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.

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.

Actualización del valor de configuración en ejecución

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

Tanto como RECONFIGURE RECONFIGURE WITH OVERRIDE funcionan con cada opción de configuración. Sin embargo, la instrucción básica RECONFIGURE rechaza cualquier valor de opción que esté fuera de un intervalo razonable o que pueda provocar conflictos entre 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, en cambio, acepta cualquier valor de opción con el tipo de datos correcto y fuerza 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. Use RECONFIGURE WITH OVERRIDE con precaución.

La RECONFIGURE instrucción actualiza algunas opciones dinámicamente; otras opciones requieren una detención y reinicio del 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 cambiarlos 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 ejecutarse RECONFIGURE en una opción de configuración, puede ver si la opción se actualizó dinámicamente ejecutando sp_configure '<configname>'. Los valores de las run_value columnas y config_value deben coincidir para una opción actualizada dinámicamente. También puede comprobar qué opciones son dinámicas examinando la is_dynamic columna de la sys.configurations vista de catálogo.

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

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

Para obtener más información, consulte RECONFIGURE.

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 ver y cambiar. Para que estén disponibles, establezca la opción 1mostrar opciones avanzadas en .

Precaución

Cuando la opción mostrar opciones avanzadas está establecida 1en , esta configuración se aplica a todos los usuarios. Se recomienda usar solo este estado temporalmente y volver a 0 hacerlo 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, consulte Opciones de configuración del servidor.

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 RECONFIGURE instrucción , se le debe conceder el ALTER SETTINGS permiso de nivel de servidor. 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. Puede mostrar las opciones de configuración avanzadas estableciendo show advanced options primero en 1. Después de cambiar esta opción, puede mostrar todas las opciones de configuración ejecutando sp_configure sin parámetros.

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

Este es el conjunto de resultados.

Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.

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

RECONFIGURE;
EXEC sp_configure;

B. Cambiar una opción de configuración

En el ejemplo siguiente se establece la opción de configuración del sistema recovery interval 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. config_value es el valor que Azure Synapse Analytics usa cuando se completa la reconfiguración. run_value es el valor que se está usando actualmente. y config_value run_value suelen ser los mismos a menos que el valor esté en proceso de cambio.

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.

sp_configure [ @configname = ] 'hadoop connectivity',
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]

Contenido relacionado