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 = ] '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 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 o agente deve ser agendado. 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 em que o agente é executado. frequency_interval é int e pode ser um dos valores a seguir.

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 com que reagendar 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. Este parâmetro é usado quando frequency_type é definido como 32 (relativo mensal). frequency_relative_interval é int e pode ser um dos valores a seguir.

Valor	Description
1	First
2	Second
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 = ] 'job_login' É a conta do 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 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 é 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 (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.

Confira também

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