sp_MSchange_snapshot_agent_properties (Transact-SQL)

Modifica le proprietà di un processo dell'agente snapshot eseguito in un server di distribuzione MicrosoftSQL Server 2005 o versione successiva. Questa stored procedure viene utilizzata per modificare le proprietà quando il server di pubblicazione viene eseguito in un'istanza di MicrosoftSQL Server 2000. Questa stored procedure viene eseguita nel database di distribuzione del server di distribuzione.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @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_type = ] 'publisher_type'

Argomenti

• [ @publisher = ] 'publisher'
  Nome del server di pubblicazione. publisher è di tipo sysname e non prevede alcun valore predefinito.

• [ @publisher_db= ] 'publisher_db'
  Nome del database del database di pubblicazione. publisher_db è di tipo sysname e non prevede alcun valore predefinito.

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

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

  Valore	Descrizione
  1	Una volta
  2	Su richiesta
  4	Giornaliera
  8	Settimanale
  10	Mensile
  20	Mensile, in base all'intervallo di frequenza
  40	All'avvio di SQL Server Agent

• [ @frequency_interval = ] frequency_interval
  Valore da applicare alla frequenza impostata da frequency_type. frequency_interval è di tipo int e non prevede alcun valore predefinito.

• [ @frequency_subday = ] frequency_subday
  Unità di 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

• [ @frequency_subday_interval=] frequency_subday_interval
  Intervallo per l'argomento frequency_subday. frequency_subday_interval è di tipo int e non prevede alcun valore predefinito.

• [ @frequency_relative_interval = ] frequency_relative_interval
  Data di esecuzione dell'agente snapshot. frequency_relative_interval è di tipo int e non prevede alcun valore predefinito.

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  Fattore di ricorrenza utilizzato da frequency_type. frequency_recurrence_factor è di tipo int e non prevede alcun valore predefinito.

• [ @active_start_date = ] active_start_date
  Data della prima esecuzione pianificata dell'agente snapshot, nel formato YYYYMMDD. active_start_date è di tipo int e non prevede alcun valore predefinito.

• [ @active_end_date = ] active_end_date
  Data dell'ultima esecuzione pianificata dell'agente snapshot, nel formato YYYYMMDD. active_end_date è di tipo int e non prevede alcun valore predefinito.

• [ @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 non prevede alcun valore predefinito.

• [ @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 non prevede alcun valore predefinito.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Nome di un processo dell'agente snapshot esistente se viene utilizzato un processo esistente. snapshot_agent_name è di tipo nvarchar(100) e non prevede alcun valore predefinito.

• [ @publisher_security_mode= ] publisher_security_mode
  Modalità di protezione utilizzata dall'agente per la connessione al server di pubblicazione. publisher_security_mode è di tipo int e non prevede alcun valore predefinito. 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. 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 non prevede alcun valore predefinito. È necessario specificare publisher_login se publisher_security_mode è di tipo 0. Se publisher_login è NULL e il valore di *publisher_*security_mode è 1, verrà utilizzato l'account di Windows specificato in job_login per la connessione al server di pubblicazione.

• [ @publisher_password= ] 'publisher_password'
  Password utilizzata per la connessione al server di pubblicazione. publisher_password è di tipo nvarchar(524) e non prevede alcun valore predefinito.

  Nota sulla protezione
  Non archiviare informazioni di autenticazione in file script. Per migliorare la protezione, si consiglia di specificare nomi e password di accesso in fase di esecuzione.

• [ @job_login= ] 'job_login'
  Account di accesso di Windows utilizzato per l'esecuzione dell'agente. job_login è di tipo nvarchar(257) e non prevede alcun valore predefinito. 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 questo argomento per 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 non prevede alcun valore predefinito. È necessario specificare questo parametro per la creazione di un nuovo processo per l'agente snapshot.

  Nota sulla protezione
  Non archiviare informazioni di autenticazione in file script. Per migliorare la protezione, si consiglia di specificare nomi e password di accesso in fase di esecuzione.

• [ @publisher_type= ] 'publisher_type'
  Specifica il tipo di server di pubblicazione nei casi in cui il server di pubblicazione non sia in esecuzione in un'istanza di SQL Server. publisher_type è di tipo sysname. I possibili valori sono i seguenti.

  Valore	Descrizione
  MSSQLSERVER	Specifica un server di pubblicazione SQL Server.
  ORACLE	Specifica un server di pubblicazione Oracle standard.
  ORACLE GATEWAY	Specifica un server di pubblicazione Oracle Gateway.

  Per ulteriori informazioni sulle differenze tra un server di pubblicazione Oracle Publisher e un server di pubblicazione Oracle Gateway, vedere Panoramica della pubblicazione Oracle.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_MSchange_snapshot_agent_properties viene utilizzata per la replica snapshot, transazionale e di tipo merge.

In caso di esecuzione della stored procedure sp_MSchange_snapshot_agent_properties, è necessario specificare tutti i parametri. Eseguire la stored procedure sp_helppublication_snapshot per restituire le proprietà correnti del processo dell'agente snapshot.

Se il server di pubblicazione viene eseguito in un'istanza di SQL Server 2005 o versione successiva, è consigliabile utilizzare la stored procedure sp_changepublication_snapshot per modificare le proprietà di un processo dell'agente snapshot.

Autorizzazioni

Solo i membri del ruolo predefinito del database sysadmin nel server di distribuzione possono eseguire sp_MSchange_snapshot_agent_properties.

Vedere anche

Riferimento

sp_addpublication_snapshot (Transact-SQL)

Concetti

Utilizzo di più versioni di SQL Server in una topologia di replica