sp_addsubscriber (Transact-SQL)
Se aplica a: SQL Server Azure SQL Database
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.
Importante
Este procedimiento almacenado ha quedado desusado. Ya no es necesario registrar explícitamente un suscriptor en el publicador.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_addsubscriber
[ @subscriber = ] N'subscriber'
[ , [ @type = ] type ]
[ , [ @login = ] N'login' ]
[ , [ @password = ] N'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 = ] N'description' ]
[ , [ @security_mode = ] security_mode ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @publisher = ] N'publisher' ]
[ ; ]
Argumentos
[ @subscriber = ] N'subscriber'
Nombre del servidor que se va a agregar como suscriptor válido a las publicaciones de este servidor. @subscriber es sysname, sin ningún valor predeterminado.
[ @type = ] type
Tipo de suscriptor. @type es tinyint y puede ser uno de estos valores.
Valor | Descripción |
---|---|
0 (valor predeterminado) |
Suscriptor de SQL Server |
1 |
Servidor del origen de datos ODBC |
2 |
Base de datos de Microsoft Jet |
3 |
Proveedor OLE DB |
[ @login = ] N'login'
Identificador de inicio de sesión para la autenticación de SQL Server. @login es sysname, con un valor predeterminado de NULL
.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @password = ] N'password'
Contraseña para la autenticación de SQL Server. @password es nvarchar(524), con un valor predeterminado de NULL
.
No use una contraseña en blanco. Utilice una contraseña segura.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @commit_batch_size = ] commit_batch_size
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.
Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @status_batch_size = ] status_batch_size
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.
Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @flush_frequency = ] flush_frequency
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.
Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @frequency_type = ] frequency_type
Especifica la frecuencia con la que programar el agente de replicación. @frequency_type es int y puede ser uno de estos valores.
Valor | Descripción |
---|---|
1 |
Una vez |
2 |
A petición |
4 |
Diario |
8 |
Semanal |
16 |
Mensual |
32 |
Mensualmente relativa |
64 (valor predeterminado) |
Iniciar automáticamente |
128 |
Periódico |
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @frequency_interval = ] frequency_interval
Valor aplicado a la frecuencia establecida por @frequency_type. @frequency_interval es int, con un valor predeterminado de 1
.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @frequency_relative_interval = ] frequency_relative_interval
Fecha del agente de replicación. Este parámetro se usa cuando @frequency_type se establece 32
en (relativo mensual). @frequency_relative_interval es int y puede ser uno de estos valores.
Valor | Descripción |
---|---|
1 (valor predeterminado) |
Primero |
2 |
Segundo |
4 |
Tercero |
8 |
Cuarta |
16 |
Último |
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Factor de periodicidad utilizado por @frequency_type. @frequency_recurrence_factor es int, con un valor predeterminado de 0
.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @frequency_subday = ] frequency_subday
Frecuencia con la que se vuelve a programar durante el período definido. @frequency_subday es int y puede ser uno de estos valores.
Valor | Descripción |
---|---|
1 |
Una vez |
2 |
Second |
4 (valor predeterminado) |
Minute |
8 |
Hora |
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalo de frequency_subday. @frequency_subday_interval es int, con un valor predeterminado de 5
.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @active_start_time_of_day = ] active_start_time_of_day
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 int, con un valor predeterminado de 0
.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @active_end_time_of_day = ] active_end_time_of_day
Hora del día en que el agente de replicación deja de programarse, con el formato HHmmss
. @active_end_time_of_day es int, con un valor predeterminado de 235959
, lo que significa 11:59:59 p.m. como se mide en un reloj de 24 horas.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @active_start_date = ] active_start_date
La fecha en que el agente de replicación se programa por primera vez, con yyyyMMdd
el formato . @active_start_date es int, con un valor predeterminado de 0
.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @active_end_date = ] active_end_date
Fecha en la que el agente de replicación deja de programarse, con yyyyMMdd
el formato . @active_end_date es int, con un valor predeterminado de , lo que significa el 31 de 99991231
diciembre de 9999.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @description = ] N'description'
Descripción de texto del suscriptor. @description es nvarchar(255), con un valor predeterminado de NULL
.
[ @security_mode = ] security_mode
Modo de seguridad implementado. @security_mode es int, con un valor predeterminado de 1
.
0
especifica la autenticación de SQL Server.1
especifica autenticación de Windows.
Nota:
Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. La propiedad se especifica ahora por suscripción al ejecutar sp_addsubscription. Cuando se especifica un valor, se usa como valor predeterminado al crear suscripciones en este suscriptor y se devuelve un mensaje de advertencia.
[ @encrypted_password = ] encrypted_password
Este parámetro está en desuso y solo se proporciona para la compatibilidad con versiones anteriores. Si se establece @encrypted_password en cualquier valor, pero 0
se produce un error.
[ @publisher = ] N'publisher'
Especifica un publicador que no es de SQL Server. @publisher es sysname, con un valor predeterminado de NULL
.
@publisher no se debe usar al publicar desde un publicador de SQL Server.
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Comentarios
sp_addsubscriber
se usa en la replicación de instantáneas, la replicación transaccional y la replicación de mezcla.
sp_addsubscriber
no es necesario cuando el suscriptor solo tiene suscripciones anónimas para combinar publicaciones.
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
.