sp_MSchange_snapshot_agent_properties (Transact-SQL)

Ändert die Eigenschaften eines Snapshot-Agent-Auftrags, der auf einem Microsoft SQL Server 2005-Verteiler ausgeführt wird. Mit dieser gespeicherten Prozedur werden die Eigenschaften von SQL Server 2005 geändert, wenn der Verleger in einer Instanz von Microsoft SQL Server 2000 ausgeführt wird. Diese gespeicherte Prozedur wird auf dem Verteiler für die Verteilungsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @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_type = ] 'publisher_type'

Argumente

• [ @publisher= ] 'publisher'
  Der Name des Verlegers. publisher ist vom Datentyp sysname und hat keinen Standardwert.

• [ @publisher_db= ] 'publisher_db'
  Der Name der Publikationsdatenbank. publisher_db ist vom Datentyp sysname und hat keinen Standardwert.

• [ @publication=] 'publication'
  Der Name der Publikation. publication ist ein Wert vom Datentyp sysname und weist keinen Standardwert auf.

• [ @frequency_type=] frequency_type
  Die Häufigkeit für die Ausführung des Snapshot-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
  10	Monatlich
  20	Monatlich, relativ zum Häufigkeitsintervall
  40	Ausführung sobald der SQL Server-Agent startet

• [ @frequency_interval=] frequency_interval
  Der Wert, der auf die durch frequency_type festgelegte Häufigkeit angewendet werden soll. frequency_interval ist vom Datentyp int und hat keinen Standardwert.

• [ @frequency_subday=] frequency_subday
  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

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

• [ @frequency_relative_interval = ] frequency_relative_interval
  Das Datum, an dem der Snapshot-Agent ausgeführt wird. frequency_relative_interval ist vom Datentyp int und hat keinen Standardwert.

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

• [ @active_start_date = ] active_start_date
  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 und hat keinen Standardwert.

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

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

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

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Der Name eines vorhandenen Snapshot-Agent-Auftrags, wenn ein vorhandener Auftrag verwendet wird. snapshot_agent_name ist vom Datentyp nvarchar(100) und hat keinen Standardwert.

• [ @publisher_security_mode= ] publisher_security_mode
  Der vom Agent beim Herstellen der Verbindung mit dem Verleger verwendete Sicherheitsmodus. publisher_security_mode ist vom Datentyp int und hat keinen Standardwert. Der Wert 0 gibt die SQL Server-Authentifizierung an und 1 die Windows-Authentifizierung. Der Wert 0 muss für Nicht-SQL Server-Verleger angegeben werden.

• [ @publisher_login= ] 'publisher_login'
  Der zum Herstellen der Verbindung mit dem Verleger verwendete Anmeldename. publisher_login ist vom Datentyp sysname und hat keinen Standardwert. publisher_login muss angegeben werden, wenn publisher_security_mode den Wert 0 aufweist. Wenn publisher_login den Wert NULL und publisher_security_mode den Wert 1 aufweist, wird das in job_login angegebene Windows-Konto für die Verbindung mit dem Verleger verwendet.

• [ @publisher_password= ] 'publisher_password'
  Das zum Herstellen der Verbindung mit dem Verleger verwendete Kennwort. publisher_password ist vom Datentyp nvarchar(524) und hat keinen Standardwert.

  Sicherheitshinweis:
  Speichern Sie keine Authentifizierungsinformationen in Skriptdateien. Um optimale Sicherheit zu erreichen, sollten Anmeldenamen und Kennwörter zur Laufzeit bereitgestellt werden.

• [ @job_login= ] 'job_login'
  Der Anmeldename für das Windows-Konto, unter dem der Agent ausgeführt wird. job_login ist vom Datentyp nvarchar(257) und hat keinen Standardwert. Dieses Windows-Konto wird immer für Agentverbindungen mit dem Verteiler verwendet. Sie müssen diesen Parameter angeben, wenn Sie einen neuen Snapshot-Agent-Auftrag erstellen. Dies kann für einen Nicht-SQL Server-Verleger nicht geändert werden.

• [ @job_password= ] 'job_password'
  Das Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird. job_password ist vom Datentyp sysname und hat keinen Standardwert. Sie müssen diesen Parameter angeben, wenn Sie einen neuen Snapshot-Agent-Auftrag erstellen.

  Sicherheitshinweis:
  Speichern Sie keine Authentifizierungsinformationen in Skriptdateien. Um optimale Sicherheit zu erreichen, sollten Anmeldenamen und Kennwörter zur Laufzeit bereitgestellt werden.

• [ @publisher_type= ] 'publisher_type'
  Gibt den Verlegertyp an, wenn der Verleger nicht in einer Instanz von SQL Server ausgeführt wird. publisher_type ist vom Datentyp sysname. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  MSSQLSERVER	Gibt einen SQL Server-Verleger an.
  ORACLE	Gibt einen standardmäßigen Oracle-Verleger an.
  ORACLE GATEWAY	Gibt einen Oracle-Gatewayverleger an.

  Weitere Informationen zu den Unterschieden zwischen einem Oracle-Verleger und einem Oracle-Gatewayverleger finden Sie unter Veröffentlichungen mit Oracle (Übersicht).

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_MSchange_snapshot_agent_properties wird für die Snapshot-, Transaktions- und Mergereplikation verwendet.

Sie müssen alle Parameter angeben, wenn Sie sp_MSchange_snapshot_agent_properties ausführen. Führen Sie sp_helppublication_snapshot aus, um die aktuellen Eigenschaften des Snapshot-Agent-Auftrags zurückzugeben.

Wenn der Verleger in einer Instanz von SQL Server 2005 ausgeführt wird, sollten Sie mit sp_changepublication_snapshot Eigenschaften eines Snapshot-Agent-Auftrags ändern.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin auf dem Verteiler können sp_MSchange_snapshot_agent_properties ausführen.

Siehe auch

Verweis

sp_addpublication_snapshot (Transact-SQL)

Andere Ressourcen

Verwenden mehrerer Versionen von SQL Server in einer Replikationstopologie

Hilfe und Informationen

Informationsquellen für SQL Server 2005