sp_changedynamicsnapshot_job (Transact-SQL)

Ändert den Agentauftrag, der den Snapshot für ein Abonnement einer Veröffentlichung mit einem parametrisierten Zeilenfilter generiert. Diese gespeicherte Prozedur wird beim Verleger mit der 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 ein Wert vom Datentyp sysname und weist keinen Standardwert auf.

• [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
  Der Name des Snapshotauftrags, der geändert wird. dynamic_snapshot_jobname ist vom Datentyp sysname und hat den Standardwert 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 Snapshotauftrags, 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 Planung 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	Tag
  9	Arbeitstage
  10	Wochenendtage
  NULL (Standard)

• [ @frequency_subday = ] frequency_subday
  Die Häufigkeit der erneuten Planung während des definierten Zeitraumes. frequency_subday ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  1	Einmal
  2	Sekunde
  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 YYYYMMDD 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 YYYYMMDD 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 Snapshot-Agent ausgeführt wird, um mithilfe eines parametrisierten Zeilenfilters einen Snapshot für ein Abonnement zu generieren. 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 Snapshot-Agent ausgeführt wird, um mithilfe eines parametrisierten Zeilenfilters einen Snapshot für ein Abonnement zu generieren. 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

Aufgaben

Vorgehensweise: Anzeigen und Ändern von Einstellungen für die Replikationssicherheit (Replikationsprogrammierung mit Transact-SQL)

Konzepte

Snapshots für Mergeveröffentlichungen mit parametrisierten Filtern