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.

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

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

Vea también

Tasks

Cómo crear una suscripción de inserción (programación de la replicación con Transact-SQL)

Cómo crear una suscripción de extracción (programación de la replicación con Transact-SQL)

Referencia

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)