sp_changedynamicsnapshot_job (Transact-SQL)

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 de publicação.

Convenções de sintaxe 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 é alterado. dynamic_snapshot_jobname é sysname, com valor padrão de N'% '. Se dynamic_snapshot_jobid for especificado, você deve 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 valor padrão de NULL. Se dynamic_snapshot_jobnamefor especificado, você deve usar o valor padrão para dynamic_snapshot_jobid.

• [ @frequency_type = ] frequency_type
  É a freqüência de agendamento do agente. frequency_type é int, e pode ser um dos valores a seguir.

  Valor	Descrição
  1	Uma vez
  2	Sob demanda
  4	Diariamente
  8	Semanalmente
  16	Mensalmente
  32	Relativo ao mês
  64	Iniciar automaticamente
  128	Recorrente
  NULL (padrão)

• [ @frequency_interval = ] frequency_interval
  Os dias de execução do agente. frequency_interval é int, e pode ser um dos valores a seguir.

  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
  É a freqüência de reagendamento durante o período definido. frequency_subday é inte pode ser um dos valores a seguir.

  Valor	Descrição
  1	Uma vez
  2	Segundo
  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 de execução do Merge Agent. É o parâmetro usado quando frequency_type é definido como 32 (relativo ao mês). frequency_relative_interval é int, e pode ser um dos valores a seguir.

  Valor	Descrição
  1	Primeiro
  2	Segundo
  4	Terceiro
  8	Quarto
  16	Último
  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 do primeiro agendamento do Merge Agent, 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 agendado, 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 do primeiro agendamento do Merge Agent, formatada 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= ] 'job_login'
  É a conta 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 para 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_password é nvarchar(257), com um valor padrão de NULL.

  Observação sobre segurança
  Quando possível, solicite aos usuários que 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 de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_changedynamicsnapshot_job é usado em 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, é necessário interromper e reiniciar o agente para que a alteração entre em vigor.

Permissões

Somente membros da função de servidor fixa sysadmin ou db_owner podem executar sp_changedynamicsnapshot_job.

Consulte também

Tarefas

Como exibir e modificar propriedades de segurança de replicação (Programação Transact-SQL de replicação)

Conceitos

Instantâneos para publicações de mesclagem com filtros com parâmetros