Compartilhar via


USE (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed InstanceSistema de Plataforma de Análise (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

Syntax

USE { database_name }
[ ; ]

Arguments

database_name

O nome do banco de dados ou instantâneo de banco de dados para o qual o contexto do usuário é alternado. Nomes de bancos de dados e instantâneos de banco de dados devem estar em conformidade com as regras para 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 diferente do banco de dados atual for fornecido, a USE instrução não alterna entre bancos de dados e o código de erro 40508 será retornado. Para alterar os bancos de dados, você deve conectar-se diretamente ao banco de dados. A USE instrução é marcada como não aplicável ao Banco de Dados SQL do Azure na parte superior desta página, pois mesmo que você possa ter a USE instrução em um lote, ela não faz nada.

Remarks

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 for criado para o logon do SQL Server, o logon se conectará como convidado. Se o usuário do banco de dados não tiver permissão CONNECT no banco de dados, a USE instrução falhará. Se nenhum banco de dados padrão for atribuído ao logon, seu banco de dados padrão será definido como master.

USE é executado em tempo de compilação e de execução e entra em vigor imediatamente. Portanto, instruções que aparecem em um lote após a USE instrução são executadas no banco de dados especificado.

Permissions

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

Examples

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

USE AdventureWorks2022;
GO