sp_changedynamicsnapshot_job (Transact-SQL)
Gilt für: 
SQL Server Azure 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 = ] 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' ]
[ ; ]
Argumente
[ @publication = ] N'Publikation'
Der Name der Veröffentlichung. @publication ist "sysname" ohne Standard.
[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'
Der Name des geänderten Momentaufnahmeauftrags. @dynamic_snapshot_jobname ist "sysname" mit der Standardeinstellung "%.
Wenn @dynamic_snapshot_jobid angegeben ist, müssen Sie den Standardwert für @dynamic_snapshot_jobname verwenden.
[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
Die ID des geänderten Momentaufnahmeauftrags. @dynamic_snapshot_jobid ist eindeutiger Bezeichner mit einem Standardwert von NULL.
Wenn @dynamic_snapshot_jobname angegeben ist, müssen Sie den Standardwert für @dynamic_snapshot_jobid verwenden.
[ @frequency_type = ] frequency_type
Gibt die Häufigkeit an, mit der der Agent geplant werden soll. @frequency_type ist int und kann einer der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
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 einer der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
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 während des definierten Zeitraums neu geplant werden soll. @frequency_subday ist int und kann einer der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
1 |
Einmal |
2 |
Second |
4 |
Minute |
8 |
Hour |
NULL (Standard) |
[ @frequency_subday_interval = ] frequency_subday_interval
Das Intervall für @frequency_subday. @frequency_subday_interval ist int, mit einem Standardwert von NULL.
[ @frequency_relative_interval = ] frequency_relative_interval
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 einen der folgenden Werte aufweisen.
| Wert | Beschreibung |
|---|---|
1 |
First |
2 |
Second |
4 |
Third |
8 |
Viertes |
16 |
Last |
NULL (Standard) |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Der von @frequency_type verwendete Serienfaktor. @frequency_recurrence_factor ist int mit einem Standardwert von NULL.
[ @active_start_date = ] active_start_date
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_date
Das Datum, an dem die Merge-Agent nicht mehr geplant wird, formatiert als yyyyMMdd. @active_end_date ist int, mit einem Standardwert von NULL.
[ @active_start_time_of_day = ] active_start_time_of_day
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_day
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 = ] N'job_login'
Das 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), mit einem Standardwert von NULL.
[ @job_password = ] N'job_password'
Das Kennwort für das Windows-Konto, unter dem die Momentaufnahmen-Agent beim Generieren der Momentaufnahme für ein Abonnement mithilfe eines parametrisierten Zeilenfilters ausgeführt wird. @job_password ist "sysname" mit der Standardeinstellung "NULL.
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 (erfolgreich) oder 1 Fehler.
Hinweise
sp_changedynamicsnapshot_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 feste Datenbankrolle können ausgeführt werden sp_changedynamicsnapshot_job.