USE (Transact-SQL)

  • Статья

Область применения:SQL Server Управляемый экземпляр SQL Azure Analytics Platform System (PDW)Warehouse in Microsoft Fabric

Изменяет контекст базы данных на указанный моментальный снимок базы данных или базы данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

USE { database_name }   
[;]

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

database_name
Имя базы данных или моментального снимка базы данных, на который переключается контекст пользователя. Имена баз данных и моментальных снимков базы данных должны соответствовать правилам построения идентификаторов.

В База данных SQL Azure параметр базы данных может ссылаться только на текущую базу данных. Если указана база данных, отличная от текущей, инструкция USE не переключается между базами данных и возвращается код ошибки 40508. Для смены базы данных следует непосредственно подключиться к базе данных. В верхней части этой страницы инструкция USE помечена как неприменимая к базе данных SQL, поскольку даже если инструкция USEвходит в состав пакета, она не выполняет никаких действий.

Замечания

При подключении имени входа SQL Server к SQL Server имя входа автоматически подключается к базе данных по умолчанию и получает контекст безопасности пользователя базы данных. Если для входа в SQL Server не создан пользователь базы данных, имя входа подключается как гостевой. Если пользователь базы данных не имеет разрешения CONNECT на базу данных, инструкция USE завершится ошибкой. Если с именем входа не была связана никакая база данных по умолчанию, то для него базой данных по умолчанию будет установлена база данных master.

Инструкция USE выполняется как на стадии компиляции, так и на стадии выполнения и вступает в силу немедленно. Иными словами, инструкции, которые содержатся в пакете после инструкции USE, будут выполнены в контексте указанной базы данных.

Разрешения

Необходимо разрешение CONNECT на целевую базу данных.

Примеры

В следующем примере выполняется смена контекста на базу данных AdventureWorks2022.

USE AdventureWorks2022;  
GO

См. также

CREATE LOGIN (Transact-SQL)
СОЗДАНИЕ ПОЛЬЗОВАТЕЛЯ (Transact-SQL)
Субъекты (ядро СУБД)
CREATE DATABASE (SQL Server Transact-SQL)
DROP DATABASE (Transact-SQL)
EXECUTE (Transact-SQL)