sp_changesubscriber (Transact-SQL)

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

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 alterar as opções. subscriber é sysname, sem padrão.

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

[ @login = ] 'login' É a ID de logon da 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 Suportado apenas para compatibilidade com versões anteriores.

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

[ @flush_frequency = ] flush_frequency Suportado 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. Esse 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 Último

[ @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 de reagendamento 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 que não seja do SQL Server. publisher é sysname, com um padrão de NULL.

Observação

publisher não deve ser usado ao alterar propriedades de artigo em um SQL Server Publisher.

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

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)