sp_attach_db (Transact-SQL)

Sintaxe

sp_attach_db [ @dbname= ] 'dbname'
        , [ @filename1= ] 'filename_n' [ ,...16 ] 

Argumentos

• [ @dbname= ] **'**dbnam '
  É o nome do banco de dados a ser anexado ao servidor. O nome deve ser exclusivo. dbname é sysname, com um padrão NULL.

• [ @filename1= ] 'filename_n'
  É o nome físico, inclusive caminho, de um arquivo de banco de dados. filename_n é nvarchar(260), com um padrão NULL. Podem ser especificados até 16 nomes de arquivo. Os nomes de parâmetros começam em @filename1 e são incrementados até @filename16. A lista de nomes de arquivo deve incluir, pelo menos, o arquivo primário. O arquivo primário contém as tabelas de sistema que apontam para outros arquivos no banco de dados. A lista também deve incluir quaisquer arquivos que tenham sido movidos depois que o banco de dados foi desanexado.

  Observação

  Este argumento mapeia para o parâmetro FILENAME da instrução CREATE DATABASE. Para obter mais informações, consulte CREATE DATABASE (Transact-SQL). Quando você anexa um banco de dados do SQL Server 2005 que contém arquivos de catálogo de texto completo a uma instância de servidor do SQL Server 2008 R2, os arquivos de catálogo são anexados de seus locais anteriores junto com os outros arquivos de banco de dados, como ocorre no SQL Server 2005. Para obter mais informações, consulte Atualização da pesquisa de texto completo.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

O procedimento armazenado de sp_attach_db só deve ser executado em bancos de dados que tenham sido previamente desanexados do servidor de banco de dados por meio de uma operação sp_detach_db explícita ou em bancos de dados copiados. Se precisar especificar mais de 16 arquivos, use CREATE DATABASE database_name FOR ATTACH ou CREATE DATABASE database_name FOR_ATTACH_REBUILD_LOG. Para obter mais informações, consulte CREATE DATABASE (Transact-SQL).

Considera-se que todo arquivo não especificado esteja em seu último local conhecido. Para usar um arquivo em um local diferente, você deve especificar o novo local.

Um banco de dados criado por uma versão mais recente do SQL Server não pode ser anexado em versões anteriores.

Observação
Um instantâneo do banco de dados não pode ser desanexado ou anexado.

Ao anexar um banco de dados replicado que tenha sido copiado, em vez de desanexado, considere o seguinte:

• Se você anexar o banco de dados à mesma instância e versão de servidor do banco de dados original, nenhuma etapa adicional será necessária.

• Se anexar o banco de dados à mesma instância de servidor, mas com uma versão atualizada, você deverá executar sp_vupgrade_replication para atualizar a replicação depois que a operação de anexação tiver sido concluída.

• Se anexar o banco de dados a uma instância de servidor diferente, independentemente da versão, você deverá executar sp_removedbreplication para remover a replicação depois de a operação de anexação ter sido concluída.

O banco de dados de origem deve estar pelo menos na versão 80 (SQL Server 2000) para que seja anexado ao SQL Server 2008 R2, SQL Server 2008. Bancos de dados do SQL Server 2000 ou do SQL Server 2005 com um nível de compatibilidade inferior a 80 serão definidos como compatibilidade 80 quando forem anexados.

Permissões

Para obter informações sobre como as permissões são tratadas quando um banco de dados é anexado, consulte CREATE DATABASE (Transact-SQL).

Exemplos

O exemplo a seguir anexa arquivos de AdventureWorks2008R2 ao servidor atual.

EXEC sp_attach_db @dbname = N'AdventureWorks2008R2', 
    @filename1 = N'C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data\AdventureWorks2008R2_Data.mdf', 
    @filename2 = N'C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data\AdventureWorks2008R2_log.ldf';

Consulte também

Referência

Conceitos