sp_addsubscriber (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Database

Agrega un suscriptor nuevo a un publicador, habilitándolo para recibir publicaciones. Para las publicaciones de instantáneas y transaccionales, este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones; para las publicaciones de combinación que utilizan un distribuidor remoto, lo hace en el distribuidor.

Importante

Este procedimiento almacenado ha quedado desusado. Ya no es necesario registrar explícitamente un suscriptor en el publicador.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_addsubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @description = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argumentos

[ @subscriber = ] N'subscriber'

Nombre del servidor que se va a agregar como suscriptor válido a las publicaciones de este servidor. @subscriber es sysname, sin ningún valor predeterminado.

[ @type = ] type

Tipo de suscriptor. @type es tinyint y puede ser uno de estos valores.

Value Descripción
0 (valor predeterminado) Suscriptor de SQL Server
1 Servidor del origen de datos ODBC
2 Base de datos de Microsoft Jet
3 Proveedor OLE DB

[ @login = ] N'login'

Identificador de inicio de sesión para la autenticación de SQL Server. @login es sysname, con un valor predeterminado de NULL.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @password = ] N'password'

Contraseña para la autenticación de SQL Server. @password es nvarchar(524), con un valor predeterminado de NULL.

No use una contraseña en blanco. Utilice una contraseña segura.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @commit_batch_size = ] commit_batch_size

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.

Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @status_batch_size = ] status_batch_size

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.

Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @flush_frequency = ] flush_frequency

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.

Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @frequency_type = ] frequency_type

Especifica la frecuencia con la que programar el agente de replicación. @frequency_type es int y puede ser uno de estos valores.

Value Descripción
1 Una vez
2 A petición
4 Diario
8 Semanal
16 Mensual
32 Mensualmente relativa
64 (valor predeterminado) Iniciar automáticamente
128 Periódico

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @frequency_interval = ] frequency_interval

Valor aplicado a la frecuencia establecida por @frequency_type. @frequency_interval es int, con un valor predeterminado de 1.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @frequency_relative_interval = ] frequency_relative_interval

Fecha del agente de replicación. Este parámetro se usa cuando @frequency_type se establece 32 en (relativo mensual). @frequency_relative_interval es int y puede ser uno de estos valores.

Value Descripción
1 (valor predeterminado) Primero
2 Segundo
4 Tercero
8 Cuarta
16 Último

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Factor de periodicidad utilizado por @frequency_type. @frequency_recurrence_factor es int, con un valor predeterminado de 0.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @frequency_subday = ] frequency_subday

Frecuencia con la que se vuelve a programar durante el período definido. @frequency_subday es int y puede ser uno de estos valores.

Value Descripción
1 Una vez
2 Second
4 (valor predeterminado) Minute
8 Hora

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @frequency_subday_interval = ] frequency_subday_interval

Intervalo de frequency_subday. @frequency_subday_interval es int, con un valor predeterminado de 5.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @active_start_time_of_day = ] active_start_time_of_day

Hora del día en que el agente de replicación se programa por primera vez, con el formato HHmmss. @active_start_time_of_day es int, con un valor predeterminado de 0.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @active_end_time_of_day = ] active_end_time_of_day

Hora del día en que el agente de replicación deja de programarse, con el formato HHmmss. @active_end_time_of_day es int, con un valor predeterminado de 235959, lo que significa 11:59:59 p.m. como se mide en un reloj de 24 horas.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @active_start_date = ] active_start_date

La fecha en que el agente de replicación se programa por primera vez, con yyyyMMddel formato . @active_start_date es int, con un valor predeterminado de 0.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @active_end_date = ] active_end_date

Fecha en la que el agente de replicación deja de programarse, con yyyyMMddel formato . @active_end_date es int, con un valor predeterminado de , lo que significa el 31 de 99991231diciembre de 9999.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @description = ] N'description'

Descripción de texto del suscriptor. @description es nvarchar(255), con un valor predeterminado de NULL.

[ @security_mode = ] security_mode

Modo de seguridad implementado. @security_mode es int, con un valor predeterminado de 1.

  • 0 especifica la autenticación de SQL Server.
  • 1especifica autenticación de Windows.

Nota:

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.

[ @encrypted_password = ] encrypted_password

Este parámetro está en desuso y solo se proporciona para la compatibilidad con versiones anteriores. Si se establece @encrypted_password en cualquier valor, pero 0 se produce un error.

[ @publisher = ] N'publisher'

Especifica un publicador que no es de SQL Server. @publisher es sysname, con un valor predeterminado de NULL.

@publisher no se debe usar al publicar desde un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_addsubscriber se usa en la replicación de instantáneas, la replicación transaccional y la replicación de mezcla.

sp_addsubscriber no es necesario cuando el suscriptor solo tiene suscripciones anónimas para combinar publicaciones.

sp_addsubscriberescribe en la tabla MSsubscriber_info de la base de datos de distribución.

Permisos

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

Contenido relacionado