• Artículo

sp_copysubscription (Transact-SQL)

Nota importanteImportante

La característica de suscripciones adjuntables está obsoleta y se retirará en versiones posteriores. Esta característica no se debe utilizar en nuevos trabajos de desarrollo. En las publicaciones de mezcla divididas en particiones mediante filtros con parámetros, se recomienda utilizar las nuevas características de 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 mezcla con filtros con parámetros. En publicaciones en las que no se hayan creado particiones, puede inicializar una suscripción con una copia de seguridad. Para obtener más información, vea Inicializar una suscripción de mezcla sin una instantánea y 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. Sólo 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.

Icono de vínculo a temasConvenciones 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 un indicador booleano opcional 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 sólo 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 sólo 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

Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_copysubscription.