sp_changesubscriber (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instâ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 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 [ = ] 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