Condividi tramite

sp_MSchange_snapshot_agent_properties (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Modifica le proprietà di un processo di agente di snapshot eseguito in un server di distribuzione di 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 SQL Server 2000 (8.x). La stored procedure viene eseguita nel database di distribuzione del server di distribuzione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_MSchange_snapshot_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'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 = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Argomenti

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname, senza impostazione predefinita.

[ @publisher_db = ] N'publisher_db'

Nome del database di pubblicazione. @publisher_db è sysname, senza impostazione predefinita.

[ @publication = ] N'publication'

Nome della pubblicazione. @publication è sysname, senza impostazione predefinita.

[ @frequency_type = ] frequency_type

Specifica la frequenza con cui viene eseguita la agente di snapshot. @frequency_type è int e può essere uno di questi valori.

valore Descrizione
1 Una sola volta
2 Su richiesta
4 Ogni giorno
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 è int, senza impostazione predefinita.

[ @frequency_subday = ] frequency_subday

Unità per @frequency_subday_interval. @frequency_subday è int e può essere uno di questi valori.

valore Descrizione
1 Una sola volta
2 Secondo
4 Minute
8 Ore

[ @frequency_subday_interval = ] frequency_subday_interval

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

[ @frequency_relative_interval = ] frequency_relative_interval

Data 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_date

Data 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_date

Data 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_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, senza impostazione predefinita.

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

[ @snapshot_job_name = ] N'snapshot_job_name'

Nome di un nome di processo agente di snapshot esistente se viene usato un processo esistente. @snapshot_job_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. È necessario specificare un valore per i server di 0 pubblicazione non SQL Server.

  • 0 specifica l'autenticazione di SQL Server
  • 1specifica autenticazione di Windows

Se possibile, usare l'autenticazione di Windows.

[ @publisher_login = ] N'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 viene usato per la connessione al server di pubblicazione.

[ @publisher_password = ] N'publisher_password'

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

Importante

Non archiviare le informazioni di autenticazione nei file di script. Per migliorare la sicurezza, si consiglia di specificare nomi e password di accesso in fase di esecuzione.

[ @job_login = ] N'job_login'

Account di accesso per l'account di Windows con 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. Questa proprietà non può essere modificata per un server di pubblicazione non SQL Server.

[ @job_password = ] N'job_password'

Password per l'account di Windows con 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.

Importante

Non archiviare le informazioni di autenticazione nei file di script. Per migliorare la sicurezza, si consiglia di specificare nomi e password di accesso in fase di esecuzione.

[ @publisher_type = ] N'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.

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

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.

È possibile usare sp_changepublication_snapshot nel server di pubblicazione per modificare le proprietà di un processo di agente di snapshot.

Autorizzazioni

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

Contenuto correlato