sp_changepublication_snapshot (Transact-SQL)
Modifica le proprietà dell'agente snapshot per la pubblicazione specificata. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.
Nota sulla sicurezza |
---|
Quando si configura un server di distribuzione remoto per un server di pubblicazione, i valori specificati per tutti i parametri, inclusi job_login e job_password, vengono inviati al server di distribuzione come testo normale. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure. Per ulteriori informazioni, vedere Crittografia delle connessioni a SQL Server. |
Sintassi
sp_changepublication_snapshot [ @publication= ] 'publication'
[ , [ @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 ]
[ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] 'publisher_login' ]
[ , [ @publisher_password = ] 'publisher_password' ]
[ , [ @job_login = ] 'job_login' ]
[ , [ @job_password = ] 'job_password' ]
[ , [ @publisher = ] 'publisher' ]
Argomenti
[ [ @publication =] 'publication'
Nome della pubblicazione. publication è di tipo sysname e non prevede alcun valore predefinito.[ [ @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
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
Specifica i giorni in cui viene eseguito l'agente. frequency_interval è di tipo int. 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
Unità per freq_subday_interval. frequency_subday è di tipo int. 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 snapshot. frequency_relative_interval è di tipo int e il valore predefinito è NULL.[ [ @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 snapshot, 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 snapshot, 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 snapshot, 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 snapshot, nel formato HHMMSS. active_end_time_of_day è di tipo int e il valore predefinito è NULL.[ [ @snapshot_job_name = ] 'snapshot_agent_name'
Nome di un processo esistente, se utilizzato, per l'agente snapshot. snapshot_agent_name è di tipo nvarchar(100) e il valore predefinito è NULL.[ [ @publisher_security_mode = ] publisher_security_mode
Modalità di protezione utilizzata dall'agente per la connessione al server di pubblicazione. publisher_security_mode è di tipo smallint e il valore predefinito è NULL. 0 specifica l'autenticazione di SQL Server, mentre 1 specifica l'autenticazione di Windows. È necessario specificare il valore 0 per server di pubblicazione non SQL Server.Nota sulla sicurezza Se possibile, utilizzare l'autenticazione di Windows.
[ [ @publisher_login = ] 'publisher_login'
Account di accesso utilizzato per la connessione al server di pubblicazione. publisher_login è di tipo sysname e il valore predefinito è NULL. È necessario specificare publisher_login se publisher_security_mode è 0. Se publisher_login è NULL e il valore di publisher_security_mode è 1, per la connessione al server di pubblicazione viene utilizzato l'account di Windows specificato in job_login.[ [ @publisher_password = ] 'publisher_password'
Password utilizzata per la connessione al server di pubblicazione. publisher_password è di tipo sysname e il valore predefinito è NULL.Nota sulla sicurezza Non utilizzare una password vuota. Utilizzare una password complessa. 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.
[ [ @job_login = ] 'job_login'
Account di accesso per l'account di Windows utilizzato per l'esecuzione dell'agente. job_login è di tipo nvarchar(257) e il valore predefinito è NULL. Questo account di Windows viene sempre utilizzato per le connessioni dell'agente al server di distribuzione. È necessario specificare questo parametro per la creazione di un nuovo processo per l'agente snapshot. Questo valore non può essere modificato per un server di pubblicazione non SQL Server.[ [ @job_password = ] 'job_password'
Password per l'account di Windows utilizzato per l'esecuzione dell'agente. job_password è di tipo sysname e il valore predefinito è NULL. È necessario specificare questo parametro per la creazione di un nuovo processo per l'agente snapshot.Nota sulla sicurezza 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.
[ [ @publisher = ] 'publisher'
Specifica un server di pubblicazione non SQL Server. publisher è di tipo sysname e il valore predefinito è NULL.Nota
Non utilizzare publisher per la creazione di un agente snapshot in un server di pubblicazione SQL Server.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
La stored procedure sp_changepublication_snapshot viene utilizzata per la replica snapshot, transazionale e di tipo merge.
Autorizzazioni
Solo i membri del ruolo predefinito del server sysadmin o del ruolo predefinito del database db_owner possono eseguire sp_changepublication_snapshot.