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.

ms188360.note(es-es,SQL.90).gifImportante:
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 Microsoft SQL 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.

    ms188360.security(es-es,SQL.90).gifNota 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 réplica. 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 réplica. 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 réplica, 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 réplica, 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 réplica, 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 réplica, 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.

Notas

sp_addsubscriber se utiliza en la réplica 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.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)

Otros recursos

Cómo crear una suscripción de inserción (programación de la réplica con Transact-SQL)
Cómo crear una suscripción de extracción (programación de la réplica con Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005