USE (Transact-SQL)

Artikel
05/23/2023

Gilt für:SQL Server Azure SQL Managed Instance Analytics Platform System (PDW)Warehouse in Microsoft Fabric

Ändert den Datenbankkontext in die angegebene Datenbank oder die angegebene Datenbankmomentaufnahme.

Syntax

USE { database_name }   
[;]

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

database_name
Der Name der Datenbank oder der Datenbankmomentaufnahme, in die der Benutzerkontext geändert wird. Datenbanknamen und Namen von Datenbankmomentaufnahmen müssen den Regeln für Bezeichner entsprechen.

In Azure SQL-Datenbank kann der Datenbankparameter nur auf die aktuelle Datenbank verweisen. Wenn eine andere Datenbank als die aktuelle angegeben ist, wechselt die USE-Anweisung nicht zwischen den Datenbanken, und der Fehlercode 40508 wird zurückgegeben. Um die Datenbank zu wechseln, müssen Sie eine direkte Verbindung herstellen. Die USE-Anweisung ist am Anfang dieser Seite als nicht zutreffend für SQL-Datenbank markiert, da nichts passiert, selbst wenn Sie die USE-Anweisung in einem Batch verwenden.

Hinweise

Wenn von einer SQL Server-Anmeldung eine Verbindung mit SQL Server hergestellt wird, wird die Anmeldung automatisch mit ihrer Standarddatenbank verbunden und bekommt den Sicherheitskontext eines Datenbankbenutzers zugewiesen. Falls kein Datenbankbenutzer für die SQL Server-Anmeldung erstellt wurde, wird die Verbindung als guest hergestellt. Verfügt der Datenbankbenutzer nicht über die CONNECT-Berechtigung für die Datenbank, meldet die USE-Anweisung einen Fehler. Falls der Anmeldung keine Standarddatenbank zugewiesen wurde, wird ihre Standarddatenbank auf master festgelegt.

USE wird zur Kompilierungszeit und zur Ausführungszeit ausgeführt und ist sofort wirksam. Deshalb werden Anweisungen, die in einem Batch nach der USE-Anweisung auftreten, in der angegebenen Datenbank ausgeführt.

Berechtigungen

Erfordert die CONNECT-Berechtigung für die Zieldatenbank.

Beispiele

Im folgenden Beispiel wird der Datenbankkontext in die AdventureWorks2022-Datenbank geändert.

USE AdventureWorks2022;  
GO

Weitere Informationen

CREATE LOGIN (Transact-SQL)
CREATE USER (Transact-SQL)
Prinzipale (Datenbank-Engine)
CREATE DATABASE (SQL Server Transact-SQL)
DROP DATABASE (Transact-SQL)
EXECUTE (Transact-SQL)