UTILISER (Transact-SQL)

S’applique à :SQL Server Azure SQL Managed InstanceWarehousedans Microsoft Fabric

Remplace le contexte de la base de données par la base de données spécifiée ou par l'instantané de la base de données spécifié.

Conventions de la syntaxe Transact-SQL

Syntax

USE { database_name }
[ ; ]

Arguments

database_name

Nom de la base de données ou de l’instantané de base de données vers lequel le contexte utilisateur est basculé. Les noms de bases de données et d’instantanés de base de données doivent respecter les règles relatives aux identifiants.

Dans Azure SQL Database et SQL Database dans Microsoft Fabric, l'USEinstruction n'est pas disponible. À la place, connectez-vous directement à la base de données souhaitée. Dans Azure SQL Database, le paramètre database ne peut faire référence qu'à la base de données active. Si une base de données autre que la base de données active est fournie, l’instruction ne bascule pas entre les bases de données et le USE code d’erreur 40508 est retourné.

Remarks

Lorsqu'un nom d'ouverture de session SQL Server se connecte à SQL Server, il est automatiquement connecté à sa base de données par défaut et acquiert le contexte de sécurité d'un utilisateur de base de données. Si aucun utilisateur de base de données n’est créé pour la connexion SQL Server, la connexion se connecte en tant qu’invité. Si l’utilisateur de la base de données n’a pas d’autorisation CONNECT sur la base de données, l’instruction USE échoue. Si aucune base de données par défaut n’est affectée à la connexion, sa base de données par défaut est définie mastersur .

USE est exécuté à la fois au moment de la compilation et de l’exécution et prend effet immédiatement. Par conséquent, les instructions qui apparaissent dans un lot après l’exécution de l’instruction USE dans la base de données spécifiée.

Permissions

Nécessite CONNECT une autorisation sur la base de données cible.

Examples

L'exemple qui suit remplace le contexte de la base de données par la base de données AdventureWorks2025.

USE AdventureWorks2022;
GO