Compartir a través de


sp_addsubscriber (Transact-SQL)

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 mezcla que utilizan un distribuidor remoto, lo hace en el distribuidor.

Nota importanteImportante

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

Icono de vínculo a temasConvenciones 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 unos de estos valores.

    Valor

    Descripción

    0 (predeterminado)

    Microsoft Suscriptor de MicrosoftSQL Server

    1

    Servidor del origen de datos ODBC

    2

    Base de datos Microsoft Jet

    3

    Proveedor OLE DB

  • [ @login=] 'login'
    Es el Id. de inicio de sesión con Autenticación de SQL Server. login es de tipo sysname y su valor predeterminado es NULL.

    [!NOTA]

    Este parámetro se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 de 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 es obsoleto y sólo se mantiene por compatibilidad con versiones anteriores de las secuencias de comandos. 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 se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos.

    [!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 se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos.

    [!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 se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos.

    [!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

    Diario

    8

    Semanal

    16

    Mensual

    32

    Relativo mensual

    64 (predeterminado)

    Iniciar automáticamente

    128

    Periódico

    [!NOTA]

    Este parámetro es obsoleto y sólo se mantiene por compatibilidad con versiones anteriores de las secuencias de comandos. 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 va a aplicar a la frecuencia establecida por frequency_type. frequency_interval es de tipo int y su valor predeterminado es 1.

    [!NOTA]

    Este parámetro se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 ha establecido en 32 (mensual 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 es obsoleto y sólo se mantiene por compatibilidad con versiones anteriores de las secuencias de comandos. 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 periodicidad utilizado por frequency_type. frequency_recurrence_factor es de tipo int y su valor predeterminado es 0.

    [!NOTA]

    Este parámetro se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 con la que se vuelve a programar durante el período definido. frequency_subday es de tipo int y puede tener uno de estos valores.

    Valor

    Descripción

    1

    Una vez

    2

    Segundo

    4 (predeterminado)

    Minuto

    8

    Hora

    [!NOTA]

    Este parámetro es obsoleto y sólo se mantiene por compatibilidad con versiones anteriores de las secuencias de comandos. 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 se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 de la primera programación del agente de replicación, con el formato HHMMSS. active_start_time_of_day es de tipo int y su valor predeterminado es 0.

    [!NOTA]

    Este parámetro se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 a la que deja de estar programado el agente de replicación, con 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 es obsoleto y sólo se mantiene por compatibilidad con versiones anteriores de las secuencias de comandos. 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 la que comienza la programación del agente de replicación, en formato YYYYMMDD. active_start_date es de tipo int y su valor predeterminado es 0.

    [!NOTA]

    Este parámetro se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 se detiene la programación del agente de replicación, en formato YYYYMMDD. active_end_date es de tipo int y su valor predeterminado es 99991231, que significa 31 de diciembre de 9999.

    [!NOTA]

    Este parámetro se ha desaprobado y se mantiene sólo por compatibilidad con versiones anteriores de secuencias de comandos. 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 es obsoleto y sólo se mantiene por compatibilidad con versiones anteriores de las secuencias de comandos. 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 se ha desaprobado y sólo 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)

Notas

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

sp_addsubscriber no es necesario cuando el suscriptor sólo tendrá suscripciones anónimas a publicaciones de mezcla.

sp_addsubscriber escribe en la tabla MSsubscriber_info de la base de datos de distribución.

Permisos

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