sp_addsubscriber (Transact-SQL)

  • Artículo

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.

Nota importanteImportante

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

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_addsubscriber [ @subscriber = ] 'subscriber'
    [ , [ @type = ] type ] 
    [ , [ @login = ] 'login' ]
    [ , [ @password = ] '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 = ] 'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] 'publisher' ]

Argumentos

  • [ @subscriber=] 'subscriber'
    Es el nombre del servidor que se va a agregar como un suscriptor válido a las publicaciones de este servidor. subscriber es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @type=] type
    Es el tipo de suscriptor. type es de tipo tinyint y puede tener uno de estos valores.

    Valor

    Descripción

    0 (predeterminado)

    Suscriptor de Microsoft SQL Server

    1

    Servidor del origen de datos ODBC

    2

    Base de datos Microsoft Jet

    3

    proveedor OLE DB

  • [ @login=] 'login'
    Es el identificador de inicio de sesión para la autenticación de SQL Server. login es de tipo sysname y su valor predeterminado es NULL.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @password=] 'password'
    Es la contraseña para la autenticación de SQL Server. password es de tipo nvarchar(524) y su valor predeterminado es NULL.

    Nota de seguridadNota de seguridad

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

    [!NOTA]

    Este parámetro ha quedado desusado y solo se mantiene por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor. Además se devolverá un mensaje de advertencia.

  • [ @commit_batch_size=] commit_batch_size
    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores.

    [!NOTA]

    Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @status_batch_size=] status_batch_size
    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores.

    [!NOTA]

    Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @flush_frequency=] flush_frequency
    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores.

    [!NOTA]

    Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @frequency_type=] frequency_type
    Es la frecuencia con que se programa el agente de replicación. frequency_type es de tipo int y puede tener uno de estos valores.

    Valor

    Descripción

    1

    Una vez

    2

    A petición

    4

    Diariamente

    8

    Semanalmente

    16

    Mensualmente

    32

    Mensualmente relativa

    64 (predeterminado)

    Iniciar automáticamente

    128

    Periódica

    [!NOTA]

    Este parámetro ya no se utiliza y se mantiene solamente por compatibilidad con versiones anteriores de scripts. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor. Además se devolverá un mensaje de advertencia.

  • [@frequency_interval= ] frequency_interval
    Es el valor que se aplica a la frecuencia establecida por frequency_type. frequency_interval es de tipo int y su valor predeterminado es 1.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @frequency_relative_interval=] frequency_relative_interval
    Es la fecha del Agente de replicación. Este parámetro se utiliza cuando frequency_type se establece en 32 (mensualmente relativa). frequency_relative_interval es de tipo int y puede tener uno de estos valores.

    Valor

    Descripción

    1 (predeterminado)

    Primero

    2

    Segundo

    4

    Tercero

    8

    Cuarto

    16

    Último

    [!NOTA]

    Este parámetro ya no se utiliza y se mantiene solamente por compatibilidad con versiones anteriores de scripts. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor. Además se devolverá un mensaje de advertencia.

  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    Es el factor de repetición que se utiliza en frequency_type. frequency_recurrence_factor es de tipo int y su valor predeterminado es 0.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @frequency_subday=] frequency_subday
    Es la frecuencia de repetición de la programación durante el periodo definido. frequency_subday es de tipo int y puede tener uno de estos valores.

    Valor

    Descripción

    1

    Una vez

    2

    Segundo

    4 (predeterminado)

    Minute

    8

    Hour

    [!NOTA]

    Este parámetro ya no se utiliza y se mantiene solamente por compatibilidad con versiones anteriores de scripts. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor. Además se devolverá un mensaje de advertencia.

  • [ @frequency_subday_interval=] frequency_subday_interval
    Es el intervalo de frequency_subday. frequency_subday_interval es de tipo int y su valor predeterminado es 5.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @active_start_time_of_day=] active_start_time_of_day
    Es la 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 de tipo int y su valor predeterminado es 0.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @active_end_time_of_day=] active_end_time_of_day
    Es la hora del día en que el agente de replicación deja de estar programado, con el formato HHMMSS. active_end_time_of_dayes de tipo int y su valor predeterminado es 235959, es decir, 11:59:59 p. m. en un reloj de 24 horas.

    [!NOTA]

    Este parámetro ha quedado desusado y solo se mantiene por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor. Además se devolverá un mensaje de advertencia.

  • [ @active_start_date=] active_start_date
    Es la fecha en que el agente de replicación se programa por primera vez, con el formato AAAAMMDD. active_start_date es de tipo int y su valor predeterminado es 0.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @active_end_date=] active_end_date
    Es la fecha en la que el agente de replicación deja de estar programado, con el formato AAAAMMDD. active_end_date es de tipo int y su valor predeterminado es 99991231, que significa 31 de diciembre de 9999.

    [!NOTA]

    Este parámetro ha quedado desusado y se mantiene solo por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor; se devolverá un mensaje de advertencia.

  • [ @description=] 'description'
    Es una descripción del suscriptor. description es de tipo nvarchar(255) y su valor predeterminado es NULL.

  • [ @security_mode=] security_mode
    Es el modo de seguridad implementado. security_mode es de tipo int y su valor predeterminado es 1. 0 especifica Autenticación de SQL Server. 1 especifica Autenticación de Windows.

    [!NOTA]

    Este parámetro ha quedado desusado y solo se mantiene por compatibilidad de scripts con versiones anteriores. La propiedad ahora se especifica por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se utilizará como valor predeterminado al crear suscripciones en este suscriptor. Además se devolverá un mensaje de advertencia.

  • [ @encrypted_password=] encrypted_password
    Este parámetro ha quedado desusado y solo se mantiene por compatibilidad con versiones anteriores. Si se establece encrypted_password en un valor que no sea 0, se producirá un error.

  • [ @publisher= ] 'publisher'
    Especifica un publicador que no es de SQL Server. publisher es de tipo sysname y su valor predeterminado es NULL.

    [!NOTA]

    publisher no se puede utilizar al publicar desde un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

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

sp_addsubscriber no es necesario cuando el suscriptor solamente tendrá suscripciones anónimas a publicaciones de combinación.

sp_addsubscriber escribe 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.

Vea también

Referencia

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)

Conceptos

Crear una suscripción de inserción

Crear una suscripción de extracción