sp_changesubscriber (Transact-SQL)

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 de publicação.

Ícone de vínculo de tópicoConvenções de sintaxe 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 do Assinante. type é tinyint, com um padrão de NULL. 0 indica um Assinante MicrosoftSQL Server. 1 especifica um não-SQL Server ou outro Assinante de servidor de fonte de dados ODBC .

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

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

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

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

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

  • [ @frequency_type=] frequency_type
    É a freqüência de agendamento da tarefa de distribuição. frequency_type é int, e pode ser um destes valores.

    Valor

    Descrição

    1

    Uma vez

    2

    Sob demanda

    4

    Diariamente

    8

    Semanalmente

    16

    Mensalmente

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

  • [ @frequency_relative_interval=] frequency_relative_interval
    É a data da tarefa de distribuição. É o parâmetro usado quando frequency_type é definido como 32 (relativo ao mês). frequency_relative_interval é int, e pode ser um destes valores.

    Valor

    Descrição

    1

    Primeiro

    2

    Segundo

    4

    Terceiro

    8

    Quarto

    16

    Último

  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    É a freqüência de repetição da tarefa de distribuição durante o frequency_type definido. frequency_recurrence_factor é int, com um padrão de NULL.

  • [ @frequency_subday=] frequency_subday
    É a freqüência de reagendamento durante o período definido. frequency_subday e int, e pode ser um destes valores.

    Valor

    Descrição

    1

    Uma vez

    2

    Segundo

    4

    Minuto

    8

    Hora

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

  • [ @active_start_time_of_day=] active_start_time_of_day
    É a hora do dia do primeiro agendamento da tarefa de distribuição, 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 do primeiro agendamento da tarefa de distribuição, 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 destes 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 NULL.

    ObservaçãoObservação

    O publicador não deve ser usado ao alterar propriedades de artigo em um Publicador SQL Server.

Valores de código de retorno

0 (êxito) 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.