Compartilhar via

sp_addsubscriber (Transact-SQL)

  • Artigo

Adiciona um novo Assinante a um Publicador, permitindo que ele receba publicações. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação, para publicações transacionais e de instantâneo; e para publicações de mesclagem que usam um Distribuidor remoto esse procedimento armazenado é executado no Distribuidor.

Observação importanteImportante

Esse procedimento armazenado foi preterido. Não é mais necessário que você registre explicitamente um Assinante no Publicador.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @subscriber=] 'subscriber'
    É o nome do servidor a ser adicionado como um Assinante válido à publicação neste servidor. subscriber é sysname, sem padrão.

  • [ @type=] type
    É o tipo de Assinante. type é tinyint, e pode ter um destes valores.

    Valor

    Descrição

    0 (padrão)

    Assinante do Microsoft SQL Server.

    1

    Servidor de fontes de dados ODBC

    2

    Banco de dados Microsoft Jet

    3

    Provedor OLE DB

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

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @password=] 'password'
    É a senha para a Autenticação do SQL Server. password é nvarchar(524), com um padrão de NULL.

    Observação sobre segurançaObservação sobre segurança

    Não use uma senha em branco. Use uma senha forte.
    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @commit_batch_size=] commit_batch_size
    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

    ObservaçãoObservação

    Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @status_batch_size=] status_batch_size
    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

    ObservaçãoObservação

    Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @flush_frequency=] flush_frequency
    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

    ObservaçãoObservação

    Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @frequency_type = ] frequency_type
    É a frequência de agendamento do agente de replicação. frequency_type é int, e pode ter um destes valores.

    Valor

    Descrição

    1

    Uma vez

    2

    Sob demanda

    4

    Diariamente

    8

    Semanalmente

    16

    Mensalmente

    32

    Relativo ao mês

    64 (padrão)

    Iniciar automaticamente

    128

    Recorrente
    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [@frequency_interval= ] frequency_interval
    E o valor aplicado à frequência definida por frequency_type. frequency_interval é int, com um padrão de 1.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @frequency_relative_interval = ] frequency_relative_interval
    É a data do agente de replicação. Esse parâmetro é usado quando frequency_type está definido como 32 (mensal relativo). frequency_relative_interval é int, e pode ter um destes valores.

    Valor

    Descrição

    1 (padrão)

    Primeiro

    2

    Segundo

    4

    Terceiro

    8

    Quarto

    16

    Último
    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    É o fator de recorrência usado por frequency_type. frequency_recurrence_factor é int, com um padrão 0.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

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

    Valor

    Descrição

    1

    Uma vez

    2

    Segundo

    4 (padrão)

    Minuto

    8

    Hora
    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

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

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @active_start_time_of_day = ] active_start_time_of_day
    É a hora do dia do primeiro agendamento do agente de replicação, formatada como HHMMSS. active_start_time_of_day é int, com um padrão de 0.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @active_end_time_of_day = ] active_end_time_of_day
    É a hora do dia do último agendamento do agente de replicação, formatada como HHMMSS. active_end_time_of_dayé int, com um padrão de 235959, que significa 23h59m59 medida em um relógio de 24 horas.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @active_start_date = ] active_start_date
    É a data do primeiro agendamento do agente de replicação, formatada como AAAAMMDD. active_start_date é int, com um padrão de 0.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @active_end_date = ] active_end_date
    É a data do último agendamento do agente de replicação, formatada como AAAAMMDD. active_end_date é int, com um padrão de 99991231, que significa 31 de dezembro de 9999.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @description=] 'description'
    É uma descrição de texto do Assinante. description é nvarchar(255), com um padrão de NULL.

  • [ @security_mode=] security_mode
    É o modo de segurança implementado. security_mode é int, com um padrão de 1. 0 especifica Autenticação do SQL Server . 1 especifica Autenticação do Windows.

    ObservaçãoObservação

    Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. A propriedade agora é especificada por assinatura ao executar sp_addsubscription. Quando um valor é especificado, ele é usado como padrão na criação de assinaturas neste Assinante e uma mensagem de aviso é retornada.

  • [ @encrypted_password=] encrypted_password
    Esse parâmetro foi preterido e só é fornecido para compatibilidade com versões anteriores. A definição de encrypted_password como qualquer valor diferente de 0 resultará em erro.

  • [ @publisher= ] 'publisher'
    Especifica um Publicador que não é do SQL Server. publisher é sysname, com um padrão de NULL.

    ObservaçãoObservação

    publisher não deve ser usado ao publicar de um Editor SQL Server.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_addsbscriber é usado em replicação de instantâneo, transacional e de mesclagem.

sp_addsubscriber não será requerido quando o Assinante só tiver assinaturas anônimas para publicações de mesclagem.

sp_addsubscriber grava na tabela MSsubscriber_info do banco de dados de distribuição.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_addsubscriber.

Consulte também

Referência

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)

Conceitos

Criar uma assinatura push

Criar uma assinatura pull