Konfigurieren von Momentaufnahmeeigenschaften (Replikationsprogrammierung mit Transact-SQL)

Artikel
04/26/2023

Gilt für:SQL Server Azure SQL Managed Instance

Momentaufnahmeeigenschaften können mithilfe gespeicherter Replikationsprozeduren programmgesteuert definiert und geändert werden. Welche gespeicherten Prozeduren verwendet werden, hängt vom Typ der Veröffentlichung ab.

So konfigurieren Sie Momentaufnahmeeigenschaften beim Erstellen einer Momentaufnahme oder einer Transaktionsveröffentlichung

Führen Sie auf dem Verleger sp_addpublicationaus. Geben Sie einen Veröffentlichungsnamen für @publication, den Wert snapshot oder continuous für @repl_freq und einen oder mehrere der folgenden Momentaufnahmeparameter ein:
- @alt_snapshot_folder: Geben Sie einen Pfad an, wenn von diesem Speicherort, anstatt vom Standardmomentaufnahmeordner oder zusätzlich zu diesem, auf die Momentaufnahme für diese Veröffentlichung zugegriffen wird.
- @compress_snapshot- Geben Sie den Wert "true" an, wenn die Momentaufnahme Dateien im alternativen Momentaufnahme Ordner im Microsoft CAB-Dateiformat komprimiert werden.
- @pre_snapshot_script: Geben Sie den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, bevor die Anfangsmomentaufnahme angewendet wird.
- @post_snapshot_script: Geben Sie den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, nachdem die Anfangsmomentaufnahme angewendet wurde.
- @snapshot_in_defaultfolder: Geben Sie den Wert false an, wenn die Momentaufnahme nur in einem anderen als dem Standardverzeichnis verfügbar ist.
Weitere Informationen zum Erstellen von Veröffentlichungen finden Sie unter Create a Publication.

So konfigurieren Sie Momentaufnahmeeigenschaften beim Erstellen einer Momentaufnahme oder einer Mergeveröffentlichung

Führen Sie auf dem Verleger sp_addmergepublicationaus. Geben Sie einen Veröffentlichungsnamen für @publication, den Wert snapshot oder continuous für @repl_freq und einen oder mehrere der folgenden Momentaufnahmeparameter ein:
- alt_snapshot_folder: Geben Sie einen Pfad an, wenn von diesem Speicherort, anstatt vom Standardmomentaufnahmeordner oder zusätzlich zu diesem, auf die Momentaufnahme für diese Veröffentlichung zugegriffen wird.
- @compress_snapshot: Geben Sie den Wert true an, wenn die Momentaufnahmedateien im alternativen Momentaufnahmeordner im CAB-Dateiformat komprimiert sind.
- @pre_snapshot_script: Geben Sie den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, bevor die Anfangsmomentaufnahme angewendet wird.
- @post_snapshot_script: Geben Sie den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, nachdem die Anfangsmomentaufnahme angewendet wurde.
- @snapshot_in_defaultfolder: Geben Sie den Wert false an, wenn die Momentaufnahme nur in einem anderen als dem Standardverzeichnis verfügbar ist.
Weitere Informationen zum Erstellen von Veröffentlichungen finden Sie unter Create a Publication.

