Partilhar via


sp_addsubscriber (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do Azure

Adiciona um novo Assinante a um Editor, permitindo-lhe receber publicações. Este procedimento armazenado é executado no Publisher na base de dados de publicações para publicações snapshot e transacionais; e para publicações de fusão usando um Distribuidor remoto, este procedimento armazenado é executado no Distribuidor.

Importante

Este procedimento armazenado foi descontinuado. Já não é obrigado a registar explicitamente um Assinante na Editora.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @subscriber = ] N'assinante'

O nome do servidor a ser adicionado como subscritor válido às publicações neste servidor. @subscriber é sysname, sem padrão.

[ @type = ] tipo

O tipo de assinante. @type é minúsculo e pode ser um desses valores.

Valor Description
0 (padrão) SQL Server Subscriber
1 Servidor fonte de dados ODBC
2 Base de dados Microsoft Jet
3 fornecedor de OLE DB

@login [ = ] N'login'

O ID de login para Autenticação SQL Server. @login é sysname, com um padrão de NULL.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

@password [ = ] N'senha'

A palavra-passe para Autenticação SQL Server. @password é nvarchar(524), com um padrão de NULL.

Não utilize uma palavra-passe em branco. Use uma senha forte.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @commit_batch_size = ] commit_batch_size

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts.

Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @status_batch_size = ] status_batch_size

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts.

Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @flush_frequency = ] flush_frequency

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts.

Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @frequency_type = ] frequency_type

Especifica a frequência com que agendar o agente de replicação. @frequency_type é int, e pode ser um desses valores.

Valor Description
1 Uma vez
2 A pedido
4 Diariamente
8 Weekly
16 Monthly
32 Parente mensal
64 (padrão) Arranque automático
128 Recorrente

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @frequency_interval = ] frequency_interval

O valor aplicado à frequência definida por @frequency_type. @frequency_interval é int, com um padrão de 1.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @frequency_relative_interval = ] frequency_relative_interval

A data do agente de replicação. Este parâmetro é usado quando @frequency_type está definido como 32 (relativo mensal). @frequency_relative_interval é int, e pode ser um desses valores.

Valor Description
1 (padrão) First
2 Second
4 Terceiro
8 Quarto
16 Último

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

O fator de recorrência utilizado por @frequency_type. @frequency_recurrence_factor é int, com um padrão de 0.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @frequency_subday = ] frequency_subday

Com que frequência reagendar durante o período definido. @frequency_subday é int, e pode ser um desses valores.

Valor Description
1 Uma vez
2 Second
4 (padrão) Minute
8 Hora

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @frequency_subday_interval = ] frequency_subday_interval

O intervalo para frequency_subday. @frequency_subday_interval é int, com um padrão de 5.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @active_start_time_of_day = ] active_start_time_of_day

A hora do dia em que o agente de replicação é inicialmente agendado, formatada como HHmmss. @active_start_time_of_day é int, com um padrão de 0.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @active_end_time_of_day = ] active_end_time_of_day

A hora do dia em que o agente de replicação deixa de ser agendada, formatada como HHmmss. @active_end_time_of_day é int, com um padrão de 235959, o que significa 23:59:59 conforme medido num relógio de 24 horas.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @active_start_date = ] active_start_date

A data em que o agente de replicação é inicialmente agendado, formatada como yyyyMMdd. @active_start_date é int, com um padrão de 0.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @active_end_date = ] active_end_date

A data em que o agente de replicação deixa de ser agendado, formatada como yyyyMMdd. @active_end_date é int, com um padrão de 99991231, o que significa 31 de dezembro de 9999.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

[ @description = ] N'descrição'

Uma descrição em 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 SQL Server.
  • 1 especifica autenticação do Windows.

Observação

Este parâmetro está obsoleto e é mantido para compatibilidade retroativa dos scripts. A propriedade é agora especificada por subscrição ao executar sp_addsubscription. Quando um valor é especificado, é usado como padrão ao criar subscrições nesse Assinante e é devolvida uma mensagem de aviso.

@encrypted_password [ = ] encrypted_password

Este parâmetro está obsoleto e é fornecido apenas para compatibilidade retroativa. Definir @encrypted_password para qualquer valor que não 0 seja resulta num erro.

@publisher [ = ] N'editor'

Especifica um Editor de Server que não seja SQL. @publisher é sysname, com um padrão de NULL.

@publisher não devem ser usados ao publicar a partir de um editor SQL Server.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

sp_addsubscriber é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.

sp_addsubscriber não é obrigatório quando o assinante só tem subscrições anónimas para fundir publicações.

sp_addsubscriber escreve na tabela MSsubscriber_info na base de dados de distribuição .

Permissions

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