USE (Transact-SQL)
Область применения: хранилище платформы SQL Server
Управляемый экземпляр SQL Azure
Analytics Platform System (PDW)
в 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)