sp_changepublication_snapshot (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

Ändert Eigenschaften des Momentaufnahme-Agents für die angegebene Veröffentlichung. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Wichtig

Beim Konfigurieren 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 zugehörigen Remoteverteiler verschlüsseln, bevor Sie diese gespeicherte Prozedur ausführen. Weitere Informationen finden Sie unter Aktivieren von verschlüsselten Verbindungen zur Datenbank-Engine (SQL Server-Konfigurations-Manager).

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. Publikation ist sysname, ohne Standard.

[ @frequency_type = ] frequency_type Ist die Häufigkeit, mit der der Agent geplant werden soll. frequency_type ist int und kann einer der folgenden Werte sein:

Wert	Beschreibung des Dataflows
1	Einmal
2	On-Demand-Streaming
4	Täglich
8	Wöchentlich
16	Monatlich
32	Monatlich, relativ
64	Autostart
128	Wiederkehrend
NULL (Standard)

[ @frequency_interval = ] frequency_interval Gibt die Tage an, die der Agent ausführt. frequency_interval ist int und kann einen der folgenden Werte aufweisen.

Wert	Beschreibung des Dataflows
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 Ist die Einheit für freq_subday_interval. frequency_subday ist int und kann einer dieser Werte sein.

Wert	Beschreibung des Dataflows
1	Einmal
2	Second
4	Minute
8	Hour
NULL (Standard)

[ @frequency_subday_interval = ] frequency_subday_interval Ist das Intervall für frequency_subday. frequency_subday_interval ist "int" mit einem Standardwert von NULL.

[ @frequency_relative_interval = ] frequency_relative_intervalIst das Datum, an dem die Momentaufnahmen-Agent ausgeführt wird. frequency_relative_interval ist int, mit einem Standardwert von NULL.

[ @frequency_recurrence_factor = ] frequency_recurrence_factorIst der von frequency_type verwendete Serienfaktor. frequency_recurrence_factor ist "int" mit einem Standardwert von NULL.

[ @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, mit einem Standardwert von NULL.

[ @active_end_date = ] active_end_dateIst das Datum, an dem die Momentaufnahmen-Agent nicht mehr geplant, formatiert als yyyyMMdd. active_end_date ist int mit einem Standardwert von NULL.

[ @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" mit einem Standardwert von NULL.

[ @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, mit einem Standardwert von NULL.

[ @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) mit einem Standardwert von NULL.

[ @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 klein, mit einem Standardwert von NULL. 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.

Wichtig

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" mit dem Standardwert NULL. 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 "sysname" mit dem Standardwert NULL.

Wichtig

Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort. Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.

[ @job_login = ] 'job_login' Ist die Anmeldung für das Windows-Konto, unter dem der Agent ausgeführt wird. job_login ist nvarchar(257), wobei der Standardwert NULL ist. 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" mit dem Standardwert NULL. Sie müssen diesen Parameter angeben, wenn Sie einen neuen Auftrag des Momentaufnahme-Agents erstellen.

Wichtig

Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.

[ @publisher = ] 'publisher' Gibt einen Nicht-SQL Server-Herausgeber an. Publisher ist "sysname" mit dem Standardwert NULL.

Hinweis

Publisher sollte beim Erstellen einer Momentaufnahmen-Agent in einem SQL Server Publisher nicht verwendet werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

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

Berechtigungen

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

Weitere Informationen

Anzeigen und Ändern von Veröffentlichungseigenschaften
Ändern von Veröffentlichungs- und Artikeleigenschaften
sp_addpublication_Momentaufnahme (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)