Partilhar via


USAR (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed InstanceSistema de Plataforma de Análise (PDW)Armazém no Microsoft Fabric

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

Transact-SQL convenções de sintaxe

Syntax

USE { database_name }
[ ; ]

Arguments

database_name

O nome do banco de dados ou instantâneo do banco de dados para o qual o contexto do usuário é alternado. Os nomes das bases de dados e dos instantâneos devem cumprir as regras para identificadores.

No Banco de Dados SQL do Azure, o parâmetro database só pode se referir ao banco de dados atual. Se um banco de dados diferente do banco de dados atual for fornecido, a instrução não alternará entre bancos de dados e o USE código de erro 40508 será retornado. Para alterar bancos de dados, você deve se conectar 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, porque, embora você possa ter a USE instrução em lote, ela não faz nada.

Remarks

Quando um logon do SQL Server se conecta ao SQL Server, o logon é automaticamente conectado ao seu banco de dados padrão e adquire o contexto de segurança de um usuário do banco de dados. Se nenhum usuário de banco de dados for criado para o logon do SQL Server, o logon será conectado como convidado. Se o usuário do banco de dados não tiver a 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 execução e entra em vigor imediatamente. Portanto, as instruções que aparecem em um lote após a USE instrução são executadas no banco de dados especificado.

Permissions

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

Examples

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

USE AdventureWorks2022;
GO