sp_addsubscriber (Transact-SQL)
Aplica-se a:
SQL ServerBanco de Dados SQL do Azure
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.
Importante
Esse procedimento armazenado foi preterido. Você não precisa mais registrar explicitamente um Assinante no Editor.
Convenções de sintaxe de Transact-SQL
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' ]
[ ; ]
Argumentos
@subscriber [ = ] N'assinante'
O nome do servidor a ser adicionado como um Assinante válido para as 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 | Descrição |
|---|---|
0 (padrão) |
Assinante do SQL Server |
1 |
Servidor de fontes de dados ODBC |
2 |
Banco de dados do Microsoft Jet |
3 |
Provedor OLE DB |
@login [ = ] N'login'
A ID de logon para Autenticação do SQL Server. @login é sysname, com um padrão de NULL.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@password [ = ] N'senha'
A senha para a Autenticação do SQL Server. @password é nvarchar(524), com um padrão de NULL.
Não use uma senha em branco. Use uma senha forte.
Observaçã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 ao criar 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.
Quando um valor é especificado, ele é usado como padrão ao criar 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.
Quando um valor é especificado, ele é usado como padrão ao criar 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.
Quando um valor é especificado, ele é usado como padrão ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@frequency_type [ = ] frequency_type
Especifica a frequência com a qual agendar o agente de replicaçã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 (padrão) |
Iniciar automaticamente |
128 |
Recorrente |
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@frequency_interval [ = ] frequency_interval
O valor aplicado à frequência definida por @frequency_type. @frequency_interval é int, com um padrão de 1.
Observaçã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 ao criar 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 é definido como 32 (relativo mensal). @frequency_relative_interval é int, e pode ser um desses valores.
| Valor | Descrição |
|---|---|
1 (padrão) |
Primeiro |
2 |
Segundo |
4 |
Terceiro |
8 |
Quarto |
16 |
Último |
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@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
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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@frequency_subday [ = ] frequency_subday
Com que frequência reagendar durante o período definido. @frequency_subday é int, e pode ser um desses valores.
| Valor | Descrição |
|---|---|
1 |
Uma vez |
2 |
Second |
4 (padrão) |
Minuto |
8 |
Hora |
Observaçã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 ao criar 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 de 5.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@active_start_time_of_day [ = ] active_start_time_of_day
A hora do dia em que o agente de replicação é agendado pela primeira vez, formatado como HHmmss. @active_start_time_of_day é int, com um padrão de 0.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@active_end_time_of_day [ = ] active_end_time_of_day
A hora do dia em que o agente de replicação para de ser agendado, formatado como HHmmss. @active_end_time_of_day é int, com um padrão de , o que significa 23:59:59 como medido em um relógio de 23595924 horas.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@active_start_date [ = ] active_start_date
A data em que o agente de replicação é agendado pela primeira vez, formatado como yyyyMMdd. @active_start_date é int, com um padrão de 0.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@active_end_date [ = ] active_end_date
A data em que o agente de replicação para de ser agendado, formatado como yyyyMMdd. @active_end_date é int, com um default de , o que significa 31 de dezembro de 999912319999.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@description [ = ] N'descrição'
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.
0especifica a autenticação do SQL Server.1especifica a autenticação do Windows.
Observaçã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 ao criar assinaturas neste Assinante e uma mensagem de aviso é retornada.
@encrypted_password [ = ] encrypted_password
Esse parâmetro foi preterido e é fornecido apenas para compatibilidade com versões anteriores. Definir @encrypted_password para qualquer valor, mas 0 resulta em um erro.
@publisher [ = ] N'editor'
Especifica um Publicador que não seja do SQL Server. @publisher é sysname, com um padrão de NULL.
@publisher não deve ser usado ao publicar de um Publicador do SQL Server.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Comentários
sp_addsubscriber é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.
sp_addsubscriber não é necessário quando o Assinante só tem assinaturas anônimas para mesclar publicações.
sp_addsubscribergrava na tabela MSsubscriber_info no banco de dados de distribuição.
Permissões
Somente membros da função de servidor fixa sysadmin podem executar sp_addsubscriber.
Conteúdo relacionado
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de