sp_changesubscriber (Transact-SQL)
Aplica-se a:SQL ServerAzure SQL Managed Instance
Altera as opções de um Assinante. Qualquer tarefa de distribuição para os Subscritores deste Editor é atualizada. Este procedimento armazenado grava na tabela MSsubscriber_info
no banco de dados de distribuição. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.
Transact-SQL convenções de sintaxe
Sintaxe
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'assinante'
O nome do Assinante no qual alterar as opções. @subscriber é sysname, sem padrão.
[ @type = ] tipo
O tipo de assinante.
@type é minúsculo, com um padrão de NULL
.
-
0
indica um Assinante do SQL Server. -
1
especifica um Assinante de servidor de fonte de dados não-SQL ou outro servidor de fonte de dados ODBC.
[ @login = ] N'login'
A ID de logon da Autenticação do SQL Server.
@login é sysname, com um padrão de NULL
.
[ @password = ] N'senha'
A senha de Autenticação do SQL Server.
@password é sysname, com um padrão de %
, o que indica que não há alteração na propriedade password.
[ @commit_batch_size = ] commit_batch_size
Este parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
[ @status_batch_size = ] status_batch_size
Este parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
[ @flush_frequency = ] flush_frequency
Este parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
[ @frequency_type = ] frequency_type
Especifica a frequência com a qual agendar a tarefa de distribuição. @frequency_type é int, e pode ser um desses valores.
Valor | Descrição |
---|---|
1 |
Uma vez |
2 |
A pedido |
4 |
Diariamente |
8 |
Semanalmente |
16 |
Mensal |
32 |
Mensal relativo |
64 |
Arranque automático |
128 |
Recorrente |
[ @frequency_interval = ] frequency_interval
O intervalo para @frequency_type.
@frequency_interval é int, com um padrão de NULL
.
[ @frequency_relative_interval = ] frequency_relative_interval
A data da tarefa de distribuição. Este parâmetro é usado quando @frequency_type é definido como 32
(relativo mensal).
@frequency_relative_interval é int, e pode ser um desses valores.
Valor | Descrição |
---|---|
1 |
Primeiro |
2 |
Segundo |
4 |
Terceiro |
8 |
Quarta |
16 |
Última |
[ @frequency_recurrence_factor = ] frequency_recurrence_fator
Especifica a frequência com que a tarefa de distribuição deve ser repetida durante a @frequency_typedefinida.
@frequency_recurrence_fator é int, com um padrão de NULL
.
[ @frequency_subday = ] frequency_subday
Especifica a frequência de reagendamento durante o período definido. @frequency_subday é int, e pode ser um desses valores.
Valor | Descrição |
---|---|
1 |
Uma vez |
2 |
Segundo |
4 |
Minuto |
8 |
Hora |
[ @frequency_subday_interval = ] frequency_subday_interval
O intervalo para @frequency_subday.
@frequency_subday_interval é int, com um padrão de NULL
.
[ @active_start_time_of_day = ] ative_start_time_of_day
A hora do dia em que a tarefa de distribuição é agendada pela primeira vez, formatada como HHmmss
.
@ative_start_time_of_day é int, com um padrão de NULL
.
[ @active_end_time_of_day = ] ative_end_time_of_day
A hora do dia em que a tarefa de distribuição deixa de ser agendada, formatada como HHmmss
.
@ative_end_time_of_day é int, com um padrão de NULL
.
[ @active_start_date = ] ative_start_date
A data em que a tarefa de distribuição é agendada pela primeira vez, formatada como yyyyMMdd
.
@ative_start_date é int, com um padrão de NULL
.
[ @active_end_date = ] ative_end_date
A data em que a tarefa de distribuição deixa de ser agendada, formatada como yyyyMMdd
.
@ative_end_date é int, com um padrão de NULL
.
[ @description = ] N'descrição'
Uma descrição de texto opcional.
@description é nvarchar(255), com um padrão de NULL
.
[ @security_mode = ] security_mode
O modo de segurança implementado. @security_mode é int, e pode ser um desses valores.
Valor | Descrição |
---|---|
0 |
Autenticação do SQL Server |
1 |
Autenticação do Windows |
[ @publisher = ] N'editora'
Especifica um Editor que não seja do SQL Server.
@publisher é sysname, com um padrão de NULL
.
@publisher não deve ser usado ao alterar as propriedades do artigo em um Editor do SQL Server.
Valores de código de retorno
0
(sucesso) ou 1
(fracasso).
Comentários
sp_changesubscriber
é usado em todos os tipos de replicação.
Permissões
Somente membros da função de servidor fixa sysadmin podem executar sp_changesubscriber
.