sp_changedynamicsnapshot_job (Transact-SQL)
Aplica-se a: 
SQL Server Instância Gerenciada de SQL do Azure
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 publicador.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_changedynamicsnapshot_job
[ @publication = ] N'publication'
[ , [ @dynamic_snapshot_jobname = ] N'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 = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ ; ]
Argumentos
@publication [ = ] N'publicação'
O nome da publicação. @publication é sysname, sem padrão.
@dynamic_snapshot_jobname [ = ] N'dynamic_snapshot_jobname'
O nome do trabalho de instantâneo que está sendo alterado. @dynamic_snapshot_jobname é sysname, com um padrão de %.
Se @dynamic_snapshot_jobid for especificado, você deverá 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 padrão de NULL.
Se @dynamic_snapshot_jobname for especificado, você deverá usar o valor padrão para @dynamic_snapshot_jobid.
@frequency_type [ = ] frequency_type
Especifica a frequência com a qual o agente deve ser agendado. @frequency_type é int e pode ser um dos seguintes valores.
| Valor | Descrição |
|---|---|
1 |
Uma vez |
2 |
Sob demanda |
4 |
Diário |
8 |
Semanal |
16 |
Mensal |
32 |
Relativo ao mês |
64 |
Iniciar automaticamente |
128 |
Recorrente |
NULL (padrão) |
@frequency_interval [ = ] frequency_interval
Os dias em que o agente é executado. @frequency_interval é int e pode ser um dos seguintes valores.
| 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
Especifica a frequência de reprogramação durante o período definido. @frequency_subday é int e pode ser um dos valores a seguir.
| Valor | Descrição |
|---|---|
1 |
Uma vez |
2 |
Second |
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 em que o Merge Agent é executado. Esse parâmetro é usado quando @frequency_type é definido como 32 (relativo mensal). @frequency_relative_interval é int e pode ser um dos seguintes valores.
| Valor | Descrição |
|---|---|
1 |
First |
2 |
Segundo |
4 |
Terceiro |
8 |
Quarto |
16 |
Last |
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 em que o Merge Agent é agendado pela primeira vez, formatado 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, formatado 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 em que o Merge Agent é agendado pela primeira vez, formatado 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, formatado como HHmmss. @active_end_time_of_day é int, com um padrão de NULL.
@job_login [ = ] N'job_login'
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_login é nvarchar(257), com um padrão de NULL.
@job_password [ = ] N'job_password'
A senha da Conta do Windows sob a qual o Snapshot Agent é executado ao gerar o instantâneo para uma assinatura usando um filtro de linha com parâmetros. @job_password é sysname, com um padrão de NULL.
Importante
Quando possível, solicite que os usuários 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 do código de retorno
0 (sucesso) ou 1 (falha).
Comentários
sp_changedynamicsnapshot_job é usado na 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, você deve parar e reiniciar o agente antes que as alterações entrem em vigor.
Permissões
Somente membros da função de servidor fixa sysadmin ou db_owner função de banco de dados fixa podem executar sp_changedynamicsnapshot_job.