sp_MSchange_snapshot_agent_properties (Transact-SQL)

Si applica a:SQL Server

Modifica le proprietà di un processo agente di snapshot eseguito in un server di distribuzione di Microsoft SQL Server 2005 (9.x) o versione successiva. Questa stored procedure viene utilizzata per modificare le proprietà quando il server di pubblicazione viene eseguito in un'istanza di Microsoft SQL Server 2000 (8.x). La stored procedure viene eseguita nel database di distribuzione del server di distribuzione.

Convenzioni di 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 è sysname, senza impostazione predefinita.

[ @publisher_db = ] 'publisher_db' Nome del database di pubblicazione. publisher_db è sysname, senza impostazione predefinita.

[ @publication = ] 'publication' Nome della pubblicazione. publication è sysname, senza impostazione predefinita.

[ @frequency_type = ] frequency_typeFrequenza con cui viene eseguita la agente di snapshot. frequency_type è int e può essere uno di questi valori.

[ @frequency_interval = ] frequency_interval Valore da applicare alla frequenza impostata da frequency_type. frequency_interval è int, senza impostazione predefinita.

[ @frequency_subday = ] frequency_subday Unità per freq_subday_interval. frequency_subday è int e può essere uno di questi valori.

[ @frequency_subday_interval = ] frequency_subday_interval Intervallo per frequency_subday. frequency_subday_interval è int, senza impostazione predefinita.

[ @frequency_relative_interval = ] frequency_relative_intervalData di esecuzione del agente di snapshot. frequency_relative_interval è int, senza impostazione predefinita.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Fattore di ricorrenza utilizzato da frequency_type. frequency_recurrence_factor è int, senza impostazione predefinita.

[ @active_start_date = ] active_start_dateData in cui il agente di snapshot viene pianificato per la prima volta, formattato come yyyyMMdd. active_start_date è int, senza impostazione predefinita.

[ @active_end_date = ] active_end_dateData in cui il agente di snapshot smette di essere pianificato, formattato come yyyyMMdd. active_end_date è int, senza impostazione predefinita.

[ @active_start_time_of_day = ] active_start_time_of_dayOra del giorno in cui il agente di snapshot viene pianificato per la prima volta, formattato come HHmmss. active_start_time_of_day è int, senza impostazione predefinita.

[ @active_end_time_of_day = ] active_end_time_of_dayOra del giorno in cui il agente di snapshot smette di essere pianificato, formattato come HHmmss. active_end_time_of_day è int, senza impostazione predefinita.

[ @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), senza impostazione predefinita.

[ @publisher_security_mode = ] publisher_security_mode Modalità di sicurezza utilizzata dall'agente durante la connessione al server di pubblicazione. publisher_security_mode è int, senza impostazione predefinita. 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. 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, senza impostazione predefinita. 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 verrà usato per la connessione al server di pubblicazione.

[ @publisher_password = ] 'publisher_password' Password utilizzata per la connessione al server di pubblicazione. publisher_password è nvarchar(524), senza impostazione predefinita.

[ @job_login = ] 'job_login' Account di accesso per l'account di Windows in cui viene eseguito l'agente. job_login è nvarchar(257), senza impostazione predefinita. 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, senza impostazione predefinita. È necessario specificare questo parametro per la creazione di un nuovo processo per l'agente snapshot.

[ @publisher_type = ] 'publisher_type' Specifica il tipo di server di pubblicazione quando il server di pubblicazione non è in esecuzione in un'istanza di SQL Server. publisher_type è sysname e può essere uno dei valori seguenti.

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

Valori del codice restituito

0 (esito positivo) o 1 (errore)

Osservazioni:

sp_MSchange_snapshot_agent_properties viene usato nella replica snapshot, nella replica transazionale e nella replica di tipo merge.

È necessario specificare tutti i parametri durante l'esecuzione di sp_MSchange_snapshot_agent_properties. Eseguire sp_helppublication_snapshot per restituire le proprietà correnti del processo di agente di snapshot.

Quando il server di pubblicazione viene eseguito in un'istanza di SQL Server 2005 (9.x) o versione successiva, è consigliabile usare sp_changepublication_snapshot per modificare le proprietà di un processo agente di snapshot.

Autorizzazioni

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

Vedi anche

sp_addpublication_snapshot (Transact-SQL)