Compartilhar via


USE (Transact-SQL)

Aplica-se a: SQL Server Azure SQL Managed Instance Analytics Platform System (PDW) Warehouse no Microsoft Fabric

Altera o contexto de banco de dados para o banco de dados ou instantâneo de banco de dados especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

USE { database_name }   
[;]  

Argumentos

database_name
É o nome do banco de dados ou instantâneo de banco de dados para os quais o contexto de usuário é alternado. Os nomes do banco de dados e do instantâneo do banco de dados devem seguir as regras de identificadores.

Em Banco de Dados SQL do Azure, o parâmetro de banco de dados só pode se referir ao banco de dados atual. Se um banco de dados que não seja o banco de dados atual é fornecido, a instrução USE não alterna entre bancos de dados e o código de erro 40508 é retornado. Para alterar os bancos de dados, você deve conectar-se diretamente ao banco de dados. A instrução USE é marcada como não aplicável ao Banco de Dados SQL na parte superior desta página, porque, embora você possa ter a instrução USE em um lote, ela não executa nenhuma ação.

Comentários

Quando um logon do SQL Server se conecta ao SQL Server, ele é automaticamente conectado ao seu banco de dados padrão e adquire o contexto de segurança de um usuário de banco de dados. Se nenhum usuário de banco de dados foi criado para o logon do SQL Server, o logon se conectará como convidado. Se o usuário de banco de dados não tiver permissão CONNECT no banco de dados, a instrução USE falhará. Se nenhum banco de dados padrão foi atribuído ao logon, seu banco de dados padrão será definido como mestre.

USE é executado em tempo de compilação e de execução e entra em vigor imediatamente. Portanto, as instruções exibidas em um lote depois da instrução USE são executadas no banco de dados especificado.

Permissões

Requer a permissão de CONNECT no banco de dados de destino.

Exemplos

O exemplo a seguir altera o contexto de banco de dados para o banco de dados AdventureWorks2022.

USE AdventureWorks2022;  
GO  

Consulte Também

CREATE LOGIN (Transact-SQL)
CREATE USER (Transact-SQL)
Entidades (Mecanismo de Banco de Dados)
CREATE DATABASE (SQL Server Transact-SQL)
DROP DATABASE (Transact-SQL)
EXECUTE (Transact-SQL)