sp_addmergesubscription (Transact-SQL)
Gilt für:
SQL ServerAzure SQL Managed Instance
Erstellt ein Mergepushabonnement oder ein Mergepullabonnement. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.
Transact-SQL-Syntaxkonventionen
Syntax
sp_addmergesubscription
[ @publication = ] N'publication'
[ , [ @subscriber = ] N'subscriber' ]
[ , [ @subscriber_db = ] N'subscriber_db' ]
[ , [ @subscription_type = ] N'subscription_type' ]
[ , [ @subscriber_type = ] N'subscriber_type' ]
[ , [ @subscription_priority = ] subscription_priority ]
[ , [ @sync_type = ] N'sync_type' ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @optional_command_line = ] N'optional_command_line' ]
[ , [ @description = ] N'description' ]
[ , [ @enabled_for_syncmgr = ] N'enabled_for_syncmgr' ]
[ , [ @offloadagent = ] offloadagent ]
[ , [ @offloadserver = ] N'offloadserver' ]
[ , [ @use_interactive_resolver = ] N'use_interactive_resolver' ]
[ , [ @merge_job_name = ] N'merge_job_name' ]
[ , [ @hostname = ] N'hostname' ]
[ ; ]
Argumente
[ @publication = ] N'Publikation'
Der Name der Veröffentlichung. @publication ist "sysname" ohne Standard. Die Veröffentlichung muss bereits vorhanden sein.
[ @subscriber = ] N'subscriber'
Den Namen des Abonnenten. @subscriber ist "sysname" mit der Standardeinstellung "NULL.
[ @subscriber_db = ] N'subscriber_db'
Der Name der Abonnementdatenbank. @subscriber_db ist "sysname" mit der Standardeinstellung "NULL.
[ @subscription_type = ] N'subscription_type'
Der Abonnementtyp. @subscription_type ist "nvarchar(15)", wobei der Standardwert "push.
- Wenn
pushein Pushabonnement hinzugefügt wird und die Merge-Agent beim Distributor hinzugefügt wird. - Wenn
pull, wird ein Pull-Abonnement hinzugefügt, ohne eine Merge-Agent beim Distributor hinzuzufügen.
Hinweis
Anonyme Abonnements müssen diese gespeicherte Prozedur nicht verwenden.
[ @subscriber_type = ] N'subscriber_type'
Der Typ des Abonnenten. @subscriber_type ist nvarchar(15) und kann einen der folgenden Werte aufweisen.
| Wert | Beschreibung |
|---|---|
local (Standardwert) |
Der Abonnent ist nur dem Verleger bekannt. |
global |
Der Abonnent ist allen Servern bekannt. |
In SQL Server 2005 (9.x) und höheren Versionen werden lokale Abonnements als Clientabonnements bezeichnet, und globale Abonnements werden als Serverabonnements bezeichnet.
[ @subscription_priority = ] subscription_priority
Eine Zahl, die die Priorität für das Abonnement angibt. @subscription_priority ist real, mit einem Standardwert von NULL. Für lokale und anonyme Abonnements ist 0.0die Priorität . Für globale Abonnements muss die Priorität kleiner sein als 100.0.
[ @sync_type = ] N'sync_type'
Der Abonnementsynchronisierungstyp. @sync_type ist "nvarchar(15)" mit einem Standardwert von automatic.
- Wenn
automaticdie Schema- und Ausgangsdaten für veröffentlichte Tabellen zuerst an den Abonnenten übertragen werden. - Wenn
nonedavon ausgegangen wird, dass der Abonnent bereits das Schema und die anfänglichen Daten für veröffentlichte Tabellen enthält. Systemtabellen und Daten werden immer übertragen.
Hinweis
Es wird empfohlen, keinen Wert von none.
[ @frequency_type = ] frequency_type
Ein Wert, der angibt, wann die Merge-Agent ausgeführt wird. @frequency_type ist int und kann einer der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
1 |
Einmal |
4 |
Täglich |
8 |
Wöchentlich |
10 |
Monatlich |
20 |
Monatlich, relativ zum Häufigkeitsintervall |
40 |
Wenn SQL Server-Agent gestartet wird |
NULL (Standard) |
[ @frequency_interval = ] frequency_interval
Die Tage, an denen der Merge-Agent ausgeführt wird. @frequency_interval ist int und kann einer der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
1 |
Sonntag |
2 |
Montag |
3 |
Dienstag |
4 |
Mittwoch |
5 |
Donnerstag |
6 |
Freitag |
7 |
Samstag |
8 |
Tag |
9 |
Wochentage |
10 |
Wochenendtage |
NULL (Standard) |
[ @frequency_relative_interval = ] frequency_relative_interval
Das geplante Zusammenführen des Häufigkeitsintervalls in jedem Monat. @frequency_relative_interval ist int und kann einer dieser Werte sein.
| Wert | Beschreibung |
|---|---|
1 |
First |
2 |
Second |
4 |
Third |
8 |
Viertes |
16 |
Letzte |
NULL (Standard) |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Der von @frequency_type verwendete Serienfaktor. @frequency_recurrence_factor ist int mit einem Standardwert von NULL.
[ @frequency_subday = ] frequency_subday
Die Einheit für @frequency_subday_interval. @frequency_subday ist int und kann einer der folgenden Werte sein:
| Wert | Beschreibung |
|---|---|
1 |
Einmal |
2 |
Second |
4 |
Minute |
8 |
Hour |
NULL (Standard) |
[ @frequency_subday_interval = ] frequency_subday_interval
Die Häufigkeit für @frequency_subday zwischen den einzelnen Zusammenführungen auftreten. @frequency_subday_interval ist int, mit einem Standardwert von NULL.
[ @active_start_time_of_day = ] active_start_time_of_day
Die Tageszeit, zu der die Merge-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
Die Tageszeit, zu der die Merge-Agent nicht mehr geplant wird, formatiert als HHmmss. @active_end_time_of_day ist int mit einem Standardwert von NULL.
[ @active_start_date = ] active_start_date
Das Datum, an dem die Merge-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
Das Datum, an dem die Merge-Agent nicht mehr geplant wird, formatiert als yyyyMMdd. @active_end_date ist int, mit einem Standardwert von NULL.
[ @optional_command_line = ] N'optional_command_line'
Die optionale Eingabeaufforderung, die ausgeführt werden soll. @optional_command_line ist nvarchar(4000), mit einem Standardwert von NULL. Dieser Parameter wird verwendet, um einen Befehl hinzuzufügen, der die Ausgabe aufzeichnet und in einer Datei speichert, oder um eine Konfigurationsdatei oder ein Konfigurationsattribut anzugeben.
[ @description = ] N'description'
Eine kurze Beschreibung dieses Seriendruckabonnements. @description ist nvarchar(255), mit einem Standardwert von NULL. Dieser Wert wird vom Replikationsmonitor in der Friendly Name Spalte angezeigt, mit dem die Abonnements für eine überwachte Publikation sortiert werden können.
[ @enabled_for_syncmgr = ] N'enabled_for_syncmgr'
Gibt an, ob das Abonnement über den Microsoft Windows-Synchronisierungs-Manager synchronisiert werden kann. @enabled_for_syncmgr ist nvarchar(5), mit einem Standardwert von false.
- Wenn
falsedas Abonnement nicht beim Synchronisierungs-Manager registriert ist. - Wenn
truedas Abonnement mit dem Synchronisierungs-Manager registriert ist und ohne sql Server Management Studio synchronisiert werden kann.
[ @offloadagent = ] Offloadagent
Gibt an, dass eine Remoteaktivierung der Momentaufnahme möglich ist. @offloadagent ist bit, mit einem Standardwert von 0.
Dieser Parameter ist veraltet und wird zur Abwärtskompatibilität von Skripts Standard beibehalten.
[ @offloadserver = ] N'offloadserver'
Gibt den Netzwerknamen des Servers an, auf dem die Remoteaktivierung der Momentaufnahme erfolgt. @offloadserver ist "sysname" mit einem Standardwert von NULL.
[ @use_interactive_resolver = ] N'use_interactive_resolver'
Ermöglicht das interaktive Lösen von Konflikten für alle Artikel, die eine interaktive Auflösung zulassen. @use_interactive_resolver ist nvarchar(5), mit einem Standardwert von false.
[ @merge_job_name = ] N'merge_job_name'
Dieser Parameter ist veraltet und kann nicht festgelegt werden. @merge_job_name ist "sysname" mit einem Standardwert von NULL.
[ @hostname = ] N'hostname'
Überschreibt den von HOST_NAME zurückgegebenen Wert, wenn diese Funktion in der WHERE-Klausel eines parametrisierten Filters verwendet wird. @hostname ist "sysname" mit der Standardeinstellung "NULL.
Wichtig
Aus Leistungsgründen wird empfohlen, keine Funktionen auf Spaltennamen in parametrisierten Zeilenfilterklauseln (beispielsweise LEFT([MyColumn]) = SUSER_SNAME()) anzuwenden. Wenn Sie HOST_NAME in einer Filterklausel verwenden und den HOST_NAME Wert außer Kraft setzen, kann es erforderlich sein, Datentypen mithilfe von CONVERT zu konvertieren. Weitere Informationen zu bewährten Methoden für diesen Fall finden Sie im Abschnitt "Überschreiben des HOST_NAME()-Werts" im Thema "Parametrisierte Filter - Parametrisierte Zeilenfilter".
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler).
Hinweise
sp_addmergesubscription wird in der Seriendruckreplikation verwendet.
Wenn sp_addmergesubscription ein Mitglied der festen Serverrolle "sysadmin" ausgeführt wird, um ein Pushabonnement zu erstellen, wird der Merge-Agent Auftrag implizit erstellt und unter dem SQL Server-Agent Dienstkonto ausgeführt. Es wird empfohlen, sp_addmergepushsubscription_agent auszuführen und die Anmeldeinformationen eines anderen agentspezifischen Windows-Kontos für @job_login und @job_password anzugeben. Weitere Informationen finden Sie unter Replication Agent Security Model.
Beispiele
-- 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".
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorksReplica';
SET @hostname = N'adventure-works\david8'
-- Add a push subscription to a merge publication.
USE [AdventureWorks2022];
EXEC sp_addmergesubscription
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@subscription_type = N'push',
@hostname = @hostname;
--Add an agent job to synchronize the push subscription.
EXEC sp_addmergepushsubscription_agent
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@job_login = $(Login),
@job_password = $(Password);
GO
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin oder db_owner feste Datenbankrolle können ausgeführt werden sp_addmergesubscription.
Zugehöriger Inhalt
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für