sp_helpdynamicsnapshot_job (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL Managed Instance

Gibt Informationen zu Agent-Aufträgen zurück, die gefilterte Datenmomentaufnahmen generieren. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_helpdynamicsnapshot_job
    [ [ @publication = ] N'publication' ]
    [ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung. @publication ist "sysname" mit einem Standardwert %, der Informationen zu allen gefilterten Datenmomentaufnahmeaufträgen zurückgibt, die mit dem angegebenen @dynamic_snapshot_jobid und @dynamic_snapshot_jobname für alle Publikationen übereinstimmen.

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

Der Name eines gefilterten Datenmomentaufnahmeauftrags. @dynamic_snapshot_jobname ist sysname mit einem Standardwert von %, der alle dynamischen Aufträge für eine Publikation mit dem angegebenen @dynamic_snapshot_jobname zurückgibt. Wenn beim Erstellen des Auftrags kein Auftragsname explizit angegeben wurde, befindet sich der Auftragsname im Format 'dyn_' + <name of the standard snapshot job> + <GUID>.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

Ein Bezeichner für einen gefilterten Datenmomentaufnahmeauftrag. @dynamic_snapshot_jobid ist eindeutiger Bezeichner mit einem Standardwert von NULL, der alle Momentaufnahmeaufträge zurückgibt, die mit dem angegebenen @dynamic_snapshot_jobname übereinstimmen.

Resultset

Spaltenname Datentyp BESCHREIBUNG
id int Identifiziert den Auftrag für eine Momentaufnahme gefilterter Daten.
job_name sysname Name des Auftrags für eine Momentaufnahme gefilterter Daten.
job_id uniqueidentifier Identifiziert den SQL Server-Agent Auftrag beim Distributor.
dynamic_filter_login sysname Wert, der für die Auswertung der SUSER_SNAME-Funktion in einem parametrisierten Zeilenfilter verwendet wird, der für die Publikation definiert ist.
dynamic_filter_hostname sysname Wert, der für die Auswertung der HOST_NAME-Funktion in einem parametrisierten Zeilenfilter verwendet wird, der für die Publikation definiert ist.
dynamic_snapshot_location nvarchar(255) Der Pfad zu dem Ordner, aus dem die Momentaufnahmedateien gelesen werden, wenn ein parametrisierter Zeilenfilter verwendet wird.
frequency_type int Die Häufigkeit, mit der der Agent planmäßig ausgeführt wird. Die folgenden Werte sind möglich:

1 = Einmal
2 = Bei Bedarf
4 = Täglich
8 = Wöchentlich
16 = Monatlich
32 = Monatlich relativ
64 = Autostart
128 = Serie
frequency_interval int Die Tage, an denen der Agent ausgeführt wird. Die folgenden Werte sind möglich.

1 = Sonntag
2 = Montag
3 = Dienstag
4 = Mittwoch
5 = Donnerstag
6 = Freitag
7 = Samstag
8 = Tag
9 = Wochentage
10 = Wochenendtage
frequency_subday_type int Ist der Typ, der definiert, wie oft der Agent ausgeführt wird, wenn frequency_type (täglich) ist 4 und einer dieser Werte sein kann.

1 = Zur angegebenen Zeit
2 = Sekunden
4 = Minuten
8 = Stunden
frequency_subday_interval int Anzahl der Intervalle von frequency_subday_type , die zwischen der geplanten Ausführung des Agents auftreten.
frequency_relative_interval int Ist die Woche, in der der Agent in einem bestimmten Monat ausgeführt wird, wenn frequency_type (monatlich relativ) ist 32 und einer dieser Werte sein kann.

1 = Zuerst
2 = Sekunde
4 = Dritter
8 = Vierter
16 = Last
frequency_recurrence_factor int Anzahl der Wochen oder Monate zwischen der geplanten Ausführung der Momentaufnahme.
active_start_date int Datum, an dem der Agent zum ersten Mal ausgeführt werden soll, formatiert als yyyyMMdd.
active_end_date int Datum, an dem der Agent zuletzt ausgeführt werden soll, formatiert als yyyyMMdd.
active_start_time int Zeitpunkt, zu dem der Agent zum ersten Mal ausgeführt werden soll, formatiert als HHmmss.
active_end_time int Zeitpunkt, zu dem der Agent zuletzt ausgeführt werden soll, formatiert als HHmmss.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helpdynamicsnapshot_job wird in der Seriendruckreplikation verwendet.

Werden alle Standardparameterwerte verwendet, werden Informationen zu allen Aufträgen für eine Momentaufnahme partitionierter Daten für die gesamte Veröffentlichungsdatenbank zurückgegeben.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin , der db_owner festen Datenbankrolle und die Publikationszugriffsliste für die Publikation können ausgeführt werden sp_helpdynamicsnapshot_job.

Zugehöriger Inhalt