sp_changedynamicsnapshot_job (Transact-SQL)

Aplica-se a:SQL ServerInstâ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 = ] '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 snapshot que está sendo alterado. dynamic_snapshot_jobname é sysname, com valor padrão de N'%'. 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 valor padrão de NULL. Se dynamic_snapshot_jobnamefor especificado, você deverá usar o valor padrão para dynamic_snapshot_jobid.

[ @frequency_type = ] frequency_type É a frequência com que agendar o agente. frequency_type é int e pode ser um dos seguintes 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
NULL (padrão)

[ @frequency_interval = ] frequency_interval Os dias que o agente corre. frequency_interval é int e pode ser um dos seguintes valores.

Valor	Description
1	Sunday
2	Monday
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 frequência de reagendamento durante o período definido. frequency_subday é int e pode ser um dos seguintes valores.

Valor	Description
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	Description
1	First
2	Second
4	Terceiro
8	Quarto
16	Último
NULL (padrão)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor É o fator de recorrência utilizado 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 para de ser agendado, formatado como HHmmss. active_end_time_of_day é int, com um padrão de NULL.

[ @job_login = ] 'job_login' É a conta do Microsoft Windows sob a qual o Snapshot Agent é executado ao gerar o instantâneo para uma assinatura usando um filtro de linha parametrizado. job_login é nvarchar(257), com um valor padrão de NULL.

[ @job_password = ] '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 parametrizado. job_password é nvarchar(257), com um valor 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 (fracasso)

Comentários

sp_changedynamicsnapshot_job é usado na replicação de mesclagem para publicações com filtros de linha parametrizados.

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.

Confira também

Exibir e modificar configurações de segurança de replicação
Instantâneos para publicações de mesclagem com filtros parametrizados