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.

@frequency_interval [ = ] frequency_interval

Os dias em que o agente é executado. @frequency_interval é int e pode ser um dos seguintes valores.

@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.

@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.

@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.

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.

Conteúdo relacionado

• Exibir e modificar configurações de segurança de replicação
• Criar um instantâneo para uma publicação de mesclagem com filtros parametrizados