So ändern Sie die Momentaufnahmeeigenschaften einer bestehenden Momentaufnahme- oder Transaktionsveröffentlichung

Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_changepublicationaus. Geben Sie einen Wert 1 für @force_invalidate_snapshot und einen der folgenden Werte für @property an:
- alt_snapshot_folder: Geben Sie außerdem einen neuen Pfad zum alternativen Momentaufnahmeordner für @value an.
- compress_snapshot: Geben Sie außerdem entweder true oder false für @value an, um zu definieren, ob die Momentaufnahmedateien im alternativen Momentaufnahmeordner im CAB-Dateiformat komprimiert sind.
- pre_snapshot_script: Geben Sie außerdem für @value den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, bevor die Anfangsmomentaufnahme angewendet wird.
- post_snapshot_script: Geben Sie außerdem für @value den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, nachdem die Anfangsmomentaufnahme angewendet wurde.
- snapshot_in_defaultfolder – Geben Sie außerdem den Wert true oder false an, um zu definieren, ob die Momentaufnahme an einem anderen als dem Standardspeicherort verfügbar ist.
(Optional) Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_changepublication_snapshotaus. Geben Sie @publication und einen oder mehrere der zu ändernden Parameter für die Zeitplanung oder Sicherheitsanmeldeinformationen an.

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.
Führen Sie den Replication Snapshot Agent von der Eingabeaufforderung aus, oder starten Sie den Momentaufnahme-Agentauftrag, um eine neue Momentaufnahme zu erzeugen. Weitere Informationen finden Sie unter Create and Apply the Initial Snapshot.

So ändern Sie die Momentaufnahmeeigenschaften einer bestehenden Mergeveröffentlichung

Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_changemergepublicationaus. Geben Sie einen Wert 1 für @force_invalidate_snapshot und einen der folgenden Werte für @property** an:
- alt_snapshot_folder: Geben Sie außerdem einen neuen Pfad zum alternativen Momentaufnahmeordner für @value an.
- compress_snapshot: Geben Sie außerdem entweder true oder false für @value an, um zu definieren, ob die Momentaufnahmedateien im alternativen Momentaufnahmeordner im CAB-Dateiformat komprimiert sind.
- pre_snapshot_script: Geben Sie außerdem für @value den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, bevor die Anfangsmomentaufnahme angewendet wird.
- post_snapshot_script: Geben Sie außerdem für @value den Dateinamen und den vollständigen Pfad einer .sql-Datei an, die während der Initialisierung auf dem Abonnenten ausgeführt wird, nachdem die Anfangsmomentaufnahme angewendet wurde.
- snapshot_in_defaultfolder – Geben Sie außerdem den Wert true oder false an, um zu definieren, ob die Momentaufnahme an einem anderen als dem Standardspeicherort verfügbar ist.
Führen Sie den Replication Snapshot Agent von der Eingabeaufforderung aus, oder starten Sie den Momentaufnahme-Agentauftrag, um eine neue Momentaufnahme zu erzeugen. Weitere Informationen finden Sie unter Create and Apply the Initial Snapshot.

Beispiel

In diesem Beispiel wird eine Veröffentlichung erstellt, die einen alternativen Momentaufnahmeordner und eine komprimierte Momentaufnahme verwendet.

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @owner AS sysname;
DECLARE @snapshot_share AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksSalesOrdersMergeAltSnapshot'; 
SET @article = N'SpecialOffer';
SET @owner = N'Sales';
SET @snapshot_share = '\\' + $(InstanceName) + '\AltSnapshotFolder';

-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption 
    @dbname = @publicationDB, 
    @optname=N'merge publish',
    @value = N'true';

-- Create new merge publication with an alternate snapshot location. 
USE [AdventureWorks]
EXEC sp_addmergepublication 
-- required parameters
    @publication = @publication, 
    @snapshot_in_defaultfolder = N'false',
    @alt_snapshot_folder = @snapshot_share,
    @compress_snapshot = N'true';

-- Create the snapshot job for the publication.
EXEC sp_addpublication_snapshot 
    @publication = @publication,
    @job_login = $(Login),
    @job_password = $(Password);

-- Add an article.
EXEC sp_addmergearticle 
    @publication = @publication, 
    @article = @article, 
    @source_object = @article, 
    @type = N'table', 
    @source_owner = @owner, 
    @destination_owner = @owner;

-- Start the snapshot job.
EXEC sp_startpublication_snapshot
    @publication = @publication;
GO

Weitere Informationen

Ändern von Momentaufnahmeoptionen
Ausführen von Skripts vor und nach dem Anwenden der Momentaufnahme
Replication System Stored Procedures Concepts
Übertragen von Momentaufnahmen über FTP
Ändern von Veröffentlichungs- und Artikeleigenschaften