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

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