USE (Transact-SQL)

2025-07-16

Applies to:SQL Server Azure SQL Managed Instance Analytics Platform System (PDW)Warehouse in Microsoft Fabric

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

Syntax

USE { database_name }
[ ; ]

Arguments

database_name

Имя моментального снимка базы данных или базы данных, в которую переключится контекст пользователя. Database and database snapshot names must comply with the rules for identifiers.

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

Remarks

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

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

Permissions

Требуется CONNECT разрешение на целевую базу данных.

Examples

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

USE AdventureWorks2022;
GO

Поделиться через