Artigo
09/28/2010

sp_attach_db (Transact-SQL)

Anexa um banco de dados a um servidor.

Importante
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Recomendamos usar CREATE DATABASE database_name em vez de FOR ATTACH. Para obter mais informações, consulte CREATE DATABASE (Transact-SQL).

Observação
Para recompilar vários arquivos de log quando um ou deles estiverem em um novo local, use CREATE DATABASE database_name FOR ATTACH_REBUILD_LOG.

Observação sobre segurança
Recomendamos que você não anexe ou restaure bancos de dados de origens desconhecidas ou não confiáveis. Esses bancos de dados podem conter um código mal-intencionado que pode executar código Transact-SQL involuntário ou provocar erros modificando o esquema ou a estrutura física do banco de dados. Antes de usar um banco de dados de uma fonte desconhecida ou não confiável, execute DBCC CHECKDB no banco de dados, em um servidor que não seja de produção. Além disso, examine o código, como procedimentos armazenados ou outro código definido pelo usuário, no banco de dados.

Recomendamos que você não anexe ou restaure bancos de dados de origens desconhecidas ou não confiáveis. Esses bancos de dados podem conter um código mal-intencionado que pode executar código Transact-SQL involuntário ou provocar erros modificando o esquema ou a estrutura física do banco de dados. Antes de usar um banco de dados de uma fonte desconhecida ou não confiável, execute DBCC CHECKDB no banco de dados, em um servidor que não seja de produção. Além disso, examine o código, como procedimentos armazenados ou outro código definido pelo usuário, no banco de dados.

Ícone de vínculo de tópico Convenções de sintaxe 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 da deve ser exclusivo. dbname é sysname, com um padrão de 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 de NULL. Podem ser especificados até 16 nomes de arquivo. Os nomes de parâmetros começam em @ filename1 e incrementam-se 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, 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.

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, 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 de sp_detach_db explícita ou em bancos de dados copiados. Se tiver que 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 anexada 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 como 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ê deve 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 ser pelo menos da versão 80 (SQL Server 2000) para que seja anexado ao 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 manipuladas quando um banco de dados é anexado, consulte CREATE DATABASE (Transact-SQL).

Exemplos

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

EXEC sp_attach_db @dbname = N'AdventureWorks', 
    @filename1 = N'C:\Program Files\Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\Data\AdventureWorks_Data.mdf', 
    @filename2 = N'C:\Program Files\Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\Data\AdventureWorks_log.ldf';