Compartilhar via

sp_changesubscriber (Transact-SQL)

  • Artigo

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 MSsubscriber_info tabela 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 = ] 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 as opções serão alteradas. @subscriber é sysname, sem padrão.

@type [ = ] tipo

O tipo de assinante. @type é tinyint, com um padrão de NULL.

  • 0 indica um Assinante do SQL Server.
  • 1 especifica um Assinante não SQL Server ou outro servidor de fonte de dados ODBC.

@login [ = ] N'login'

A ID de logon de 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á nenhuma alteração na propriedade password.

@commit_batch_size [ = ] commit_batch_size

Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

@status_batch_size [ = ] status_batch_size

Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

@flush_frequency [ = ] flush_frequency

Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

@frequency_type [ = ] frequency_type

Especifica a freqüê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 Sob demanda
4 Diário
8 Semanal
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 Descrição
1 First
2 Segundo
4 Terceiro
8 Quarto
16 Last

@frequency_recurrence_factor [ = ] frequency_recurrence_factor

Especifica a frequência com que a tarefa de distribuição deve ocorrer durante o @frequency_type definido. @frequency_recurrence_factor é int, com um padrão de NULL.

@frequency_subday [ = ] frequency_subday

Especifica a frequência de reprogramação 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 [ = ] 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 [ = ] 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'editor'

Especifica um Publicador não-SQL Server. @publisher é sysname, com um padrão de NULL.

@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.

Conteúdo relacionado