Condividi tramite


sp_changedynamicsnapshot_job (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

Consente di modificare il processo di agente che genera lo snapshot per una sottoscrizione di una pubblicazione con un filtro di riga con parametri. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_changedynamicsnapshot_job
    [ @publication = ] N'publication'
    [ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
    [ , [ @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 ]
    [ , [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

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

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

Nome del processo di snapshot da modificare. @dynamic_snapshot_jobname è sysname, con il valore predefinito %.

Se si specifica @dynamic_snapshot_jobid , è necessario usare il valore predefinito per @dynamic_snapshot_jobname.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

ID del processo di snapshot da modificare. @dynamic_snapshot_jobid è uniqueidentifier, con un valore predefinito .NULL

Se si specifica @dynamic_snapshot_jobname , è necessario usare il valore predefinito per @dynamic_snapshot_jobid.

[ @frequency_type = ] frequency_type

Specifica la frequenza con cui pianificare l'agente. @frequency_type è int e può essere uno dei valori seguenti.

valore Descrizione
1 Singola occorrenza
2 Su richiesta
4 Ogni giorno
8 Settimanale
16 Mensile
32 Mensile relativa
64 Avvio automatico
128 Ricorrente
NULL (predefinito)

[ @frequency_interval = ] frequency_interval

Giorni in cui viene eseguito l'agente. @frequency_interval è int e può essere uno dei valori seguenti.

valore Descrizione
1 Domenica
2 lunedì
3 Martedì
4 mercoledì
5 giovedì
6 Venerdì
7 Sabato
8 Giornaliera
9 Giorni feriali
10 Giorni festivi
NULL (predefinito)

[ @frequency_subday = ] frequency_subday

Specifica la frequenza con cui riprogrammare durante il periodo definito. @frequency_subday è int e può essere uno dei valori seguenti.

valore Descrizione
1 Una sola volta
2 Secondo
4 Minute
8 Ora
NULL (predefinito)

[ @frequency_subday_interval = ] frequency_subday_interval

Intervallo per @frequency_subday. @frequency_subday_interval è int, con il valore predefinito NULL.

[ @frequency_relative_interval = ] frequency_relative_interval

Data di esecuzione del agente di merge. Questo parametro viene usato quando @frequency_type è impostato su 32 (relativo mensile). @frequency_relative_interval è int e può essere uno dei valori seguenti.

valore Descrizione
1 First
2 Secondo
4 Terza
8 Quarta
16 Last
NULL (predefinito)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Fattore di ricorrenza utilizzato da @frequency_type. @frequency_recurrence_factor è int, con un valore predefinito .NULL

[ @active_start_date = ] active_start_date

Data in cui il agente di merge viene pianificato per la prima volta, formattato come yyyyMMdd. @active_start_date è int, con un valore predefinito .NULL

[ @active_end_date = ] active_end_date

Data in cui il agente di merge smette di essere pianificato, formattato come yyyyMMdd. @active_end_date è int, con un valore predefinito .NULL

[ @active_start_time_of_day = ] active_start_time_of_day

Ora del giorno in cui il agente di merge viene pianificato per la prima volta, formattato come HHmmss. @active_start_time_of_day è int, con il valore predefinito NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Ora del giorno in cui il agente di merge smette di essere pianificato, formattato come HHmmss. @active_end_time_of_day è int, con il valore predefinito .NULL

[ @job_login = ] N'job_login'

Account di Windows con cui viene eseguito il agente di snapshot durante la generazione dello snapshot per una sottoscrizione usando un filtro di riga con parametri. @job_login è nvarchar(257), con il valore predefinito NULL.

[ @job_password = ] N'job_password'

Password per l'account di Windows con cui viene eseguita la agente di snapshot durante la generazione dello snapshot per una sottoscrizione usando un filtro di riga con parametri. @job_password è sysname, con il valore predefinito NULL.

Importante

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.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_changedynamicsnapshot_job viene utilizzato nella replica di tipo merge per le pubblicazioni con filtri di riga con parametri.

Dopo la modifica dell'account di accesso o della password di un agente, è necessario arrestare e riavviare l'agente per rendere effettiva la modifica.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin o db_owner ruolo predefinito del database possono eseguire sp_changedynamicsnapshot_job.