Freigeben über


sp_changedynamicsnapshot_job (Transact-SQL)

Ändert den Agentauftrag, der die Momentaufnahme für ein Abonnement einer Veröffentlichung mit einem parametrisierten Zeilenfilter generiert. Diese gespeicherte Prozedur wird auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt.

Themenlink (Symbol) 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'
    Der Name der Veröffentlichung. publication ist vom Datentyp sysname und hat keinen Standardwert.

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    Der Name des Momentaufnahmeauftrags, der geändert wird. dynamic_snapshot_jobnameist vom Datentyp sysname. Der Standardwert ist N'%'. Wenn dynamic_snapshot_jobid angegeben wird, muss der Standardwert für dynamic_snapshot_jobname verwendet werden.

  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    Die ID des Momentaufnahmeauftrags, der geändert wird. dynamic_snapshot_jobid ist vom Datentyp uniqueidentifier und hat den Standardwert NULL. Wenn dynamic_snapshot_jobname angegeben wird, muss der Standardwert für dynamic_snapshot_jobid verwendet werden.

  • [ @frequency_type = ] frequency_type
    Die Häufigkeit für die Zeitplanung des Agents. frequency_type ist vom Datentyp int. Die folgenden Werte sind möglich:

    Wert

    Beschreibung

    1

    Einmal

    2

    Bedarfsgesteuert

    4

    Täglich

    8

    Wöchentlich

    16

    Monatlich

    32

    Monatlich, relativ

    64

    Autostart

    128

    Wiederholt

    NULL (Standard)

     

  • [ @frequency_interval = ] frequency_interval
    Die Tage, an denen der Agent ausgeführt wird. frequency_interval ist vom Datentyp int. Die folgenden Werte sind möglich:

    Wert

    Beschreibung

    1

    Sonntag

    2

    Montag

    3

    Dienstag

    4

    Mittwoch

    5

    Donnerstag

    6

    Freitag

    7

    Samstag

    8

    Day

    9

    Arbeitstage

    10

    Wochenendtage

    NULL (Standard)

     

  • [ @frequency_subday = ] frequency_subday
    Die Häufigkeit für die erneute geplante Ausführung während des definierten Zeitraums. frequency_subday ist vom Datentyp int. Die folgenden Werte sind möglich:

    Wert

    Beschreibung

    1

    Einmal

    2

    Zweimal

    4

    Minute

    8

    Stunde

    NULL (Standard)

     

  • [ @frequency_subday_interval = ] frequency_subday_interval
    Das Intervall für frequency_subday. frequency_subday_interval ist vom Datentyp int und hat den Standardwert NULL.

  • [ @frequency_relative_interval = ] frequency_relative_interval
    Das Datum, an dem der Merge-Agent ausgeführt wird. Dieser Parameter wird verwendet, wenn frequency_type auf 32 (monatlich, relativ) festgelegt wird. frequency_relative_interval ist vom Datentyp int. Die folgenden Werte sind möglich:

    Wert

    Beschreibung

    1

    Erster

    2

    Zweiter

    4

    Dritter

    8

    Vierter

    16

    Letzter

    NULL (Standard)

     

  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    Der von frequency_type verwendete Wiederholungsfaktor. frequency_recurrence_factor ist vom Datentyp int und hat den Standardwert NULL.

  • [ @active_start_date = ] active_start_date
    Das Datum, an dem der Merge-Agent zum ersten Mal geplant ist. Dabei wird das Format JJJJMMTT verwendet. active_start_date ist vom Datentyp int und hat den Standardwert NULL.

  • [ @active_end_date = ] active_end_date
    Das Datum, ab dem der Merge-Agent nicht mehr geplant ist. Dabei wird das Format JJJJMMTT verwendet. active_end_date ist vom Datentyp int und hat den Standardwert NULL.

  • [ @active_start_time_of_day = ] active_start_time_of_day
    Die Tageszeit, zu der der Merge-Agent zum ersten Mal geplant ist. Dabei wird das Format HHMMSS verwendet. active_start_time_of_day ist vom Datentyp int und hat den Standardwert NULL.

  • [ @active_end_time_of_day = ] active_end_time_of_day
    Die Tageszeit, ab der der Merge-Agent nicht mehr geplant ist. Dabei wird das Format HHMMSS verwendet. active_end_time_of_day ist vom Datentyp int und hat den Standardwert NULL.

  • [ @job_login= ] 'job_login'
    Das Microsoft Windows-Konto, unter dem der Momentaufnahme-Agent ausgeführt wird, wenn mit einem parametrisierten Zeilenfilter die Momentaufnahme für ein Abonnement generiert wird. job_login ist vom Datentyp nvarchar(257) und hat den Standardwert NULL.

  • [ @job_password= ] 'job_password'
    Das Kennwort für das Windows-Konto, unter dem der Momentaufnahme-Agent ausgeführt wird, wenn mit einem parametrisierten Zeilenfilter die Momentaufnahme für ein Abonnement generiert wird. job_password ist vom Datentyp nvarchar(257) und hat den Standardwert NULL.

    SicherheitshinweisSicherheitshinweis

    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_changedynamicsnapshot_job wird bei der Mergereplikation für Veröffentlichungen mit parametrisierten Zeilenfiltern verwendet.

Nach dem Ändern des Anmeldenamens oder Kennworts für einen Agent müssen Sie den Agent beenden und neu starten, damit die Änderungen wirksam werden.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_changedynamicsnapshot_job ausführen.

Siehe auch

Konzepte

Anzeigen und Ändern von Replikationssicherheitseinstellungen

Momentaufnahmen für Mergeveröffentlichungen mit parametrisierten Filtern