USE (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)Entrepôt dans 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

Syntaxe

USE { database_name }   
[;]  

Arguments

database_name
Nom de la base de données ou de l'instantané de la base de données vers lequel le contexte de l'utilisateur bascule. Les noms de la base de données et de l’instantané de la base de données doivent se conformer aux règles en vigueur pour les identificateurs.

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 USE ne permet pas de basculer entre les bases de données et le code d’erreur 40508 est retourné. Pour changer de bases de données, vous devez vous connecter directement à la base de données. L’instruction USE est marquée comme non applicable à SQL Database en haut de cette page, car même si vous pouvez inclure l’instruction USE dans un lot, elle n’a aucun effet.

Remarques

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'a été créé pour le nom d'ouverture de session SQL Server, celui-ci se connecte en tant que guest (invité). Si l'utilisateur de base de données ne bénéficie pas de l'autorisation CONNECT sur la base de données, l'instruction USE échoue. Si aucune base de données par défaut n'a été affectée au nom d'ouverture de session, sa base de données par défaut est définie sur master.

USE est exécutée à la fois au moment de l'exécution et de la compilation, et prend effet immédiatement. C'est pourquoi les instructions apparaissant dans un traitement après l'exécution de USE sont exécutées dans la base de données spécifiée.

Autorisations

Exige l'autorisation CONNECT sur la base de données cible.

Exemples

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

USE AdventureWorks2022;  
GO  

Voir aussi

CREATE LOGIN (Transact-SQL)
CRÉER UN UTILISATEUR (Transact-SQL)
Principaux (moteur de base de données)
CREATE DATABASE (SQL Server Transact-SQL)
DROP DATABASE (Transact-SQL)
EXECUTE (Transact-SQL)