sys.sp_changedynamicsnapshot_job (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Modifica o job agente que gera o snapshot para uma subscrição de uma publicação com um filtro de linha parametrizado. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Transact-SQL convenções de sintaxe

Syntax

sys.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' ]
[ ; ]

Arguments

[ @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 snapshot está a ser alterado. @dynamic_snapshot_jobname é sysname, com um padrão de %.

Se @dynamic_snapshot_jobid for especificado, deve usar o valor padrão para @dynamic_snapshot_jobname.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

O ID do trabalho snapshot a ser alterado. @dynamic_snapshot_jobid é um identificador único, com um padrão de NULL.

Se @dynamic_snapshot_jobname for especificado, deve usar o valor padrão para @dynamic_snapshot_jobid.

[ @frequency_type = ] frequency_type

Especifica a frequência com que agendar o agente. @frequency_type é int, e pode ser um dos seguintes valores.

Value Descrição
1 Uma vez
2 A pedido
4 Diariamente
8 Semanalmente
16 Monthly
32 Parente mensal
64 Arranque automático
128 Recorrente
NULL (padrão)

[ @frequency_interval = ] frequency_interval

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

Value Descrição
1 Domingo
2 Segunda-feira
3 Tuesday
4 Quarta-feira
5 Quinta-feira
6 Sexta-feira
7 Sábado
8 Dia
9 Dias úteis
10 Dias de fim de semana
NULL (padrão)

[ @frequency_subday = ] frequency_subday

Especifica com que frequência reagendar durante o período definido. @frequency_subday é int, e pode ser um dos seguintes valores.

Value 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. Este parâmetro é usado quando @frequency_type está definido como 32 (relativo mensal). @frequency_relative_interval é int, e pode ser um dos seguintes valores.

Value Descrição
1 First
2 Second
4 Third
8 Fourth
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, 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 agendada, 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 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, formatada como HHmmss. @active_end_time_of_day é int, com um padrão de NULL.

[ @job_login = ] N'job_login'

A conta Windows sob a qual o Snapshot Agent é executado ao gerar o snapshot para uma subscrição usando um filtro de linhas parametrizado. @job_login é nvarchar(257), com um padrão de NULL.

[ @job_password = ] N'job_password'

A palavra-passe da Conta Windows sob a qual o Snapshot Agent é executado ao gerar o snapshot para uma subscrição usando um filtro de linhas parametrizado. @job_password é sysname, com um padrão de NULL.

Importante

Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais em um arquivo de script, deverá proteger o arquivo para impedir o acesso não autorizado.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

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

Após alterar o login ou a palavra-passe do agente, deve parar e reiniciar o agente antes que a alteração entre em vigor.

Permissões

Apenas os membros do papel fixo de servidor administrador do sistema ou db_owner papel fixo de base de dados podem executar sp_changedynamicsnapshot_job.