sp_MSchange_snapshot_agent_properties (Transact-SQL)

Gilt für:SQL Server

Ändert die Eigenschaften eines Momentaufnahmen-Agent Auftrags, der bei einem Microsoft 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 Microsoft 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 = ] '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' Ist der Name des Herausgebers. Publisher ist "sysname" ohne Standard.

[ @publisher_db = ] 'publisher_db' Ist der Name der Publikationsdatenbank. publisher_db ist "sysname" ohne Standard.

[ @publication = ] 'publication' Ist der Name der Publikation. Publikation ist sysname, ohne Standard.

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

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

[ @frequency_subday = ] frequency_subday Ist die Einheit für freq_subday_interval. frequency_subday ist int und kann einer dieser Werte sein.

[ @frequency_subday_interval = ] frequency_subday_interval Ist das Intervall für frequency_subday. frequency_subday_interval ist "int" ohne Standard.

[ @frequency_relative_interval = ] frequency_relative_intervalIst das Datum, an dem die Momentaufnahmen-Agent ausgeführt wird. frequency_relative_interval ist "int" ohne Standard.

[ @frequency_recurrence_factor = ] frequency_recurrence_factorIst der von frequency_type verwendete Serienfaktor. frequency_recurrence_factor ist "int" ohne Standard.

[ @active_start_date = ] active_start_dateIst 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_dateIst das Datum, an dem die Momentaufnahmen-Agent nicht mehr geplant, formatiert als yyyyMMdd. active_end_date ist int, ohne Standardeinstellung.

[ @active_start_time_of_day = ] active_start_time_of_dayIst 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_dayIst 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 = ] 'snapshot_agent_name'Ist der Name eines vorhandenen Momentaufnahmen-Agent Auftragsnamens, wenn ein vorhandener Auftrag verwendet wird. Momentaufnahme_agent_name ist nvarchar(100), ohne Standard.

[ @publisher_security_mode = ] publisher_security_mode Ist der Sicherheitsmodus, der vom Agent beim Herstellen einer Verbindung mit dem Publisher verwendet wird. publisher_security_mode ist int, ohne Standard. 0 gibt die SQL Server-Authentifizierung an, und 1 gibt die Windows-Authentifizierung an. Für Nicht-SQL Server-Herausgeber muss ein Wert von 0 angegeben werden. Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

[ @publisher_login = ] 'publisher_login' Ist die Anmeldung, die beim Herstellen einer Verbindung mit dem Publisher verwendet wird. publisher_login ist "sysname" ohne Standard. publisher_login muss angegeben werden, wenn publisher_security_mode 0 ist. Wenn publisher_login NULL ist und publisher*_*security_mode 1 ist, wird das in job_login angegebene Windows-Konto beim Herstellen einer Verbindung mit Publisher verwendet.

[ @publisher_password = ] 'publisher_password' Ist das Kennwort, das beim Herstellen einer Verbindung mit dem Publisher verwendet wird. publisher_password ist nvarchar(524), ohne Standard.

[ @job_login = ] 'job_login' Ist 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. Dies kann für einen Nicht-SQL Server-Herausgeber 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 "sysname" ohne Standard. Sie müssen diesen Parameter angeben, wenn Sie einen neuen Auftrag des Momentaufnahme-Agents erstellen.

[ @publisher_type = ] '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.

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_MSchange_Momentaufnahme_agent_properties wird in Momentaufnahme Replikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.

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

Wenn der Publisher auf einer Instanz von SQL Server 2005 (9.x) oder höher ausgeführt wird, sollten Sie sp_changepublication_Momentaufnahme verwenden, um die Eigenschaften eines Momentaufnahmen-Agent Auftrags zu ändern.

Berechtigungen

Nur Mitglieder der festen Serverrolle "sysadmin" im Distributor können sp_MSchange_Momentaufnahme_agent_properties ausführen.

Weitere Informationen

sp_addpublication_Momentaufnahme (Transact-SQL)