sp_changedynamicsnapshot_job (Transact-SQL)

Consente di modificare il processo di agente che genera lo snapshot per una sottoscrizione di una pubblicazione con un filtro di riga con parametri. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Convenzioni della sintassi Transact-SQL

Sintassi

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' ] 

Argomenti

• [ @publication = ] 'publication'
  Nome della pubblicazione. publication è di tipo sysname e non prevede alcun valore predefinito.

• [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
  Nome del processo di snapshot da modificare. dynamic_snapshot_jobnameis sysname e il valore predefinito è N'%'. Se si specifica dynamic_snapshot_jobid, è necessario utilizzare il valore predefinito per dynamic_snapshot_jobname.

• [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
  ID del processo di snapshot da modificare. dynamic_snapshot_jobid è di tipo uniqueidentifier e il valore predefinito è NULL. Se si specifica dynamic_snapshot_jobname,è necessario utilizzare il valore predefinito per dynamic_snapshot_jobid.

• [ @frequency_type = ] frequency_type
  Frequenza per l'esecuzione pianificata dell'agente. frequency_type è di tipo int. I valori possibili sono i seguenti.

  Valore	Descrizione
  1	Una volta
  2	Su richiesta
  4	Giornaliera
  8	Settimanale
  16	Mensile
  32	Mensile relativa
  64	Avvio automatico
  128	Periodica
  NULL (predefinito)

• [ @frequency_interval = ] frequency_interval
  Giorni in cui viene eseguito l'agente. frequency_interval è di tipo int. I valori possibili sono i seguenti.

  Valore	Descrizione
  1	Domenica
  2	Lunedì
  3	Martedì
  4	Mercoledì
  5	Giovedì
  6	Venerdì
  7	Sabato
  8	Giorno
  9	Giorni feriali
  10	Giorni festivi
  NULL (predefinito)

• [ @frequency_subday = ] frequency_subday
  Frequenza di ripianificazione durante il periodo definito. frequency_subday è di tipo int. I valori possibili sono i seguenti.

  Valore	Descrizione
  1	Una volta sola
  2	Secondo
  4	Minuto
  8	Ora
  NULL (predefinito)

• [ @frequency_subday_interval = ] frequency_subday_interval
  Intervallo per frequency_subday. frequency_subday_interval è di tipo int e il valore predefinito è NULL.

• [ @frequency_relative_interval = ] frequency_relative_interval
  Data di esecuzione dell'agente di merge. Questo parametro viene utilizzato quando frequency_type è impostato su 32 (mensile relativa). frequency_relative_interval è di tipo int. I valori possibili sono i seguenti.

  Valore	Descrizione
  1	Primo
  2	Secondo
  4	Terzo
  8	Quarto
  16	Ultimo
  NULL (predefinito)

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  Fattore di occorrenza utilizzato da frequency_type. frequency_recurrence_factor è di tipo int e il valore predefinito è NULL.

• [ @active_start_date = ] active_start_date
  Data della prima esecuzione pianificata dell'agente di merge, nel formato AAAAMMGG. active_start_date è di tipo int e il valore predefinito è NULL.

• [ @active_end_date = ] active_end_date
  Data dell'ultima esecuzione pianificata dell'agente di merge, nel formato AAAAMMGG. active_end_date è di tipo int e il valore predefinito è NULL.

• [ @active_start_time_of_day = ] active_start_time_of_day
  Ora del giorno della prima esecuzione pianificata dell'agente di merge, nel formato HHMMSS. active_start_time_of_day è di tipo int e il valore predefinito è NULL.

• [ @active_end_time_of_day = ] active_end_time_of_day
  Ora del giorno dell'ultima esecuzione pianificata dell'agente di merge, nel formato HHMMSS. active_end_time_of_day è di tipo int e il valore predefinito è NULL.

• [ @job_login= ] 'job_login'
  Account di Microsoft Windows utilizzato per l'esecuzione dell'agente snapshot durante la generazione dello snapshot per una sottoscrizione con un filtro di riga con parametri. job_login è di tipo nvarchar(257) e il valore predefinito è NULL.

• [ @job_password= ] 'job_password'
  Password dell'account di Windows utilizzato per l'esecuzione dell'agente snapshot durante la generazione dello snapshot per una sottoscrizione con un filtro di riga con parametri. job_password è di tipo nvarchar(257) e il valore predefinito è NULL.

  Nota sulla sicurezza
  Se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione. Se è necessario archiviare le credenziali in un file script, è fondamentale proteggere il file per evitare accessi non autorizzati.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_changedynamicsnapshot_job viene utilizzata per la replica di tipo merge di pubblicazioni con filtri di riga con parametri.

Dopo la modifica dell'account di accesso o della password di un agente, è necessario arrestare e riavviare l'agente per rendere effettiva la modifica.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin o del ruolo predefinito del database db_owner possono eseguire sp_changedynamicsnapshot_job.

Vedere anche

Concetti

Visualizzazione e modifica delle impostazioni di sicurezza della replica

Snapshot per pubblicazioni di tipo merge con filtri con parametri