Instrucciones SET (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

El lenguaje de programación Transact-SQL ofrece varias instrucciones SET que cambian el tratamiento de información específica por parte de la sesión actual. Las instrucciones SET se agrupan en las categorías que figuran en la siguiente tabla.

Para obtener información sobre cómo establecer variables locales con la instrucción SET, vea SET @local_variable (Transact-SQL).

Category Instrucciones
Instrucciones de fecha y hora SET DATEFIRST

SET DATEFORMAT
Instrucciones de bloqueo SET DEADLOCK_PRIORITY

SET LOCK_TIMEOUT
Otras instrucciones SET CONCAT_NULL_YIELDS_NULL

SET CURSOR_CLOSE_ON_COMMIT

SET FIPS_FLAGGER

SET IDENTITY_INSERT

SET LANGUAGE

SET OFFSETS

SET QUOTED_IDENTIFIER
Instrucciones de ejecución de consultas SET ARITHABORT

SET ARITHIGNORE

SET FMTONLY
Nota: Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

SET NOCOUNT

SET NOEXEC

SET NUMERIC_ROUNDABORT

SET PARSEONLY

SET QUERY_GOVERNOR_COST_LIMIT

SET RESULT SET CACHING (versión preliminar)
Nota: Esta característica solo se aplica a Azure Synapse Analytics.

SET ROWCOUNT

SET TEXTSIZE
Instrucciones de configuración de ISO SET ANSI_DEFAULTS

SET ANSI_NULL_DFLT_OFF

SET ANSI_NULL_DFLT_ON

SET ANSI_NULLS

SET ANSI_PADDING

SET ANSI_WARNINGS
Instrucciones de estadísticas SET FORCEPLAN

SET SHOWPLAN_ALL

SET SHOWPLAN_TEXT

SET SHOWPLAN_XML

SET STATISTICS IO

SET STATISTICS XML

SET STATISTICS PROFILE

SET STATISTICS TIME
Instrucciones de transacciones SET IMPLICIT_TRANSACTIONS

SET REMOTE_PROC_TRANSACTIONS

SET TRANSACTION ISOLATION LEVEL

SET XACT_ABORT

Consideraciones al utilizar las instrucciones SET

  • Todas las instrucciones SET se ejecutan en tiempo de ejecución, salvo estas instrucciones, que se ejecutan en tiempo de análisis:

    • SET FIPS_FLAGGER
    • SET OFFSETS
    • SET PARSEONLY
    • y SET QUOTED_IDENTIFIER
  • Si se ejecuta una instrucción SET en un procedimiento almacenado o desencadenador, el valor de la opción de SET se restaura cuando el procedimiento almacenado o desencadenador devuelve el control. Además, si especifica una instrucción SET en una cadena de SQL dinámico que se ejecuta mediante sp_executesql o EXECUTE, el valor de la opción de SET se restaura cuando el control vuelve del lote que especificó en la cadena de SQL dinámico.

  • Los procedimientos almacenados se ejecutan con las opciones de SET especificadas en tiempo de ejecución, excepto en el caso de SET ANSI_NULLS y SET QUOTED_IDENTIFIER. Los procedimientos almacenados que utilizan SET ANSI_NULLS o SET QUOTED_IDENTIFIER usan las opciones especificadas en el momento de crear el procedimiento almacenado. Si se usan dentro de un procedimiento almacenado, las opciones SET no tienen ningún efecto.

  • El parámetro user options de sp_configure permite aplicar opciones a todo el servidor y sirve para múltiples bases de datos. Además, esta opción se comporta como una instrucción SET explícita, pero con la diferencia de que tiene lugar en el momento de iniciar la sesión.

  • Las opciones de base de datos establecidas con ALTER DATABASE solo son válidas en el nivel de base de datos y solo tienen efecto cuando se establecen explícitamente. Las opciones de base de datos anulan las opciones de instancia que se establecen mediante sp_configure.

  • Si una instrucción SET usa ON y OFF, puede especificar cualquiera para varias opciones de SET.

    Nota

    Esto no se aplica a las opciones de SET relacionadas con estadísticas.

    Por ejemplo, SET QUOTED_IDENTIFIER, ANSI_NULLS ON establece QUOTED_IDENTIFIER y ANSI_NULLS en ON.

  • Las opciones de las instrucciones SET anulan las opciones de base de datos idénticas que se establecen mediante ALTER DATABASE. Por ejemplo, el valor especificado en una instrucción SET ANSI_NULLS anulará la opción de la base de datos de ANSI_NULLS. Además, en algunas opciones de conexión se establece ON automáticamente cuando un usuario se conecta a una base de datos con los valores efectivos de la vez anterior que se utilizó la opción de sp_configure user options o los valores que se aplican a todas las conexiones ODBC y OLE/DB.

  • Las instrucciones ALTER, CREATE y DROP DATABASE no respetan la opción de SET LOCK_TIMEOUT.

  • Cuando una instrucción SET global o abreviada establece varias opciones, al ejecutar la instrucción SET abreviada se restablecen los valores anteriores de todas las opciones a las que afecta. Si una opción de SET que se ve afectada por una instrucción SET abreviada se establece después de ejecutar la instrucción SET abreviada, la instrucción SET individual tiene precedencia sobre las opciones comparables de la instrucción abreviada. Un ejemplo de una instrucción SET abreviada sería SET ANSI_DEFAULTS.

  • Al utilizar lotes, el lote establecido mediante la instrucción USE determina el contexto de la base de datos. Las consultas no planeadas y todas las demás instrucciones que se ejecuten fuera del procedimiento almacenado y que se encuentren en lotes heredan las opciones de base de datos y conexión establecidas mediante la instrucción USE.

  • Las solicitudes MARS (conjuntos de resultados activos múltiples) comparten un estado global que contiene los valores de SET de la sesión más reciente. Al ejecutar una solicitud, se pueden modificar las opciones de SET. Los cambios son específicos al contexto de solicitud en el que se encuentran, y no afectan a otras solicitudes MARS simultáneas. No obstante, una vez ejecutada la solicitud, las nuevas opciones de SET se copian en el estado de sesión global. Las nuevas solicitudes que se ejecuten en la misma sesión después de este cambio utilizarán estas nuevas opciones de SET.

  • Cuando se ejecuta un procedimiento almacenado desde un lote o desde otro procedimiento almacenado, la ejecución se realiza con las opciones configuradas en la base de datos que tiene el procedimiento almacenado. Por ejemplo, cuando el procedimiento almacenado db1.dbo.sp1 llama al procedimiento almacenado db2.dbo.sp2, el procedimiento almacenado sp1 se ejecuta con la opción de nivel de compatibilidad actual de la base de datos db1, y el procedimiento almacenado sp2 se ejecuta con la opción de nivel de compatibilidad actual de la base de datos db2.

  • Cuando una instrucción Transact-SQL está relacionada con objetos que se encuentran en varias bases de datos, el contexto de la base de datos actual y el contexto de la conexión actual se aplican a dicha instrucción. En este caso, si la instrucción Transact-SQL está en un lote, el contexto de conexión actual es la base de datos definida mediante la instrucción USE; si la instrucción Transact-SQL está en un procedimiento almacenado, el contexto de conexión es la base de datos que contiene el procedimiento almacenado.

  • Al crear y manipular índices en columnas calculadas o vistas indexadas, debe establecer estas opciones de SET en ON: ARITHABORT, CONCAT_NULL_YIELDS_NULL, QUOTED_IDENTIFIER, ANSI_NULLS, ANSI_PADDING y ANSI_WARNINGS. Establezca la opción de NUMERIC_ROUNDABORT en OFF.

    Si no establece ninguna de estas opciones en los valores exigidos, se producirá un error en las acciones INSERT, UPDATE, DELETE, DBCC CHECKDB y DBCC CHECKTABLE en las tablas o vistas indexadas con índices en las columnas calculadas. SQL Server generará un error indicando las opciones que no se han establecido correctamente. Además, SQL Server procesará las instrucciones SELECT en estas tablas o vistas indexadas como si no existieran los índices en las columnas calculadas ni en las vistas.

  • Cuando SET RESULT_SET_CACHING es ON, permite la característica de almacenamiento en caché de los resultados para la sesión actual del cliente. Result_set_caching no se puede activar para una sesión si estaba desactivado en el nivel de base de datos. Cuando SET RESULT_SET_CACHING es OFF, la característica de almacenamiento en caché del conjunto de resultados para la sesión actual del cliente. Para cambiar esta configuración, se requiere la pertenencia al rol público. Se aplica a: Azure Synapse Analytics Gen2