sp_changepublication_snapshot (Transact-SQL)
Gilt für: SQL Server Azure 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_interval
Ist 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_factor
Ist der von frequency_type verwendete Serienfaktor. frequency_recurrence_factor ist "int" mit einem Standardwert von NULL.
[ @active_start_date = ] active_start_date
Ist 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_date
Ist 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_day
Ist 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_day
Ist 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. snapshot_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_snapshot wird in der Momentaufnahmenreplikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle "sysadmin" oder db_owner festen Datenbankrolle können sp_changepublication_snapshot ausführen.
Weitere Informationen
Anzeigen und Ändern von Veröffentlichungseigenschaften
Ändern von Veröffentlichungs- und Artikeleigenschaften
sp_addpublication_snapshot (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für