sp_changesubscriber (Transact-SQL)
Aplica-se a:SQL ServerInstâ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 tabela MSsubscriber_info 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= ] '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 Assinante. type é tinyint, com um padrão de NULL. 0 indica um assinante do Microsoft SQL Server. 1 especifica um Assinante de servidor de fonte de dados ODBC que não seja do SQL Server.
[ @login = ] 'login'
É a ID de logon da Autenticação do SQL Server. login é sysname, com um padrão de NULL.
[ @password = ] 'password'
É a senha de autenticação do SQL Server. password é sysname, com um padrão de %. % indica que não há nenhuma alteração na propriedade password.
[ @commit_batch_size = ] commit_batch_size
Suportado apenas para compatibilidade com versões anteriores.
[ @status_batch_size = ] status_batch_size
Suportado apenas para compatibilidade com versões anteriores.
[ @flush_frequency = ] flush_frequency
Suportado apenas para compatibilidade com versões anteriores.
[ @frequency_type = ] frequency_type
É a frequência com que agendar a tarefa de distribuição. frequency_type é int, e pode ser um desses valores.
Valor | Description |
---|---|
1 | Uma vez |
2 | Sob demanda |
4 | Diariamente |
8 | Semanalmente |
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 | Description |
---|---|
1 | First |
2 | Second |
4 | Terceiro |
8 | Quarto |
16 | Último |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
É a frequência com que a tarefa de distribuição deve se repetir durante o frequency_type definido. frequency_recurrence_factor é int, com um padrão de NULL.
[ @frequency_subday = ] frequency_subday
É a frequência de reagendamento durante o período definido. frequency_subday é int, e pode ser um desses valores.
Valor | Description |
---|---|
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 = ] '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 desses valores.
Valor | Descrição |
---|---|
0 | Autenticação do SQL Server |
1 | Autenticação do Windows |
[ @publisher = ] 'publisher'
Especifica um Publicador que não seja do SQL Server. publisher é sysname, com um padrão de NULL.
Observação
publisher não deve ser usado ao alterar propriedades de artigo em um SQL Server Publisher.
Valores do código de retorno
0 (sucesso) ou 1 (fracasso)
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.
Confira também
sp_addsubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
sp_helpserver (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários