sp_changepublication_snapshot (Transact-SQL)
Si applica a:SQL Server Istanza gestita di SQL di Azure
Modifica le proprietà dell'agente snapshot per la pubblicazione specificata. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.
Importante
Quando si configura un server di pubblicazione con un server di distribuzione remoto, 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 altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).
Convenzioni di sintassi Transact-SQL
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 è sysname, senza impostazione predefinita.
[ @frequency_type = ] frequency_type
Frequenza con cui pianificare l'agente. frequency_type è int e può essere uno dei valori seguenti.
Valore | Description |
---|---|
1 | Singola occorrenza |
2 | Su richiesta |
4 | Ogni giorno |
8 | Ogni settimana |
16 | Mensile |
32 | Mensile relativa |
64 | Avvio automatico |
128 | Ricorrente |
NULL (predefinito) |
[ @frequency_interval = ] frequency_interval
Specifica i giorni di esecuzione dell'agente. frequency_interval è int e può essere uno dei valori seguenti.
Valore | Description |
---|---|
1 | Domenica |
2 | lunedì |
3 | Martedì |
4 | mercoledì |
5 | giovedì |
6 | Venerdì |
7 | Sabato |
8 | Giornaliera |
9 | Giorni feriali |
10 | Giorni festivi |
NULL (predefinito) |
[ @frequency_subday = ] frequency_subday
Unità per freq_subday_interval. frequency_subday è int e può essere uno di questi valori.
Valore | Description |
---|---|
1 | Una sola volta |
2 | Secondo |
4 | Minute |
8 | Ore |
NULL (predefinito) |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervallo per frequency_subday. frequency_subday_interval è int, con un valore predefinito NULL.
[ @frequency_relative_interval = ] frequency_relative_interval
Data di esecuzione del agente di snapshot. frequency_relative_interval è int, con un valore predefinito NULL.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Fattore di ricorrenza utilizzato da frequency_type. frequency_recurrence_factor è int, con un valore predefinito NULL.
[ @active_start_date = ] active_start_date
Data in cui il agente di snapshot viene pianificato per la prima volta, formattato come yyyyMMdd
. active_start_date è int, con un valore predefinito NULL.
[ @active_end_date = ] active_end_date
Data in cui il agente di snapshot smette di essere pianificato, formattato come yyyyMMdd
. active_end_date è int, con valore predefinito NULL.
[ @active_start_time_of_day = ] active_start_time_of_day
Ora del giorno in cui il agente di snapshot viene pianificato per la prima volta, formattato come HHmmss
. active_start_time_of_day è int, con un valore predefinito NULL.
[ @active_end_time_of_day = ] active_end_time_of_day
Ora del giorno in cui il agente di snapshot smette di essere pianificato, formattato come HHmmss
. active_end_time_of_day è int, con un valore predefinito NULL.
[ @snapshot_job_name = ] 'snapshot_agent_name'
Nome di un nome di processo agente di snapshot esistente se viene usato un processo esistente. snapshot_agent_name è nvarchar(100) con un valore predefinito NULL.
[ @publisher_security_mode = ] publisher_security_mode
Modalità di sicurezza utilizzata dall'agente durante la connessione al server di pubblicazione. publisher_security_mode è smallint, con un valore predefinito NULL. 0 specifica l'autenticazione di SQL Server e 1 specifica l'autenticazione di Windows. È necessario specificare il valore 0 per i server di pubblicazione non SQL Server.
Importante
Se possibile, usare l'autenticazione di Windows.
[ @publisher_login = ] 'publisher_login'
Account di accesso utilizzato per la connessione al server di pubblicazione. publisher_login è sysname, con valore predefinito NULL. publisher_login deve essere specificato quando publisher_security_mode è 0. Se publisher_login è NULL e publisher_security_mode è 1, l'account di Windows specificato in job_login viene usato per la connessione al server di pubblicazione.
[ @publisher_password = ] 'publisher_password'
Password utilizzata per la connessione al server di pubblicazione. publisher_password è sysname, con valore predefinito NULL.
Importante
Non usare una password vuota. Usare una password complessa. 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.
[ @job_login = ] 'job_login'
Account di accesso per l'account di Windows in cui viene eseguito l'agente. job_login è nvarchar(257), con 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. Non è possibile modificare questa impostazione per un server di pubblicazione non SQL Server.
[ @job_password = ] 'job_password'
Password per l'account di Windows in cui viene eseguito l'agente. job_password è sysname, con valore predefinito NULL. È necessario specificare questo parametro per la creazione di un nuovo processo per l'agente snapshot.
Importante
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.
[ @publisher = ] 'publisher'
Specifica un server di pubblicazione non SQL Server. publisher è sysname, con valore predefinito NULL.
Nota
Non è consigliabile usare publisher durante la creazione di un agente di snapshot in un server di pubblicazione di SQL Server.
Valori del codice restituito
0 (esito positivo) o 1 (errore)
Osservazioni:
sp_changepublication_snapshot viene usato nella replica snapshot, nella replica transazionale e nella replica di tipo merge.
Autorizzazioni
Solo i membri del ruolo predefinito del server sysadmin o db_owner ruolo predefinito del database possono eseguire sp_changepublication_snapshot.
Vedi anche
Visualizzare e modificare le proprietà della pubblicazione
Modificare le proprietà di pubblicazioni e articoli
sp_addpublication_snapshot (Transact-SQL)
Stored procedure di sistema (Transact-SQL)
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per