sp_changesubscriber (Transact-SQL)

Aplica-se a: Instância Gerenciada de SQL do Azure do SQL Server

Altera as opções para um Assinante. Qualquer tarefa de distribuição para os Assinantes deste Publicador será atualizada. Esse procedimento armazenado grava na tabela MSsubscriber_info no banco de dados de distribuição. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

[ @subscriber = ] 'subscriber' É o nome do Assinante no qual as opções serão alteradas. subscriber é sysname, sem padrão.

[ @type = ] type É o tipo de assinante. type é tinyint, com um padrão de NULL. 0 indica um Assinante do Microsoft SQL Server. 1 especifica um Assinante não SQL Server ou outro servidor de fonte de dados ODBC.

[ @login = ] 'login' É a ID de logon de autenticação do SQL Server. login é sysname, com um padrão de NULL.

[ @password = ] 'password' É a senha de autenticação do SQL Server. password é sysname, com um padrão de %. % indica que não há nenhuma alteração na propriedade password.

[ @commit_batch_size = ] commit_batch_size Com suporte apenas para compatibilidade com versões anteriores.

[ @status_batch_size = ] status_batch_size Com suporte apenas para compatibilidade com versões anteriores.

[ @flush_frequency = ] flush_frequency Com suporte apenas para compatibilidade com versões anteriores.

[ @frequency_type = ] frequency_type É a frequência com que agendar a tarefa de distribuição. frequency_type é int e pode ser um desses valores.

Valor	Description
1	Uma vez
2	Sob demanda
4	Diariamente
8	Semanalmente
16	Mensal
32	Relativo ao mês
64	Iniciar automaticamente
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	Description
1	First
2	Second
4	Terceiro
8	Quarto
16	Last

[ @frequency_recurrence_factor = ] frequency_recurrence_factorÉ a frequência com que a tarefa de distribuição deve se repetir durante o frequency_type definido. frequency_recurrence_factor é int, com um padrão de NULL.

[ @frequency_subday = ] frequency_subday É a frequência com que reagendar durante o período definido. frequency_subday é int e pode ser um desses valores.

Valor	Description
1	Uma vez
2	Second
4	Minuto
8	Hora

[ @frequency_subday_interval = ] frequency_subday_interval É o intervalo para frequence_subday. frequency_subday_interval é int, com um padrão de NULL.

[ @active_start_time_of_day = ] active_start_time_of_day É a hora do dia em que a tarefa de distribuição é agendada pela primeira vez, formatada como HHmmss. active_start_time_of_day é int, com um padrão de NULL.

[ @active_end_time_of_day = ] active_end_time_of_day É a hora do dia em que a tarefa de distribuição deixa de ser agendada, formatada como HHmmss. active_end_time_of_day é int, com um padrão de NULL.

[ @active_start_date = ] active_start_date É a data em que a tarefa de distribuição é agendada pela primeira vez, formatada como yyyyMMdd. active_start_date é int, com um padrão de NULL.

[ @active_end_date = ] active_end_date É a data em que a tarefa de distribuição deixa de ser agendada, formatada como yyyyMMdd. active_end_date é int, com um padrão de NULL.

[ @description = ] 'description' É 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 = ] 'publisher' Especifica um Publicador não SQL Server. publisher é sysname, com um padrão de NULL.

Observação

publisher não deve ser usado ao alterar as propriedades do artigo em um Publicador do SQL Server.

Valores do código de retorno

0 (sucesso) ou 1 (falha)

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.

Confira também

sp_addsubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
sp_helpserver (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)