sp_configure (Transact-SQL)sp_configure (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database (solo Instancia administrada) noAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse yesParallel Data Warehouse

Muestra o cambia las opciones de configuración global del servidor actual.Displays or changes global configuration settings for the current server.

Nota

Para las opciones de configuración de nivel de base de datos, vea ALTER DATABASE scoped (Configuration Transact-SQL).For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Para configurar Soft-NUMA, consulte SQL Server ()de Numa de software.To configure Soft-NUMA, see Soft-NUMA (SQL Server).

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

-- 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  
[;]  

ArgumentosArguments

[ @configname = ] 'option_name'Es el nombre de una opción de configuración.[ @configname = ] 'option_name' Is the name of a configuration option. option_name es varchar(35) y su valor predeterminado es NULL.option_name is varchar(35), with a default of NULL. Motor de base de datos de SQL ServerSQL Server Database Engine reconoce cualquier cadena única que forme parte del nombre de configuración.The Motor de base de datos de SQL ServerSQL Server Database Engine recognizes any unique string that is part of the configuration name. Si no se especifica, se devuelve la lista completa de opciones.If not specified, the complete list of options is returned.

Para obtener información sobre las opciones de configuración disponibles y su configuración, consulte opciones (de)configuración del servidor SQL Server.For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value'Es el nuevo valor de configuración.[ @configvalue = ] 'value' Is the new configuration setting. value es de tipo inty su valor predeterminado es NULL.value is int, with a default of NULL. El valor máximo depende de la opción individual.The maximum value depends on the individual option.

Para ver el valor máximo de cada opción, vea la columna Maximum de la vista de catálogo Sys. Configurations.To see the maximum value for each option, see the maximum column of the sys.configurations catalog view.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Cuando se ejecuta sin parámetros, sp_configure devuelve un conjunto de resultados con cinco columnas y ordena las opciones alfabéticamente en orden ascendente, tal como se muestra en la tabla siguiente.When executed with no parameters, sp_configure returns a result set with five columns and orders the options alphabetically in ascending order, as shown in the following table.

Los valores de config_value y run_value no son equivalentes automáticamente.The values for config_value and run_value are not automatically equivalent. Después de actualizar una opción de 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.After updating a configuration setting by using sp_configure, the system administrator must update the running configuration value by using either RECONFIGURE or RECONFIGURE WITH OVERRIDE. Para obtener más información, vea la sección Comentarios.For more information, see the Remarks section.

Nombre de columnaColumn name Tipo de datosData type DescripciónDescription
namename nvarchar(35)nvarchar(35) Nombre de la opción de configuración.Name of the configuration option.
Mínimominimum intint Valor mínimo de la opción de configuración.Minimum value of the configuration option.
Máximomaximum intint Valor máximo de la opción de configuración.Maximum value of the configuration option.
config_valueconfig_value intint Valor en el que se estableció la opción de configuración mediante sp_configure (valor en sys. Configurations . Value).Value to which the configuration option was set using sp_configure (value in sys.configurations.value). Para obtener más información sobre estas opciones, vea opciones (de configuración) del servidor SQL Server y sys. Configurations de (Transact-SQL).For more information about these options, see Server Configuration Options (SQL Server) and sys.configurations (Transact-SQL).
run_valuerun_value intint Valor que se está ejecutando actualmente de la opción de configuración (valor en sys. Configurations . value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

Para obtener más información, vea Sys. (Configurations)de Transact-SQL.For more information, see sys.configurations (Transact-SQL).

ComentariosRemarks

Utilice sp_configure para mostrar o cambiar la configuración de nivel de servidor.Use sp_configure to display or change server-level settings. Para cambiar la configuración de la base de datos, utilice ALTER DATABASE.To change database-level settings, use ALTER DATABASE. Para cambiar la configuración que afecta solo a la sesión de usuario actual, utilice la instrucción SET.To change settings that affect only the current user session, use the SET statement.

Actualizar el valor de configuración actualUpdating the Running Configuration Value

Cuando se especifica un nuevo valor para una opción, el conjunto de resultados muestra este valor en la columna config_value .When you specify a new value for an option, the result set shows this value in the config_value column. Inicialmente, este valor difiere del valor de la columna run_value , que muestra el valor de configuración que se está ejecutando actualmente.This value initially differs from the value in the run_value column, which shows the currently running configuration value. 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.To update the running configuration value in the run_value column, the system administrator must run either RECONFIGURE or RECONFIGURE WITH OVERRIDE.

RECONFIGURE y RECONFIGURE WITH OVERRIDE funcionan con todas las opciones de configuración.Both RECONFIGURE and RECONFIGURE WITH OVERRIDE work with every configuration option. 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.However, the basic RECONFIGURE statement rejects any option value that is outside a reasonable range or that may cause conflicts among options. Por ejemplo, reconfigure genera un error si el valor del intervalo de recuperación es superior a 60 minutos o si el valor de la máscara de afinidad se superpone con el valor de máscara de afinidad de e/s .For example, RECONFIGURE generates an error if the recovery interval value is larger than 60 minutes or if the affinity mask value overlaps with the affinity I/O mask value. 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.RECONFIGURE WITH OVERRIDE, in contrast, accepts any option value with the correct data type and forces reconfiguration with the specified value.

Precaución

Un valor de opción inapropiado puede afectar negativamente a la configuración de la instancia de servidor.An inappropriate option value can adversely affect the configuration of the server instance. Utilice RECONFIGURE WITH OVERRIDE con precaución.Use RECONFIGURE WITH OVERRIDE cautiously.

La instrucción RECONFIGURE actualiza algunas opciones dinámicamente; para otras opciones es necesario detener y reiniciar el servidor.The RECONFIGURE statement updates some options dynamically; other options require a server stop and restart. Por ejemplo, las opciones de memoria de servidor min Server Memory y Max Server Memory se actualizan dinámicamente en el Motor de base de datosDatabase Engine; por lo tanto, puede cambiarlas sin necesidad de reiniciar el servidor.For example, the min server memory and max server memory server memory options are updated dynamically in the Motor de base de datosDatabase Engine; therefore, you can change them without restarting the server. Por el contrario, para volver a configurar el valor de ejecución de la opción de factor de Motor de base de datosDatabase Enginerelleno, es necesario reiniciar el.By contrast, reconfiguring the running value of the fill factor option requires restarting the Motor de base de datosDatabase Engine.

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 'nombredeopción' .After running RECONFIGURE on a configuration option, you can see whether the option has been updated dynamically by executing sp_configure'option_name'. Los valores de las columnas run_value y config_value deben coincidir para una opción actualizada dinámicamente.The values in the run_value and config_value columns should match for a dynamically updated option. También puede comprobar qué opciones son dinámicas examinando la columna is_dynamic de la vista de catálogo Sys. Configurations.You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

El cambio también se escribe en el registro de errores de SQL Server.The change is also written to the SQL Server error log.

Nota

Si un valor especificado es demasiado alto para una opción, la columna run_value refleja el Motor de base de datosDatabase Engine hecho de que tiene como valor predeterminado memoria dinámica en lugar de usar una configuración que no es válida.If a specified value is too high for an option, the run_value column reflects the fact that the Motor de base de datosDatabase Engine has defaulted to dynamic memory rather than use a setting that is not valid.

Para obtener más información, vea reconfigure (Transact)-SQL.For more information, see RECONFIGURE (Transact-SQL).

Opciones avanzadasAdvanced Options

Algunas opciones de configuración, como affinity mask y Recovery Interval, se designan como opciones avanzadas.Some configuration options, such as affinity mask and recovery interval, are designated as advanced options. De forma predeterminada, estas opciones no están disponibles para verlas o modificarlas.By default, these options are not available for viewing and changing. Para que estén disponibles, establezca la opción de configuración ShowAdvancedOptions en 1.To make them available, set the ShowAdvancedOptions configuration option to 1.

Para obtener más información sobre las opciones de configuración y sus valores, consulte opciones (de)configuración del servidor SQL Server.For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

PermisosPermissions

De forma predeterminada, todos los usuarios tienen permisos de ejecución en sp_configure sin ningún parámetro o solo con el primero.Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. Para ejecutar sp_configure con ambos parámetros para cambiar una opción de configuración o ejecutar la instrucción RECONFIGURE, debe tener el permiso ALTER Settings de nivel de servidor.To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, you must be granted the ALTER SETTINGS server-level permission. Los roles fijos de servidor sysadmin y serveradmin tienen el permiso ALTER SETTINGS de forma implícita.The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

EjemplosExamples

A.A. Enumerar las opciones de configuración avanzadasListing the advanced configuration options

En este ejemplo se muestra cómo establecer y enumerar todas las opciones de configuración.The following example shows how to set and list all configuration options. Para ver las opciones de configuración avanzadas, primero hay que establecer en show advanced option el valor de 1.Advanced configuration options are displayed by first setting show advanced option to 1. A continuación, si se ejecuta sp_configure sin parámetros, se mostrarán todas las opciones de configuración.After this option has been changed, executing sp_configure with no parameters displays all configuration options.

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

Este es el mensaje: "Opción de configuración" Mostrar opciones avanzadas "cambió de 0 a 1.Here is the message: "Configuration option 'show advanced options' changed from 0 to 1. Ejecute la instrucción RECONFIGURE para instalar".Run the RECONFIGURE statement to install."

Ejecute RECONFIGURE y muestre todas las opciones de configuración:Run RECONFIGURE and show all configuration options:

RECONFIGURE;  
EXEC sp_configure;  

b.B. Cambiar una opción de configuraciónChanging a configuration option

En el siguiente ejemplo se establece el recovery interval (intervalo de recuperación) del sistema en 3 minutos.The following example sets the system recovery interval to 3 minutes.

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

Ejemplos: Almacenamiento de datos paralelosParallel Data WarehouseExamples: Almacenamiento de datos paralelosParallel Data Warehouse

C.C. Lista de todas las opciones de configuración disponiblesList all available configuration settings

En este ejemplo se muestra cómo enumerar todas las opciones de configuración.The following example shows how to list all configuration options.

EXEC sp_configure;  

El resultado devuelve el nombre de opción seguido por los valores mínimo y máximo de la opción.The result returns the option name followed by the minimum and maximum values for the option. Config_value es el valor que Almacenamiento de datos SQLSQL Data Warehouse se usará cuando se complete la reconfiguración.The config_value is the value that Almacenamiento de datos SQLSQL Data Warehouse will use when reconfiguration is complete. El valor run_value es el valor que se está usando actualmente.The run_value is the value that is currently being used. Los valores config_value y run_value son normalmente los mismos, a menos que el valor se esté modificando.The config_value and run_value are usually the same unless the value is in the process of being changed.

D.D. Lista de las opciones de configuración para un nombre de configuraciónList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

E.E. Establecer la conectividad de HadoopSet Hadoop connectivity

La configuración de la conectividad de Hadoop requiere algunos pasos más además de ejecutar sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Para obtener el procedimiento completo, vea Create external Data (Source Transact-)SQL.For the full procedure, see CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Vea tambiénSee Also

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