sp_MSchange_snapshot_agent_properties (Transact-SQL)

Modifica le proprietà di un processo dell'agente snapshot eseguito in un server di distribuzione di Microsoft SQL Server 2005. Questa stored procedure viene utilizzata per modificare le proprietà di SQL Server 2005 quando il server di pubblicazione viene eseguito in un'istanza di Microsoft SQL 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 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à per l'argomento 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.

• [ @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 è 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 una protezione ottimale, i nomi e le password degli account di accesso dovrebbero essere passati 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 una protezione ottimale, i nomi e le password degli account di accesso dovrebbero essere passati in fase di esecuzione.

• [ @publisher_type= ] 'publisher_type'
  Specifica il tipo di server di pubblicazione se il server di pubblicazione non è 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.

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, è 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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

sp_addpublication_snapshot (Transact-SQL)

Altre risorse

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

Guida in linea e informazioni

Assistenza su SQL Server 2005