USE (Transact-SQL)
Altera o contexto de banco de dados para o banco de dados ou instantâneo de banco de dados especificado no SQL Server.
Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual). |
Convenções da sintaxe Transact-SQL
Sintaxe
USE { database }
Argumentos
database
É 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 de banco de dados devem estar de acordo com as regras para identificadores.Em Banco de dados SQL do Windows Azure, o parâmetro de banco de dados só pode se referir ao banco de dados atual. A instrução USE não alterna entre bancos de dados; o código de erro 40508 é retornado. Para alterar os bancos de dados, você deve conectar-se diretamente ao banco de dados.
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 guest. 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 master.
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 AdventureWorks2012.
USE AdventureWorks2012;
GO
Consulte também
Referência
CREATE DATABASE (SQL Server Transact-SQL)