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.
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_jobnameè di tipo 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 e i possibili valori sono i seguenti.Valore
Descrizione
1
Singola occorrenza
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 e i possibili valori 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 e i possibili valori sono i seguenti.Valore
Descrizione
1
Una volta
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 (frequenza mensile relativa). frequency_relative_interval è di tipo int e i possibili valori 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 ricorrenza 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 protezione Se possibile, richiedere agli utenti di immettere le credenziali di protezione 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 interrompere 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.