sp_detach_db (Transact-SQL)

Sintaxe

sp_detach_db [ @dbname= ] 'database_name' 
    [ , [ @skipchecks= ] 'skipchecks' ] 
    [ , [ @keepfulltextindexfile = ] 'KeepFulltextIndexFile' ] 

Argumentos

• [ @dbname = ] 'database_name'
  É o nome do banco de dados a ser desanexado. database_name é um valor sysname com um valor padrão de NULL.

• [ @skipchecks = ] 'skipchecks'
  Especifica se é necessário ignorar ou executar UPDATE STATISTIC. skipchecks é um valor nvarchar(10) com um valor padrão de NULL. Para ignorar UPDATE STATISTICS, especifique true. Para executar explicitamente UPDATE STATISTICS, especifique false.

  Por padrão, UPDATE STATISTICS é executado para atualizar as informações sobre os dados nas tabelas e os índices no Mecanismo de Banco de Dados do SQL Server 2005 e nas versões posteriores. A execução de UPDATE STATISTICS é útil para bancos de dados que serão movidos para mídias somente leitura.

• [ @keepfulltextindexfile= ] 'KeepFulltextIndexFile'
  Especifica se o arquivo de índice de texto completo associado ao banco de dados que está sendo desanexado não será descartado durante a operação de desanexação do banco de dados. KeepFulltextIndexFile é um valor nvarchar(10) com um padrão de true. Se KeepFulltextIndexFile for false, todos os arquivos de índices de texto completo associados ao banco de dados e aos metadados de índice de texto completo serão descartados, a menos que o banco de dados seja somente leitura. Se NULL ou true, os metadados relativos a texto completo serão mantidos.

  Importante
  O parâmetro @keepfulltextindexfile será removido em uma futura versão do SQL Server. Não utilize esse parâmetro em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

Quando um banco de dados é desanexado, todos os metadados são descartados. Se o banco de dados era o banco de dados padrão de quaisquer contas de logon, o mestre se torna o banco de dados padrão delas.

Observação
Para obter informações sobre como exibir o banco de dados padrão de todas as contas de logon, consulte sp_helplogins (Transact-SQL). Se você tiver as permissões exigidas, poderá usar ALTER LOGIN para atribuir um novo banco de dados padrão para um logon.

Restrições

Obtendo acesso exclusivo

A desanexação de um banco de dados exige acesso exclusivo ao banco de dados. Se o banco de dados a ser dexanexado estiver em uso, antes que ele possa ser desanexado, defina o banco de dados como modo SINGLE_USER para obter acesso exclusivo.

Por exemplo, a instrução ALTER DATABASE a seguir obtém acesso exclusivo para o banco de dados AdventureWorks após todos os usuários atuais se desconectarem do banco de dados.

USE master;
ALTER DATABASE AdventureWorks
SET SINGLE_USER;
GO

Observação
Para forçar os usuários atuais a saírem imediatamente do banco de dados ou após um número específico de segundos, você também pode usar a opção ROLLBACK: ALTER DATABASE database_name SET SINGLE_USER WITH ROLLBACK rollback_option. Para obter mais informações, consulte ALTER DATABASE (Transact-SQL).

Reanexando um banco de dados

Permissões

Requer associação à função de banco de dados fixa db_owner.

Exemplos

O exemplo a seguir desanexa o banco de dados AdventureWorks com skipchecks definido como verdadeiro.

EXEC sp_detach_db 'AdventureWorks', 'true';

O exemplo a seguir desanexa o banco de dados AdventureWorks e mantém os arquivos de índice de texto completo e os metadados de índice de texto completo. Esse comando executa UPDATE STATISTICS, que é o comportamento padrão.

exec sp_detach_db @dbname='AdventureWorks'
    , @keepfulltextindexfile='true';

Consulte também

Tarefas

Referência

Conceitos