Freigeben über


sp_helpdynamicsnapshot_job (Transact-SQL)

Gibt Informationen zu Agent-Aufträgen zurück, die gefilterte Datenmomentaufnahmen generieren. Diese gespeicherte Prozedur wird auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @publication = ] 'publication'
    Der Name der Veröffentlichung. publication ist vom Datentyp sysname. Der Datentyp ist %. Mit diesem werden Informationen zu allen Aufträgen für eine Momentaufnahme gefilterter Daten zurückgegeben, die mit den angegebenen Werten für dynamic_snapshot_jobidund dynamic_snapshot_jobnamefür alle Veröffentlichungen übereinstimmen.

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    Der Name eines Auftrags für eine Momentaufnahme gefilterter Daten. dynamic_snapshot_jobnameist vom Datentyp sysname. Der Standardwert ist %. Mit diesem werden alle dynamischen Aufträge für eine Veröffentlichung mit der angegebenen dynamic_snapshot_jobid zurückgegeben. Wenn beim Erstellen des Auftrags kein expliziter Auftragsname angegeben wurde, hat der Auftragsname folgendes Format:

    'dyn_' + <name of the standard snapshot job> + <GUID>
    
  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    Ein Bezeichner eines Auftrags für eine Momentaufnahme gefilterter Daten. dynamic_snapshot_jobidist vom Datentyp uniqueidentifier. Mit dem Standardwert NULL werden alle Momentaufnahmeaufträge zurückgegeben, die mit dem angegebenen dynamic_snapshot_jobname übereinstimmen.

Resultsets

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 Auftrag des Microsoft SQL Server-Agents auf dem Verteiler.

dynamic_filter_login

sysname

Der Wert, der zum Auswerten der SUSER_SNAME-Funktion in einem parametrisierten, für die Veröffentlichung definierten Zeilenfilter verwendet wird.

dynamic_filter_hostname

sysname

Der Wert, der zum Auswerten der HOST_NAME-Funktion in einem parametrisierten, für die Veröffentlichung definierten Zeilenfilter verwendet wird.

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 = Einmalige Ausführung

2 = Nach Bedarf

4 = Täglich

8 = Wöchentlich

16 = Monatlich

32 = Mit relativem Monatsintervall

64 = Autostart

128 = Wiederholt

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 = Arbeitstage

10 = Wochenendtage

frequency_subday_type

int

Der Typ, der definiert, wie häufig der Agent ausgeführt wird, wenn frequency_type auf 4 (täglich) festgelegt ist. Die folgenden Werte sind möglich:

1 = Zum angegebenen Zeitpunkt

2 = Sekunden

4 = Minuten

8 = Stunden

frequency_subday_interval

int

Anzahl der Intervalle von frequency_subday_type, die zwischen der geplanten Ausführung der Momentaufnahme auftreten.

frequency_relative_interval

int

Die Woche, in der der Agent in einem bestimmten Monat ausgeführt wird, wenn frequency_type auf 32 (mit relativem Monatsintervall) festgelegt ist. Die folgenden Werte sind möglich:

1 = Erster

2 = Zweiter

4 = Dritter

8 = Vierter

16 = Letzter

frequency_recurrence_factor

int

Anzahl der Wochen oder Monate zwischen der geplanten Ausführung der Momentaufnahme.

active_start_date

int

Datum, an dem die Ausführung der Momentaufnahme zum ersten Mal geplant ist (Format: YYYYMMDD).

active_end_date

int

Datum, an dem die Ausführung der Momentaufnahme zum letzten Mal geplant ist (Format: YYYYMMDD).

active_start_time

int

Uhrzeit, zu der die Ausführung der Momentaufnahme zum ersten Mal geplant ist (Format: HHMMSS).

active_end_time

int

Uhrzeit, zu der die Ausführung der Momentaufnahme zum letzten Mal geplant ist (Format: HHMMSS).

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpdynamicsnapshot_job wird in der Mergereplikation 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 festen Datenbankrolle db_owner und der Veröffentlichungszugriffsliste für die Veröffentlichung können sp_helpdynamicsnapshot_job ausführen.

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)