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 da 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 está sendo 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 o 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 frequê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 em que o agente é executado. 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 frequência de reagendamento durante o período definido. frequency_subday é int e 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 Agente de Mesclagem. Esse parâmetro é usado quando frequency_type está definido como 32 (mensal relativo). 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 Agente de Mesclagem, formatada como AAAAMMDD. active_start_date é int, com um padrão de NULL.

• [ @active_end_date = ] active_end_date
  É a data do último agendamento do Agente de Mesclagem, formatada como AAAAMMDD. 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 Agente de Mesclagem, 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 do último agendamento do Agente de Mesclagem, formatada 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 Agente de Instantâneo é 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 na qual o Agente de Instantâneo é 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 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 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, 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 podem executar sp_changedynamicsnapshot_job.

Consulte também

Conceitos

Exibir e modificar configurações de segurança de replicação

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