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 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 ulteriori informazioni, vedere Abilitazione di connessioni crittografate al Motore di database (Gestione configurazione SQL Server).

Convenzioni della 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 è 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. 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
  Specifica i 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
  Unità di freq_subday_interval. 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 snapshot. frequency_relative_interval è di tipo int e il valore predefinito è NULL.

• [ @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 snapshot, nel formato YYYYMMDD. 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 YYYYMMDD. 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 dell'agente snapshot esistente se viene utilizzato un processo esistente. snapshot_agent_name è nvarchar(100) e il valore predefinito è NULL.

• [ @publisher_security_mode = ] publisher_security_mode
  Modalità di sicurezza 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. Per server di pubblicazione non SQL Server è necessario specificare il valore 0.

  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. publisher_login deve essere specificato quando 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 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 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 dell'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 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 è 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.

Vedere anche

Riferimento

sp_addpublication_snapshot (Transact-SQL)

Stored procedure di sistema (Transact-SQL)

Concetti

Visualizzazione e modifica delle proprietà della pubblicazione

Modifica delle proprietà di pubblicazioni e articoli