sp_attach_single_file_db (Transact-SQL)

Actualizado: 5 de diciembre de 2005

Adjunta al servidor actual una base de datos que tiene un solo archivo de datos. sp_attach_single_file_db no se puede utilizar con varios archivos de datos.

Importante:

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Se recomienda utilizar CREATE DATABASE database_name FOR ATTACH en su lugar. Para obtener más información, vea CREATE DATABASE (Transact-SQL). No utilice este procedimiento en una base de datos replicada.

Nota de seguridad:

Se recomienda no adjuntar ni restaurar bases de datos de orígenes desconocidos o que no sean de confianza. Estas bases de datos pueden contener código dañino que podría ejecutar código Transact-SQL no deseado o provocar errores debido a la modificación del esquema o de la estructura de la base de datos física. Antes de utilizar una base de datos de un origen desconocido o que no sea de confianza, ejecute DBCC CHECKDB en la base de datos en un servidor que no sea de producción y examine el código de la base de datos, como procedimientos almacenados u otro código definido por el usuario.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_attach_single_file_db [ @dbname= ] 'dbname'
        , [ @physname= ] 'physical_name'

Argumentos

• [ @dbname= ] 'dbname'
  Es el nombre de la base de datos que se va adjuntar al servidor. El nombre debe ser único. dbname es de tipo sysname y su valor predeterminado es NULL.

• [ @physname= ] 'physical_name'
  Es el nombre físico, incluida la ruta de acceso, del archivo de base de datos. physical_name es de tipo nvarchar(260) y su valor predeterminado es NULL.

  [!NOTA] Este argumento se asigna al parámetro FILENAME de la instrucción CREATE DATABASE. Para obtener más información, vea CREATE DATABASE (Transact-SQL).

  En el SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005) de Microsoft, los archivos de texto que formen parte de la base de datos que se va a adjuntar se adjuntan con la base de datos. Si desea especificar una nueva ruta de acceso al catálogo de texto, puede especificar el archivo del catálogo proporcionando un nombre de directorio sin nombre de archivo. Para obtener más información, vea Adjuntar y separar catálogos de texto.

Conjuntos de resultados

Ninguno

Notas

Utilice sp_attach_single_file_db sólo en bases de datos que haya separado previamente del servidor con una operación sp_detach_db explícita o en bases de datos copiadas.

sp_attach_single_file_db funciona únicamente en bases de datos que tienen un solo archivo de registro. Cuando sp_attach_single_file_db adjunta la base de datos al servidor, crea un nuevo archivo de registro. Si la base de datos es de sólo lectura, el archivo de registro se crea en su ubicación anterior.

[!NOTA] Una instantánea de base de datos no se puede adjuntar ni separar.

No utilice este procedimiento en una base de datos replicada.

Permisos

Para obtener información sobre cómo se administran los permisos cuando se adjunta una base de datos, vea CREATE DATABASE (Transact-SQL).

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

En el ejemplo siguiente se separa AdventureWorks y, después, se adjunta un archivo de AdventureWorks al servidor actual.

USE master;
GO
EXEC sp_detach_db @dbname = 'AdventureWorks';
EXEC sp_attach_single_file_db @dbname = 'AdventureWorks', 
    @physname = N'C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data\AdventureWorks_Data.mdf';

Vea también

Referencia

sp_detach_db (Transact-SQL)
sp_helpfile (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Otros recursos

Separar y adjuntar bases de datos
Adjuntar y separar catálogos de texto
Proteger archivos de datos y de registro

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios