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.

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.

  Sicherheitshinweis
  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