sp_MSchange_snapshot_agent_properties (Transact-SQL)

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 Veröffentlichungsdatenbank. publisher_db ist vom Datentyp sysname und hat keinen Standardwert.

• [ @publication=] 'publication'
  Der Name der Veröffentlichung. publication ist vom Datentyp sysname und hat keinen Standardwert.

• [ @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. Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

• [ @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. Es wird empfohlen, Anmeldenamen und Kennwörter zur Laufzeit bereitzustellen, um die Sicherheit zu verbessern.

• [ @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. Es wird empfohlen, Anmeldenamen und Kennwörter zur Laufzeit bereitzustellen, um die Sicherheit zu verbessern.

• [ @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 oder einer höheren Version 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

Konzepte