sp_changesubscriber (Transact-SQL)

Se aplica a: SQL Server Azure SQL Managed Instance

Cambia las opciones de un suscriptor. Se actualizan todas las tareas de distribución de los suscriptores de este publicador. Este procedimiento almacenado escribe en la tabla de la MSsubscriber_info base de datos de distribución. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_changesubscriber
    [ @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 ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argumentos

[ @subscriber = ] N'subscriber'

Nombre del suscriptor en el que se van a cambiar las opciones. @subscriber es sysname, sin ningún valor predeterminado.

[ @type = ] type

Tipo de suscriptor. @type es tinyint, con un valor predeterminado de NULL.

  • 0 indica un suscriptor de SQL Server.
  • 1 especifica un suscriptor de servidor de origen de datos ODBC que no sea SQL Server u otro suscriptor del servidor de origen de datos ODBC.

[ @login = ] N'login'

Identificador de inicio de sesión de autenticación de SQL Server. @login es sysname, con un valor predeterminado de NULL.

[ @password = ] N'password'

Contraseña de autenticación de SQL Server. @password es sysname, con un valor predeterminado de %, que indica que no hay ningún cambio en la propiedad password.

[ @commit_batch_size = ] commit_batch_size

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.

[ @status_batch_size = ] status_batch_size

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.

[ @flush_frequency = ] flush_frequency

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts.

[ @frequency_type = ] frequency_type

Especifica la frecuencia con la que programar la tarea de distribució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 Iniciar automáticamente
128 Periódico

[ @frequency_interval = ] frequency_interval

Intervalo de @frequency_type. @frequency_interval es int, con un valor predeterminado de NULL.

[ @frequency_relative_interval = ] frequency_relative_interval

Fecha de la tarea de distribució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 First
2 Segundo
4 Tercero
8 Cuarta
16 Último

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Especifica la frecuencia con la que se debe repetir la tarea de distribución durante el @frequency_type definido. @frequency_recurrence_factor es int, con un valor predeterminado de NULL.

[ @frequency_subday = ] frequency_subday

Especifica la 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 Minute
8 Hora

[ @frequency_subday_interval = ] frequency_subday_interval

Intervalo de @frequence_subday. @frequency_subday_interval es int, con un valor predeterminado de NULL.

[ @active_start_time_of_day = ] active_start_time_of_day

Hora del día en que la tarea de distribución se programa por primera vez, con HHmmssel formato . @active_start_time_of_day es int, con un valor predeterminado de NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Hora del día en que la tarea de distribución deja de programarse, con el formato HHmmss. @active_end_time_of_day es int, con un valor predeterminado de NULL.

[ @active_start_date = ] active_start_date

Fecha en que la tarea de distribución está programada por primera vez, con formato .yyyyMMdd @active_start_date es int, con un valor predeterminado de NULL.

[ @active_end_date = ] active_end_date

Fecha en la que la tarea de distribución deja de programarse, con el formato yyyyMMdd. @active_end_date es int, con un valor predeterminado de NULL.

[ @description = ] N'description'

Descripción de texto opcional. @description es nvarchar(255), con un valor predeterminado de NULL.

[ @security_mode = ] security_mode

Modo de seguridad implementado. @security_mode es int y puede ser uno de estos valores.

Valor Descripción
0 SQL Server Authentication
1 Autenticación de Windows

[ @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 cambiar las propiedades del artículo en un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_changesubscriber se usa en todos los tipos de replicación.

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_changesubscriber.