sp_copysubscription (Transact-SQL)

Importante

La característica de suscripciones adjuntables ha quedado desusada y se retirará en versiones posteriores. Esta característica no se debe utilizar en nuevos trabajos de desarrollo. En las publicaciones de combinación en las que se han creado particiones mediante filtros con parámetros, se recomienda utilizar las nuevas características de las instantáneas con particiones, que simplifican la inicialización de un gran número de suscripciones. Para obtener más información, vea Instantáneas para publicaciones de combinación con filtros con parámetros. En las publicaciones que no están divididas en particiones, puede inicializar una suscripción con una copia de seguridad. Para obtener más información, vea Inicializar una suscripción transaccional sin una instantánea.

Copia una base de datos de suscripciones que tiene suscripciones de extracción, pero no de inserción. Solo se pueden copiar bases de datos de un único archivo. Este procedimiento almacenado se ejecuta en el suscriptor de la base de datos de suscripciones.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_copysubscription [ @filename = ] 'file_name'
    [ , [ @temp_dir = ] 'temp_dir' ]
    [ , [ @overwrite_existing_file = ] overwrite_existing_file]

Argumentos

• [ @filename =] 'file_name'
  Es la cadena que especifica la ruta de acceso completa, incluido el nombre de archivo, donde se guardará una copia del archivo de datos (.mdf). file name es de tipo nvarchar(260) y no tiene ningún valor predeterminado.

• [ @temp_dir=] 'temp_dir'
  Es el nombre del directorio que contiene los archivos temporales. temp_dir es de tipo nvarchar(260) y su valor predeterminado es NULL. Si su valor es NULL, se utiliza el directorio de datos predeterminado de Microsoft SQL Server. El directorio debe tener espacio suficiente para contener un archivo que tenga el tamaño de todos los archivos de la base de datos del suscriptor combinados.

• [ @overwrite_existing_file=] 'overwrite_existing_file'
  Es una marca opcional de tipo Boolean que especifica si se sobrescribirá o no un archivo existente con el mismo nombre especificado en @filename. overwrite_existing_filees de tipo bit y su valor predeterminado es 0. Si su valor es 1, sobrescribe el archivo especificado por @filename si existe. Si su valor es 0, el procedimiento almacenado genera un error si existe el archivo y no se sobrescribe.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_copysubscription se utiliza en todos los tipos de replicación para copiar una base de datos de suscripciones en un archivo como alternativa a la aplicación de una instantánea en el suscriptor. La base de datos se debe configurar para que solo admita suscripciones de extracción. Los usuarios que tengan los permisos apropiados pueden realizar copias de la base de datos de suscripciones y, a continuación, enviar por correo electrónico, copiar o transportar el archivo de suscripción (.msf) a otro suscriptor, donde se puede adjuntar como una suscripción.

El tamaño de la base de datos de suscripciones que se va a copiar debe ser inferior a 2 gigabytes (GB).

sp_copysubscription solamente se admite para las bases de datos con suscripciones de cliente y no se puede ejecutar si la base de datos contiene suscripciones de servidor.

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_copysubscription.

Vea también

Referencia

Procedimientos almacenados del sistema (Transact-SQL)

Conceptos

Ubicaciones alternativas para las carpetas de instantáneas