Instructions SET (Transact-SQL)

S’applique à : point de terminaison d’analytique SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW) SQL Analytics dans Microsoft Fabric Warehouse dans Microsoft Fabric

Le langage de programmation Transact-SQL fournit plusieurs instructions SET qui modifient la façon dont la session en cours gère des informations spécifiques. Les instructions SET sont regroupées selon les catégories indiquées dans le tableau suivant :

Pour plus d'informations sur la définition de variables locales à l'aide de l'instruction SET, consultez SET @local_variable (Transact-SQL).

Category Instructions
Instructions de date et heure SET DATEFIRST

SET DATEFORMAT
Instructions de verrouillage SET DEADLOCK_PRIORITY

SET LOCK_TIMEOUT
Instructions diverses SET CONCAT_NULL_YIELDS_NULL

SET CURSOR_CLOSE_ON_COMMIT

SET FIPS_FLAGGER

SET IDENTITY_INSERT

SET LANGUAGE

SET OFFSETS

SET QUOTED_IDENTIFIER
Instructions d'exécution de requêtes SET ARITHABORT

SET ARITHIGNORE

SET FMTONLY
Remarque : cette fonctionnalité sera supprimée dans une prochaine version de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

SET NOCOUNT

SET NOEXEC

SET NUMERIC_ROUNDABORT

SET PARSEONLY

SET QUERY_GOVERNOR_COST_LIMIT

DÉFINIR LA MISE EN CACHE DU JEU DE RÉSULTATS (Préversion)
Remarque : cette fonctionnalité s’applique uniquement à Azure Synapse Analytics.

SET ROWCOUNT

SET TEXTSIZE
Instructions se rapportant aux paramètres ISO SET ANSI_DEFAULTS

SET ANSI_NULL_DFLT_OFF

SET ANSI_NULL_DFLT_ON

SET ANSI_NULLS

SET ANSI_PADDING

SET ANSI_WARNINGS
Instructions se rapportant aux statistiques SET FORCEPLAN

SET SHOWPLAN_ALL

SET SHOWPLAN_TEXT

SET SHOWPLAN_XML

SET STATISTICS IO

SET STATISTICS XML

SET STATISTICS PROFILE

SET STATISTICS TIME
Instructions se rapportant aux transactions SET IMPLICIT_TRANSACTIONS

SET REMOTE_PROC_TRANSACTIONS

SET TRANSACTION ISOLATION LEVEL

SET XACT_ABORT

Remarques sur l'utilisation des instructions SET

  • Toutes les instructions SET sont traitées pendant l’exécution, sauf ces instructions qui s’exécutent lors de l’analyse :

    • SET FIPS_FLAGGER
    • SET OFFSETS
    • SET PARSEONLY
    • et SET QUOTED_IDENTIFIER
  • Si une instruction SET s’exécute dans une procédure stockée ou un déclencheur, sa valeur est rétablie dès que la procédure stockée ou le déclencheur rend le contrôle. De même, si une instruction SET est spécifiée dans une chaîne SQL dynamique exécutée à l’aide de sp_executesql ou d’EXECUTE, sa valeur est rétablie une fois que le traitement spécifié dans la chaîne SQL dynamique rend le contrôle.

  • Les procédures stockées sont exécutées avec les valeurs SET spécifiées au moment de l'exécution, sauf dans le cas de SET ANSI_NULLS et SET QUOTED_IDENTIFIER. Les procédures stockées spécifiant SET ANSI_NULLS ou SET QUOTED_IDENTIFIER utilisent les valeurs spécifiées au moment de la création de ces procédures stockées. Toute option SET utilisée dans une procédure stockée est ignorée.

  • Le paramètre user options de la procédure sp_configure tient compte des paramètres définis à l’échelle du serveur et agit sur plusieurs bases de données à la fois. Son fonctionnement est identique à celui d'une instruction SET explicite, mais il prend effet lors de la connexion.

  • Les paramètres de base de données (définis à l'aide de ALTER DATABASE) sont valides uniquement au niveau de la base de données et prennent effet seulement s'ils sont explicitement définis. Les paramètres de base de données ont priorité sur les valeurs des options de l’instance définies à l’aide de sp_configure.

  • Si une instruction SET utilise ON et OFF, vous pouvez spécifier l’une ou l’autre valeur pour plusieurs options SET.

    Notes

    Ceci ne s’applique pas aux statistiques liées aux options SET.

    Par exemple, SET QUOTED_IDENTIFIER, ANSI_NULLS ON affecte la valeur ON à QUOTED_IDENTIFIER et à ANSI_NULLS.

  • Les paramètres de l’instruction SET sont prioritaires sur les paramètres équivalents des options de base de données, qui sont définis à l’aide d’ALTER DATABASE. Ainsi, la valeur spécifiée dans une instruction SET ANSI_NULLS se substitue à celle du paramètre de base de données pour ANSI_NULLs. De plus, certains paramètres de connexion sont activés (ON) automatiquement quand un utilisateur se connecte à une base de données, sur la base de valeurs activées au préalable à l’aide de la procédure sp_configure user options ou sur la base de valeurs applicables à toutes les connexions ODBC et OLE DB.

  • Les instructions ALTER, CREATE et DROP DATABASE ne tiennent pas compte du paramètre SET LOCK_TIMEOUT.

  • Lorsqu’une instruction SET globale ou contextuelle définit plusieurs paramètres, son exécution rétablit les anciens paramètres de toutes ces options affectées par l’instruction SET contextuelle. Si une option SET affectée par une instruction SET contextuelle est explicitement définie après l’émission de l’instruction SET contextuelle, ses paramètres remplacent les paramètres correspondants de l’instruction contextuelle. SET ANSI_DEFAULTS est un exemple d’instruction SET contextuelle.

  • Lorsque vous utilisez des traitements d’instructions, le contexte de la base de données est déterminé par le traitement défini à l’aide de l’instruction USE. Les requêtes non planifiées et toutes les instructions qui s’exécutent hors d’une procédure stockée et sont regroupées dans des traitements héritent des paramètres d’option de la base de données et de la connexion établie à l’aide de l’instruction USE.

  • Les requêtes MARS (Multiple Active Result Set) partagent un état global contenant les paramètres des options SET de la session la plus récente. Chaque requête qui s’exécute peut modifier les options de l’instruction SET. Ces modifications sont limitées au contexte de la requête dans lequel elles sont définies, et n’ont pas d’incidence sur les autres requêtes MARS simultanées. Une fois l'exécution de la requête terminée, les nouvelles options SET sont toutefois copiées dans l'état de session global. Ainsi, les nouvelles requêtes qui s'exécutent dans la même session après ces modifications utilisent les nouvelles valeurs des options SET.

  • Lorsqu’une procédure stockée s’exécute dans un traitement ou une autre procédure stockée, elle est exécutée avec les valeurs d’option configurées dans la base de données contenant la procédure stockée. Par exemple, si la procédure stockée db1.dbo.sp1 appelle la procédure stockée db2.dbo.sp2, la procédure sp1 est exécutée sous le niveau de compatibilité défini dans la base de données db1, tandis que la procédure stockée sp2 est exécutée sous le niveau de compatibilité défini dans la base de données db2.

  • Lorsqu’une instruction Transact-SQL concerne des objets situés dans plusieurs bases de données, le contexte de la base de données active et celui de la connexion actuelle s’appliquent à cette instruction. Dans ce cas, si l'instruction Transact-SQL fait partie d'un traitement, le contexte de la connexion actuelle est la base de données définie par l'instruction USE ; si l'instruction Transact-SQL est dans une procédure stockée, le contexte de la connexion est la base de données contenant cette procédure stockée.

  • Lorsque vous créez et modifiez des index sur des colonnes calculées ou des vues indexées, vous devez définir ces options SET sur ON : ARITHABORT, CONCAT_NULL_YIELDS_NULL, QUOTED_IDENTIFIER, ANSI_NULLS, ANSI_PADDING et ANSI_WARNINGS. Réglez l’option NUMERIC_ROUNDABORT sur OFF.

    Si l’une de ces options n’a pas la valeur requise, les actions INSERT, UPDATE, DELETE, DBCC CHECKDB et DBCC CHECKTABLE sur les vues indexées ou les tables comportant des index sur des colonnes calculées échouent. SQL Server déclenche une erreur et affiche la liste des options dont les valeurs sont incorrectes. Par ailleurs, SQL Server traite les instructions SELECT sur ces tables ou ces vues indexées comme si les index sur les colonnes calculées ou sur les vues n’existaient pas.

  • Lorsque RESULT_SET_CACHING est ACTIF, il active la fonctionnalité de mise en cache de résultats pour la session cliente actuelle. Result_set_caching ne peut pas être activée pour une session si elle est désactivée au niveau de la base de données. Lorsque RESULT_SET_CACHING est INACTIF, la fonctionnalité de mise en cache de résultats est désactivée pour la session cliente actuelle. La modification de ce paramètre nécessite l'appartenance au rôle public. S’applique à : Azure Synapse Analytics Gen2