Freigeben über

sp_MSchange_snapshot_agent_properties (Transact-SQL)

  • Artikel

Gilt für: SQL Server

Ändert die Eigenschaften eines Momentaufnahmen-Agent Auftrags, der in einem SQL Server 2005 (9.x) oder höher ausgeführt wird. Diese gespeicherte Prozedur wird verwendet, um Eigenschaften zu ändern, wenn der Publisher auf einer Instanz von SQL Server 2000 (8.x) 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 = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'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 = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Argumente

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" ohne Standard.

[ @publisher_db = ] N'publisher_db'

Der Name der Publikationsdatenbank. @publisher_db ist "sysname" ohne Standard.

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung. @publication ist "sysname" ohne Standard.

[ @frequency_type = ] frequency_type

Gibt die Häufigkeit an, mit der die Momentaufnahmen-Agent ausgeführt wird. @frequency_type ist int und kann einer dieser Werte sein.

Wert Beschreibung
1 Einmal
2 On-Demand-Streaming
4 Täglich
8 Wöchentlich
10 Monatlich
20 Monatlich, relativ zum Häufigkeitsintervall
40 Wenn SQL Server-Agent gestartet wird

[ @frequency_interval = ] frequency_interval

Der Wert, der auf die von @frequency_type festgelegte Häufigkeit angewendet werden soll. @frequency_interval ist "int" ohne Standard.

[ @frequency_subday = ] frequency_subday

Die Einheiten für @frequency_subday_interval. @frequency_subday ist int und kann einer dieser Werte sein.

Wert Beschreibung
1 Einmal
2 Second
4 Minute
8 Hour

[ @frequency_subday_interval = ] frequency_subday_interval

Das Intervall für @frequency_subday. @frequency_subday_interval ist "int" ohne Standard.

[ @frequency_relative_interval = ] frequency_relative_interval

Das Datum, an dem die Momentaufnahmen-Agent ausgeführt wird. @frequency_relative_interval ist "int" ohne Standard.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Der von @frequency_type verwendete Serienfaktor. @frequency_recurrence_factor ist int, ohne Standard.

[ @active_start_date = ] active_start_date

Das Datum, an dem die Momentaufnahmen-Agent zum ersten Mal geplant ist, formatiert als yyyyMMdd. @active_start_date ist "int" ohne Standard.

[ @active_end_date = ] active_end_date

Das Datum, an dem die Momentaufnahmen-Agent nicht mehr geplant wird, formatiert als yyyyMMdd. @active_end_date ist int, ohne Standard.

[ @active_start_time_of_day = ] active_start_time_of_day

Die Tageszeit, zu der die Momentaufnahmen-Agent zum ersten Mal geplant ist, formatiert als HHmmss. @active_start_time_of_day ist int, ohne Standard.

[ @active_end_time_of_day = ] active_end_time_of_day

Die Tageszeit, zu der die Momentaufnahmen-Agent nicht mehr geplant wird, formatiert als HHmmss. @active_end_time_of_day ist "int" ohne Standard.

[ @snapshot_job_name = ] N'snapshot_job_name'

Der Name eines vorhandenen Momentaufnahmen-Agent Auftragsnamens, wenn ein vorhandener Auftrag verwendet wird. @snapshot_job_name ist nvarchar(100), ohne Standard.

[ @publisher_security_mode = ] publisher_security_mode

Der vom Agent beim Herstellen einer Verbindung mit dem Publisher verwendete Sicherheitsmodus. @publisher_security_mode ist "int" ohne Standard. Für Nicht-SQL Server-Herausgeber muss ein Wert 0 angegeben werden.

  • 0 Gibt die SQL Server-Authentifizierung an.
  • 1Gibt Windows-Authentifizierung

Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

[ @publisher_login = ] N'publisher_login'

Der Anmeldename, der beim Herstellen einer Verbindung mit dem Verleger verwendet wird @publisher_login ist "sysname" ohne Standard. @publisher_login muss angegeben werden, wenn @publisher_security_mode ist0. Wenn @publisher_login ist NULL und @publisher_security_mode ist 1, wird das in @job_login angegebene Windows-Konto beim Herstellen einer Verbindung mit publisher verwendet.

[ @publisher_password = ] N'publisher_password'

Das Kennwort, das beim Herstellen einer Verbindung mit dem Publisher verwendet wird. @publisher_password ist nvarchar(524), ohne Standard.

Wichtig

Speichern Sie keine Authentifizierungsinformationen in Skriptdateien. Es wird empfohlen, Anmeldenamen und Kennwörter zur Laufzeit bereitzustellen, um die Sicherheit zu verbessern.

[ @job_login = ] N'job_login'

Die Anmeldung für das Windows-Konto, unter dem der Agent ausgeführt wird. @job_login ist nvarchar(257), ohne Standard. Das Windows-Konto wird stets für Agent-Verbindungen mit dem Verteiler verwendet. Sie müssen diesen Parameter angeben, wenn Sie einen neuen Auftrag des Momentaufnahme-Agents erstellen. Diese Eigenschaft kann für einen Nicht-SQL Server-Herausgeber nicht geändert werden.

[ @job_password = ] N'job_password'

Das Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird. @job_password ist "sysname" ohne Standard. Sie müssen diesen Parameter angeben, wenn Sie einen neuen Auftrag des Momentaufnahme-Agents erstellen.

Wichtig

Speichern Sie keine Authentifizierungsinformationen in Skriptdateien. Es wird empfohlen, Anmeldenamen und Kennwörter zur Laufzeit bereitzustellen, um die Sicherheit zu verbessern.

[ @publisher_type = ] N'publisher_type'

Gibt den Publisher-Typ an, wenn der Publisher nicht in einer Instanz von SQL Server ausgeführt wird. @publisher_type ist "sysname" und kann einen der folgenden Werte aufweisen.

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

Weitere Informationen zu den Unterschieden zwischen einem Oracle Publisher und einem Oracle Gateway Publisher finden Sie unter Oracle Publishing Overview.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_MSchange_snapshot_agent_properties wird in der Momentaufnahmereplikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.

Sie müssen beim Ausführen sp_MSchange_snapshot_agent_propertiesalle Parameter angeben. Führen Sie sp_helppublication_snapshot aus, um die aktuellen Eigenschaften des Momentaufnahmen-Agent Auftrags zurückzugeben.

Sie können sp_changepublication_snapshot in Publisher verwenden, um die Eigenschaften eines Momentaufnahmen-Agent Auftrags zu ändern.

Berechtigungen

Nur Mitglieder der festen Serverrolle "sysadmin " im Distributor können ausgeführt werden sp_MSchange_snapshot_agent_properties.

Zugehöriger Inhalt