sp_changedynamicsnapshot_job (Transact-SQL)
Modifica o trabalho do agente que gera o instantâneo para uma assinatura de uma publicação com um filtro de linha com parâmetros. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.
Sintaxe
sp_changedynamicsnapshot_job [ @publication = ] 'publication'
[ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
[ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @job_login = ] 'job_login' ]
[ , [ @job_password = ] 'job_password' ]
Argumentos
[ @publication = ] 'publication'
É o nome da publicação. publication é sysname, sem padrão.[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
É o nome do trabalho de instantâneo que é alterado. dynamic_snapshot_jobname é sysname, com valor padrão de N'% '. Se dynamic_snapshot_jobid for especificado, você deve usar o valor padrão para dynamic_snapshot_jobname.[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
É a ID do trabalho de instantâneo que está sendo alterado. dynamic_snapshot_jobid é uniqueidentifier, com um valor padrão de NULL. Se dynamic_snapshot_jobnamefor especificado, você deve usar o valor padrão para dynamic_snapshot_jobid.[ @frequency_type = ] frequency_type
É a freqüência de agendamento do agente. frequency_type é int, e pode ser um dos valores a seguir.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
NULL (padrão)
[ @frequency_interval = ] frequency_interval
Os dias de execução do agente. frequency_interval é int, e pode ser um dos valores a seguir.Valor
Descrição
1
Domingo
2
Segunda-feira
3
Terça-feira
4
Quarta-feira
5
Quinta-feira
6
Sexta-feira
7
Sábado
8
Dia
9
Dias da semana
10
Dias de fim de semana
NULL (padrão)
[ @frequency_subday = ] frequency_subday
É a freqüência de reagendamento durante o período definido. frequency_subday é inte pode ser um dos valores a seguir.Valor
Descrição
1
Uma vez
2
Segundo
4
Minuto
8
Hora
NULL (padrão)
[ @frequency_subday_interval = ] frequency_subday_interval
É o intervalo para frequency_subday. frequency_subday_interval é int, com um padrão de NULL.[ @frequency_relative_interval = ] frequency_relative_interval
É a data de execução do Merge Agent. É o parâmetro usado quando frequency_type é definido como 32 (relativo ao mês). frequency_relative_interval é int, e pode ser um dos valores a seguir.Valor
Descrição
1
Primeiro
2
Segundo
4
Terceiro
8
Quarto
16
Último
NULL (padrão)
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
É o fator de recorrência usado por frequency_type. frequency_recurrence_factor é int, com um padrão de NULL.[ @active_start_date = ] active_start_date
É a data do primeiro agendamento do Merge Agent, formatada como YYYYMMDD. active_start_date é int, com um padrão de NULL.[ @active_end_date = ] active_end_date
É a data em que o Merge Agent deixa de ser agendado, formatada como YYYYMMDD. active_end_date é int, com um padrão de NULL.[ @active_start_time_of_day = ] active_start_time_of_day
É a hora do dia do primeiro agendamento do Merge Agent, 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 o Merge Agent deixa de ser agendado, formatada como HHMMSS. active_end_time_of_day é int, com um padrão de NULL.[ @job_login= ] 'job_login'
É a conta Microsoft Windows na qual o Snapshot Agent é executado ao gerar o instantâneo para uma assinatura usando um filtro de linha com parâmetros. job_login é nvarchar(257), com um valor padrão de NULL.[ @job_password= ] 'job_password'
É a senha para a conta do Windows na qual o Snapshot Agent é executado ao gerar o instantâneo para uma assinatura usando um filtro de linha com parâmetros. job_password é nvarchar(257), com um valor padrão de NULL.Observação sobre segurança Quando possível, solicite aos usuários que insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_changedynamicsnapshot_job é usado em replicação de mesclagem para publicações com filtros de linha com parâmetros.
Depois de alterar o logon ou a senha de um agente, é necessário interromper e reiniciar o agente para que a alteração entre em vigor.
Permissões
Somente membros da função de servidor fixa sysadmin ou db_owner podem executar sp_changedynamicsnapshot_job.