Konfigurieren von Momentaufnahmeeigenschaften (Replikationsprogrammierung mit Transact-SQL)

Artikel
05/07/2013

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_addpublication aus. Geben Sie einen Veröffentlichungsnamen für @publication, den Wert snapshot oder continuous für @repl_freq und einen oder mehrere der folgenden Momentaufnahmeparameter an:
- @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 Microsoft 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 Erstellen einer Veröffentlichung.

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

Führen Sie auf dem Verleger sp_addmergepublication aus. 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 Erstellen einer Veröffentlichung.

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

Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_changepublication aus. Geben Sie den 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_snapshot aus. Geben Sie @publication und einen oder mehrere der zu ändernden Parameter für die Zeitplanung oder Sicherheitsanmeldeinformationen an.

Sicherheitshinweis
Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit einzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei geschützt werden, um unberechtigte Zugriffe zu verhindern.

Führen Sie den Replikationsmomentaufnahme-Agent von der Eingabeaufforderung aus, oder starten Sie den Momentaufnahme-Agentauftrag, um eine neue Momentaufnahme zu erzeugen. Weitere Informationen finden Sie unter Erstellen und Anwenden der Anfangsmomentaufnahme.

So ändern Sie die Momentaufnahmeeigenschaften einer bestehenden Mergeveröffentlichung

Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_changemergepublication aus. Geben Sie den 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 Replikationsmomentaufnahme-Agent von der Eingabeaufforderung aus, oder starten Sie den Momentaufnahme-Agentauftrag, um eine neue Momentaufnahme zu erzeugen. Weitere Informationen finden Sie unter Erstellen und Anwenden der Anfangsmomentaufnahme.

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'AdventureWorks2012'; 
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

Siehe auch

Konzepte

Alternative Speicherorte für Momentaufnahmeordner

Komprimierte Momentaufnahmen

Ausführen von Skripts vor und nach dem Anwenden der Momentaufnahme

Konzepte für gespeicherte Systemprozeduren für die Replikation

Übertragen von Momentaufnahmen über FTP

Ändern von Veröffentlichungs- und Artikeleigenschaften

Freigeben über