sp_changedynamicsnapshot_job (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Ändert den Agentauftrag, der die Momentaufnahme für ein Abonnement einer Veröffentlichung mit einem parametrisierten Zeilenfilter generiert. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] 'publication' Ist der Name der Publikation. Publikation ist sysname, ohne Standard.

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'Ist der Name des geänderten Momentaufnahme Auftrags. dynamic_Momentaufnahme_jobname ist "sysname" mit dem Standardwert "N'%". Wenn dynamic_Momentaufnahme_jobid angegeben ist, müssen Sie den Standardwert für dynamic_Momentaufnahme_jobname verwenden.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'Ist die ID des geänderten Momentaufnahme Auftrags. dynamic_Momentaufnahme_jobid ist eindeutiger Bezeichner mit dem Standardwert NULL. Wenn dynamic_Momentaufnahme_jobnameangegeben ist, müssen Sie den Standardwert für dynamic_Momentaufnahme_jobid verwenden.

[ @frequency_type = ] frequency_type Ist die Häufigkeit, mit der der Agent geplant werden soll. frequency_type ist int und kann einer der folgenden Werte sein:

Wert Beschreibung des Dataflows
1 Einmal
2 On-Demand-Streaming
4 Täglich
8 Wöchentlich
16 Monatlich
32 Monatlich, relativ
64 Autostart
128 Wiederkehrend
NULL (Standard)

[ @frequency_interval = ] frequency_interval Die Tage, an denen der Agent ausgeführt wird. frequency_interval ist int und kann einen der folgenden Werte aufweisen.

Wert Beschreibung des Dataflows
1 Sonntag
2 Montag
3 Dienstag
4 Mittwoch
5 Donnerstag
6 Freitag
7 Samstag
8 Tag
9 Wochentage
10 Wochenendtage
NULL (Standard)

[ @frequency_subday = ] frequency_subday Gibt an, wie oft sie während des definierten Zeitraums neu geplant werden. frequency_subday ist int und kann einer der folgenden Werte sein:

Wert Beschreibung des Dataflows
1 Einmal
2 Second
4 Minute
8 Hour
NULL (Standard)

[ @frequency_subday_interval = ] frequency_subday_interval Ist das Intervall für frequency_subday. frequency_subday_interval ist "int" mit einem Standardwert von NULL.

[ @frequency_relative_interval = ] frequency_relative_intervalIst das Datum, an dem die Merge-Agent ausgeführt wird. Dieser Parameter wird verwendet, wenn frequency_type auf 32 (monatlich relativ) festgelegt ist. frequency_relative_interval ist int und kann einer der folgenden Werte sein:

Wert Beschreibung des Dataflows
1 Vorname
2 Second
4 Drittes
8 Viertes
16 Letzte
NULL (Standard)

[ @frequency_recurrence_factor = ] frequency_recurrence_factorIst der von frequency_type verwendete Serienfaktor. frequency_recurrence_factor ist "int" mit einem Standardwert von NULL.

[ @active_start_date = ] active_start_dateIst das Datum, an dem die Merge-Agent zum ersten Mal geplant ist, formatiert als yyyyMMdd. active_start_date ist int, mit einem Standardwert von NULL.

[ @active_end_date = ] active_end_dateIst das Datum, an dem die Merge-Agent nicht mehr geplant, formatiert als yyyyMMdd. active_end_date ist int mit einem Standardwert von NULL.

[ @active_start_time_of_day = ] active_start_time_of_dayIst die Tageszeit, zu der die Merge-Agent zum ersten Mal geplant ist, formatiert als HHmmss. active_start_time_of_day ist "int" mit einem Standardwert von NULL.

[ @active_end_time_of_day = ] active_end_time_of_dayIst die Tageszeit, zu der die Merge-Agent nicht mehr geplant wird, formatiert als HHmmss. active_end_time_of_day ist int, mit einem Standardwert von NULL.

[ @job_login = ] 'job_login'Ist das Microsoft Windows-Konto, unter dem die Momentaufnahmen-Agent beim Generieren der Momentaufnahme für ein Abonnement mithilfe eines parametrisierten Zeilenfilters ausgeführt wird. job_login ist nvarchar(257), wobei der Standardwert NULL ist.

[ @job_password = ] 'job_password'Ist das Kennwort für das Windows-Konto, unter dem die Momentaufnahmen-Agent beim Generieren der Momentaufnahme für ein Abonnement mit einem parametrisierten Zeilenfilter ausgeführt wird. job_password ist nvarchar(257), wobei der Standardwert NULL ist.

Wichtig

Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changedynamicMomentaufnahme_job wird in der Seriendruckreplikation für Publikationen mit parametrisierten Zeilenfiltern verwendet.

Nach dem Ändern des Anmeldenamens oder Kennworts eines Agents müssen Sie den Agent beenden und neu starten, damit die Änderungen in Kraft treten.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder db_owner festen Datenbankrolle können sp_changedynamicMomentaufnahme_job ausgeführt werden.

Weitere Informationen

Anzeigen und Ändern von Replikationssicherheitseinstellungen
Momentaufnahmen für eine Mergeveröffentlichung mit parametrisierten Filtern