sp_changepublication_snapshot (Transact-SQL)

Aktualisiert: 12. Dezember 2006

Ändert Eigenschaften des Snapshot-Agents für die angegebene Publikation. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Sicherheitshinweis:

Bei der Konfiguration eines Verlegers mit einem Remoteverteiler werden die Werte, die für alle Parameter einschließlich job_login und job_password bereitgestellt werden, als Nur-Text an den Verteiler gesendet. Sie sollten die Verbindung zwischen dem Verleger und dem Remoteverteiler vor der Ausführung dieser gespeicherten Prozedur verschlüsseln. Weitere Informationen finden Sie unter Verschlüsseln von Verbindungen zu SQL Server.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changepublication_snapshot [ @publication= ] 'publication'
    [ , [ @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 ]
    [ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher = ] 'publisher' ]

Argumente

• [ @publication=] 'publication'
  Ist der Name der Publikation. publication ist vom Datentyp sysname und hat keinen Standard.

• [ @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	Wochentage
  10	Wochenendtage
  NULL (Standard)

• [ @frequency_subday=] frequency_subday
  Bezeichnet die Einheiten für freq_subday_interval. 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
  Ist das Intervall für frequency_subday. frequency_subday_interval ist vom Datentyp int; der Standard ist NULL.

• [ @frequency_relative_interval=] frequency_relative_interval
  Ist das Datum, an dem der Snapshot-Agent ausgeführt wird. frequency_relative_interval ist vom Datentyp int; der Standard ist NULL.

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  Ist der von frequency_type verwendete Wiederholungsfaktor. frequency_recurrence_factor ist vom Datentyp int; der Standard ist NULL.

• [ @active_start_date=] active_start_date
  Ist das Datum, an dem der Snapshot-Agent zum ersten Mal geplant ist. Dabei wird das Format YYYYMMDD verwendet. active_start_date ist vom Datentyp int; der Standard ist NULL.

• [ @active_end_date=] active_end_date
  Ist das Datum, an dem der Snapshot-Agent beendet werden soll. Dabei wird das Format YYYYMMDD verwendet. active_end_date ist vom Datentyp int; der Standard ist NULL.

• [ @active_start_time_of_day=] active_start_time_of_day
  Ist der Zeitpunkt, zu dem der Snapshot-Agent zum ersten Mal geplant ist. Dabei wird das Format HHMMSS verwendet. active_start_time_of_day ist vom Datentyp int; der Standard ist NULL.

• [ @active_end_time_of_day=] active_end_time_of_day
  Ist der Zeitpunkt, zu dem der Snapshot-Agent beendet werden soll. Dabei wird das Format HHMMSS verwendet. active_end_time_of_day ist vom Datentyp int; der Standard ist NULL.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Ist der Name eines bestehenden Snapshot-Agent-Auftrags, wenn ein vorhandener Auftrag verwendet wird. snapshot_agent_name ist vom Datentyp nvarchar(100); der Standard ist NULL.

• [ @publisher_security_mode= ] publisher_security_mode
  Ist der vom Agent zum Herstellen einer Verbindung mit dem Verleger verwendete Sicherheitsmodus. publisher_security_mode ist vom Datentyp smallint; der Standard ist NULL. 0 gibt die SQL Server-Authentifizierung und 1 die Windows-Authentifizierung an. Bei Nicht-SQL Server-Verlegern muss der Wert 0 angegeben werden.

  Sicherheitshinweis:
  Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

• [ @publisher_login= ] 'publisher_login'
  Ist der zum Herstellen einer Verbindung mit dem Verleger verwendete Anmeldename. publisher_login ist vom Datentyp sysname; der Standard ist NULL. publisher_login muss angegeben werden, wenn publisher_security_mode gleich 0 ist. Wenn publisher_login gleich NULL und publisher_security_mode gleich 1 ist, wird das in job_login angegebene Windows-Konto zum Herstellen einer Verbindung mit dem Verleger verwendet.

• [ @publisher_password= ] 'publisher_password'
  Ist das zum Herstellen einer Verbindung mit dem Verleger verwendete Kennwort. publisher_password ist vom Datentyp sysname; der Standard ist NULL.

  Sicherheitshinweis:
  Lassen Sie das Kennwortfeld nicht leer. Verwenden Sie ein sicheres Kennwort. Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Sicherheitsanmeldeinformationen zur Laufzeit anzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, müssen Sie die Datei an einem sicheren Ort speichern, um den unberechtigten Zugriff zu vermeiden.

• [ @job_login= ] 'job_login'
  Ist der Anmeldename für das Windows-Konto, unter dem der Agent ausgeführt wird. job_login ist vom Datentyp nvarchar(257); der Standard ist NULL. Dieses Windows-Konto wird immer für Agentverbindungen mit dem Verteiler verwendet. Beim Erstellen eines neuen Snapshot-Agent-Auftrags müssen Sie diesen Parameter bereitstellen. Dies kann bei einem Nicht-SQL ServerVerleger nicht geändert werden.

• [ @job_password= ] 'job_password'
  Ist das Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird. job_password ist vom Datentyp sysname; der Standard ist NULL. Beim Erstellen eines neuen Snapshot-Agent-Auftrags müssen Sie diesen Parameter bereitstellen.

  Sicherheitshinweis:
  Sofern möglich, sollten Benutzer zur Eingabe der Sicherheitsanmeldeinformationen während der Laufzeit aufgefordert werden. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, müssen Sie die Datei an einem sicheren Ort speichern, um den unberechtigten Zugriff zu vermeiden.

• [ @publisher = ] 'publisher'
  Gibt einen Nicht-SQL Server-Verleger an. publisher ist vom Datentyp sysname; der Standard ist NULL.

  Hinweis:
  publisher sollte nicht verwendet werden, wenn ein Snapshot-Agent auf einem SQL Server-Verleger erstellt wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changepublication_snapshot wird bei der Snapshot-, Transaktions- und Mergereplikation verwendet.

Berechtigungen

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

Siehe auch

Verweis

sp_addpublication_snapshot (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Andere Ressourcen

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Ändern von Publikations- und Artikeleigenschaften

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
12. Dezember 2006	Aktualisierter Inhalt: Die Informationen zu den Parametern @frequency_type und @frequency_interval wurden aktualisiert.