Replication Distribution Agent

Gilt für: SQL Server Azure SQL-Datenbank

Der Replikationsverteilungs-Agent ist eine ausführbare Datei, die die Momentaufnahme (bei der Momentaufnahme- und Transaktionsreplikation) und die in den Tabellen der Verteilungsdatenbank gespeicherten Transaktionen (bei der Transaktionsreplikation) in die Zieltabellen auf den Abonnenten verschiebt.

Syntax

distrib [ -? ]
-Publisher server_name [ \instance_name ]
-PublisherDB publisher_database
-Subscriber server_name [ \instance_name ]
-SubscriberDB subscriber_database
[ -AltSnapshotFolder alt_snapshot_folder_path ]
[ -BcpBatchSize bcp_batch_size ]
[ -CommitBatchSize commit_batch_size ]
[ -CommitBatchThreshold commit_batch_threshold ]
[ -Continuous ]
[ -DefinitionFile def_path_and_file_name ]
[ -Distributor distributor ]
[ -DistributorLogin distributor_login ]
[ -DistributorPassword distributor_password ]
[ -DistributorSecurityMode [ 0 | 1 ] ]
[ -EncryptionLevel [ 0 | 1 | 2 ] ]
[ -ErrorFile error_path_and_file_name ]
[ -ExtendedEventConfigFile configuration_path_and_file_name ]
[ -FileTransferType [ 0 | 1 ] ]
[ -FtpAddress ftp_address ]
[ -FtpPassword ftp_password ]
[ -FtpPort ftp_port ]
[ -FtpUserName ftp_user_name ]
[ -HistoryVerboseLevel [ 0 | 1 | 2 | 3 ] ]
[ -Hostname host_name ]
[ -KeepAliveMessageInterval keep_alive_message_interval_seconds ]
[ -LoginTimeOut login_time_out_seconds ]
[ -MaxBcpThreads ]
[ -MaxDeliveredTransactions number_of_transactions ]
[ -MessageInterval message_interval ]
[ -MultiSubnetFailover [ 0 | 1 ] ]
[ -OledbStreamThreshold oledb_stream_threshold ]
[ -Output output_path_and_file_name ]
[ -OutputVerboseLevel [ 0 | 1 | 2 ] ]
[ -PacketSize packet_size ]
[ -PollingInterval polling_interval ]
[ -ProfileName profile_name ]
[ -Publication publication ]
[ -QueryTimeOut query_time_out_seconds ]
[ -QuotedIdentifier quoted_identifier ]
[ -SkipErrors native_error_id [ :...n ] ]
[ -SubscriberDatabasePath subscriber_path ]
[ -SubscriberLogin subscriber_login ]
[ -SubscriberPassword subscriber_password ]
[ -SubscriberSecurityMode [ 0 | 1 ] ]
[ -SubscriberType [ 0 | 1 | 3 ] ]
[ -SubscriptionStreams [ 1 | 2 | ...64 ] ]
[ -SubscriptionTableName subscription_table ]
[ -SubscriptionType [ 0 | 1 | 2 ] ]
[ -TransactionsPerHistory [ 0 | 1 | ...10000 ] ]
[ -UseDTS ]
[ -UseInprocLoader ]
[ -UseOledbStreaming ]

Argumente

-?

Druckt alle verfügbaren Parameter.

-Publisher server_name [ \instance_name ]

Der Name des Herausgebers. Geben Sie für die Standardinstanz von Microsoft SQL Server auf diesem Server an <server_name> . Geben Sie <server_name>\<instance_name> für eine benannte Instanz von SQL Server auf diesem Server an. Wenn sich Ihre Herausgeberdatenbank in einer Verfügbarkeitsgruppe (AG) befindet, entspricht dies weiterhin dem ursprünglichen Namen des primären Herausgeberservers aufgrund sp_redirect_publisher. Er spiegelt nicht den Namen des AG-Listeners wider.

-PublisherDB-publisher_database

Der Name der Verlegerdatenbank.

-Subscriber server_name [ \instance_name ]

Den Namen des Abonnenten. Geben Sie für die Standardinstanz von SQL Server auf diesem Server an <server_name> . Geben Sie <server_name>\<instance_name> für eine benannte Instanz von SQL Server auf diesem Server an. Wenn sich Ihre Abonnentendatenbank in einer AG befindet, sollte dies den Namen des AG-Listeners widerspiegeln.

-SubscriberDB subscriber_database

Der Name der Abonnentendatenbank.

-AltSnapshotFolder alt_snapshot_folder_path

Der Pfad zum Ordner, der die anfängliche Momentaufnahme für ein Abonnement enthält.

-BcpBatchSize bcp_batch_size

Die Anzahl der Zeilen, die in einem Massenkopievorgang gesendet werden sollen. Wenn Sie einen bcp in Vorgang ausführen, ist die Batchgröße die Anzahl der Zeilen, die als eine Transaktion an den Server gesendet werden sollen, sowie die Anzahl der Zeilen, die gesendet werden müssen, bevor die Verteilungs-Agent eine bcp-Statusmeldung protokolliert. Wenn Sie einen bcp out Vorgang ausführen, wird eine feste Batchgröße 1000 verwendet.

-CommitBatchSize commit_batch_size

Die Anzahl der Transaktionen, die dem Abonnenten ausgestellt werden sollen, bevor eine COMMIT-Anweisung ausgestellt wird. Der Standardwert ist 100, der maximale Wert beträgt 10.000. Dieser Parameter wird ignoriert, wenn die Momentaufnahme vom Verteilungs-Agent auf den Abonnenten angewendet wird.

-CommitBatchThreshold commit_batch_threshold

Die Anzahl der Replikationsbefehle, die für den Abonnenten ausgestellt werden sollen, bevor eine COMMIT-Anweisung ausgestellt wird. Der Standardwert ist 1.000, der maximale Wert beträgt 10.000. Dieser Parameter wird ignoriert, wenn die Momentaufnahme vom Verteilungs-Agent auf den Abonnenten angewendet wird.

-Continuous

Gibt an, ob der Agent fortlaufend versucht, replizierte Transaktionen abzurufen. Wenn dieses Argument angegeben ist, ruft der Agent replizierte Transaktionen in festgelegten Abrufintervallen aus der Quelle ab, selbst wenn keine ausstehenden Transaktionen vorhanden sind.

-DefinitionFile-def_path_and_file_name

Der Pfad der Agentdefinitionsdatei. Eine Agentdefinitionsdatei enthält Eingabeaufforderungsargumente für den Agent. Der Inhalt der Datei wird als ausführbare Datei analysiert. Verwenden Sie doppelte Anführungszeichen ("), um Argumentwerte anzugeben, die beliebige Zeichen enthalten.

-Distributor

Der Name des Distributors. Bei der Verteilung durch den Verteiler (Push) wird der Name standardmäßig auf dem Namen des lokalen Verteilers festgelegt. Wenn sich Ihre Verteilerdatenbank in einer AG befindet, sollte dies den Namen des AG-Listeners widerspiegeln.

-DistributorLogin distributor_login

Anmeldename des Verteilers.

-DistributorPassword distributor_password

Das Händlerkennwort.

-DistributorSecurityMode [ 0 | 1 ]

Gibt den Sicherheitsmodus des Verteilers an. Der Wert 0 gibt den SQL Server-Authentifizierungsmodus an, und ein Wert von 1 gibt den Windows-Authentifizierungsmodus an (Standardeinstellung).

-EncryptionLevel [ 0 | 1 | 2 ]

Die Ebene der Transport Layer Security (TLS), die zuvor als Secure Sockets Layer (SSL) bezeichnet wurde, verschlüsselung, die vom Verteilungs-Agent beim Herstellen von Verbindungen verwendet wird.

Ein gültiges TLS-Zertifikat wird mit einem vollqualifizierten Domänennamen des SQL Server definiert. Damit der Agent beim Festlegen -EncryptionLevel 2eine erfolgreiche Verbindung herstellen kann, erstellen Sie einen Alias auf dem lokalen SQL Server. Der Parameter „Alias Name“ sollte den Servernamen enthalten, und für den Parameter „Server“ sollte der vollqualifizierte Name der SQL Server-Instanz festgelegt werden.

Weitere Informationen finden Sie unter View and Modify Replication Security Settings.

-ErrorFile-error_path_and_file_name

Der Pfad und Dateiname der Fehlerdatei, die vom Verteilungs-Agent generiert wurde. Diese Datei wird an jedem Punkt generiert, an dem Fehler beim Anwenden von Replikationstransaktionen am Abonnenten aufgetreten sind. Fehler, die bei Publisher oder Distributor auftreten, werden in dieser Datei nicht protokolliert. Diese Datei enthält die Replikationstransaktionen, bei denen Fehler aufgetreten sind, sowie die zugeordneten Fehlermeldungen. Wenn dieser Parameter nicht angegeben ist, wird die Fehlerdatei im aktuellen Verzeichnis des Verteilungs-Agents generiert. Der Name der Fehlerdatei entspricht dem Namen des Verteilungs-Agents mit der Erweiterung ERR. Wenn eine Datei mit dem angegebenen Namen vorhanden ist, werden Fehlermeldungen an diese Datei angefügt. Dieser Parameter kann maximal 256 Unicode-Zeichen umfassen.

-ExtendedEventConfigFile configuration_path_and_file_name

Gibt den Pfad und den Dateinamen für die erweiterte Ereignis-XML-Konfigurationsdatei an. Die erweiterten Ereignis-Konfigurationsdatei ermöglicht das Konfigurieren von Sitzungen und das Aktivieren der Nachverfolgung für Ereignisse.

-FileTransferType [ 0 | 1 ]

Gibt den Dateiübertragungstyp an. Ein Wert von 0 UNC (universelle Benennungskonvention) und ein Wert von 1 "FTP" (Dateiübertragungsprotokoll).

-FtpAddress ftp_address

Die Netzwerkadresse des FTP-Diensts für den Distributor. Wird nicht angegeben, DistributorAddress wird verwendet. Wenn DistributorAddress nicht angegeben, Distributor wird verwendet.

-FtpPassword ftp_password

Das Zum Herstellen einer Verbindung mit dem FTP-Dienst verwendete Benutzerkennwort.

-FtpPort-ftp_port

Die Portnummer des FTP-Diensts für den Distributor. Wenn keine Portnummer angegeben wird, wird die Standardportnummer für den FTP-Dienst (21) verwendet.

-FtpUserName ftp_user_name

Der Benutzername, der zum Herstellen einer Verbindung mit dem FTP-Dienst verwendet wird. Wird nicht angegeben, anonymous wird verwendet.

-HistoryVerboseLevel [ 0 | 1 | 2 | 3 ]

Gibt den Umfang des Verlaufs an, der während eines Verteilungsvorgangs protokolliert wird. Sie können die Leistungswirkung der Verlaufsprotokollierung minimieren, indem Sie die Option auswählen 1.

-Hostname host_name

Der Hostname, der beim Herstellen einer Verbindung mit dem Publisher verwendet wird. Dieser Parameter kann maximal 128 Unicode-Zeichen umfassen.

-KeepAliveMessageInterval keep_alive_message_interval_seconds

Die Anzahl der Sekunden, bevor der Verlaufsthread überprüft, ob eine der vorhandenen Verbindungen auf eine Antwort vom Server wartet. Dieser Wert kann verringert werden, damit der Verteilungs-Agent vom Überprüfungs-Agent nicht als fehlerverdächtig markiert wird, wenn ein lang andauernder Batch ausgeführt wird. Der Standardwert ist 300 Sekunden.

-LoginTimeOut-login_time_out_seconds

Die Anzahl der Sekunden, bevor die Anmeldezeitüberschreitung erfolgt. Der Standardwert ist 15 Sekunden.

-MaxBcpThreads number_of_threads

Gibt die Anzahl von Massenkopiervorgängen an, die parallel ausgeführt werden können. Die maximale Anzahl von Threads und ODBC-Verbindungen, die gleichzeitig vorhanden sind, ist der geringere oder MaxBcpThreads die Anzahl der Massenkopieanforderungen, die in der Synchronisierungstransaktion in der Verteilungsdatenbank angezeigt werden. MaxBcpThreads muss einen Wert größer als 0 sein und keine hartcodierte Obergrenze aufweisen. Der Standardwert ist 2 die Anzahl der Prozessoren, bis zu einem Höchstwert von 8. Beim Anwenden einer Momentaufnahme, die bei Publisher mithilfe der Option für die gleichzeitige Momentaufnahme generiert wurde, wird unabhängig von der von Ihnen angegebenen MaxBcpThreadsNummer ein Thread verwendet.

-MaxDeliveredTransactions number_of_transactions

Die maximale Anzahl von Push- oder Pull-Transaktionen, die auf Abonnenten in einer Synchronisierung angewendet wurden. Ein Wert, der 0 angibt, dass das Maximum eine unendliche Anzahl von Transaktionen ist. Andere Werte können von Abonnenten verwendet werden, um die Dauer einer Synchronisierung zu verkürzen, die von einem Verleger abgerufen wird.

Wenn -MaxDeliveredTransactions und -Continuous beide angegeben werden, liefert die Verteilungs-Agent die angegebene Anzahl von Transaktionen und hält dann an (auch wenn -Continuous angegeben). Nachdem der Auftrag abgeschlossen wurde, müssen Sie den Verteilungs-Agent neu starten.

-MessageInterval message_interval

Das Zeitintervall, das für die Verlaufsprotokollierung verwendet wird. Ein Verlaufsereignis wird protokolliert, wenn einer der folgenden Parameter erreicht wird:

• Der TransactionsPerHistory Wert wird erreicht, nachdem das letzte Verlaufsereignis protokolliert wurde.

• Der MessageInterval Wert wird erreicht, nachdem das letzte Verlaufsereignis protokolliert wurde.

Wenn keine replizierte Transaktion an der Quelle verfügbar ist, meldet der Agent eine Meldung ohne Transaktion an den Distributor. Mit dieser Option wird angegeben, wie lange der Agent wartet, bevor eine weitere Meldung gesendet wird, dass keine Transaktion vorhanden ist. Agents melden immer, dass keine Transaktion vorhanden ist, wenn sie feststellen, dass an der Quelle keine Transaktionen verfügbar sind, nachdem zuvor replizierte Transaktionen verarbeitet wurden. Der Standardwert ist 60 Sekunden.

-MultiSubnetFailover

Gilt für: SQL Server 2019 (15.x) und höhere Versionen.

Gibt an, ob die MultiSubnetFailover-Eigenschaft aktiviert ist oder nicht. Wenn Ihre Anwendung eine Verbindung mit einer AG in verschiedenen Subnetzen herstellt, bietet das Festlegen von MultiSubnetFailover=true eine schnellere Erkennung und Verbindung mit dem (derzeit) aktiven Server.

-OledbStreamThreshold oledb_stream_threshold

Gibt die Mindestgröße in Byte für binäre große Objektdaten an, über denen die Daten als Datenstrom gebunden sind. Sie müssen angeben -UseOledbStreaming , dass dieser Parameter verwendet werden soll. Werte können zwischen 400 Bytes und 1.048.576 Bytes liegen, wobei der Standardwert 16.384 Bytes beträgt.

-Ausgabe output_path_and_file_name

Der Pfad der Agent-Ausgabedatei. Wenn der Dateiname nicht angegeben wird, wird die Ausgabe an die Konsole gesendet. Wenn eine Datei mit dem angegebenen Namen vorhanden ist, wird die Ausgabe an diese Datei angefügt.

-OutputVerboseLevel [ 0 | 1 | 2 ]

Gibt an, ob die Ausgabe ausführlich sein soll. Wenn die ausführliche Ebene lautet 0, werden nur Fehlermeldungen gedruckt. Wenn die ausführliche Ebene lautet 1, werden alle Statusberichtsmeldungen gedruckt. Wenn die ausführliche Ebene (Standard) lautet 2 , werden alle Fehlermeldungen und Statusberichtsmeldungen gedruckt, die für das Debuggen nützlich sind.

-PacketSize-packet_size

Die Paketgröße in Byte. Der Standardwert ist 4096 (Bytes).

-PollingInterval polling_interval

Wie oft in Sekunden die Verteilungsdatenbank für replizierte Transaktionen abgefragt wird. Der Standardwert lautet 5 Sekunden.

-ProfileName profile_name

Gibt ein Agentprofil an, das für Agentparameter verwendet werden soll. Ist ProfileName dies der Grund, ist NULLdas Agentprofil deaktiviert. Wenn ProfileName nicht angegeben, wird das Standardprofil für den Agenttyp verwendet. Weitere Informationen finden Sie unter Replication Agent Profiles.

-Publikation

Der Name der Veröffentlichung. Dieser Parameter ist nur gültig, wenn die Veröffentlichung so festgelegt ist, dass sie immer eine Momentaufnahme für neue oder neu initialisierte Abonnements zur Verfügung hat.

-QueryTimeOut-query_time_out_seconds

Die Anzahl der Sekunden, bevor die Abfrage eine Zeitüberschreitung hat. Der Standardwert ist 1.800 Sekunden.

-QuotedIdentifier quoted_identifier

Gibt den zu verwendenden Bezeichner in Anführungszeichenzeichen an. Das erste Zeichen des Werts gibt den Wert an, den der Verteilungs-Agent verwendet. Wenn QuotedIdentifier kein Wert verwendet wird, verwendet die Verteilungs-Agent ein Leerzeichen. Wird QuotedIdentifier dies nicht verwendet, verwendet die Verteilungs-Agent den vom Abonnenten unterstützten Bezeichner.

-SkipErrors native_error_id [ :... n ]

Eine durch Doppelpunkt getrennte Liste, die die Fehlernummern angibt, die von diesem Agent übersprungen werden sollen. Dieser Parameter wird ignoriert, wenn die Momentaufnahme vom Verteilungs-Agent auf den Abonnenten angewendet wird.

-SubscriberDatabasePath subscriber_database_path

Der Pfad zur Jet-Datenbank (.mdb Datei), wenn SubscriberType dies der Fall ist 2 (ermöglicht eine Verbindung mit einer Jet-Datenbank ohne ODBC-Datenquellenname (DSN)).

-SubscriberLogin subscriber_login

Der Anmeldename des Abonnenten. Wenn SubscriberSecurityMode ( 0 für die SQL Server-Authentifizierung) muss dieser Parameter angegeben werden.

-SubscriberPassword subscriber_password

Das Abonnentenkennwort. Wenn SubscriberSecurityMode ( 0 für die SQL Server-Authentifizierung) muss dieser Parameter angegeben werden.

-SubscriberSecurityMode [ 0 | 1 ]

Gibt den Sicherheitsmodus des Abonnenten an. Ein Wert von 0 "SQL Server-Authentifizierung" und ein Wert von 1 "Windows-Authentifizierungsmodus" (Standardeinstellung).

-SubscriberType [ 0 | 1 | 3 ]

Gibt den Typ der vom Verteilungs-Agent verwendeten Abonnentenverbindung an.

-SubscriptionStreams [ 0 | 1 | 2 | ... 64 ]

Die Anzahl der pro Verteilungs-Agent zulässigen Verbindungen, um Batches von Änderungen parallel zu einem Abonnenten anzuwenden, während viele der transaktionsbezogenen Merkmale beibehalten werden, die bei Verwendung eines einzelnen Threads vorhanden sind. Für einen SQL Server-Herausgeber wird ein Wertebereich von 1 bis 64 unterstützt.

Dieser Parameter wird nicht unterstützt oder muss für Nicht-SQL Server-Abonnenten oder Peer-to-Peer-Abonnements verwendet werden 0 . Dieser Parameter wird ignoriert, wenn die Momentaufnahme vom Verteilungs-Agent auf den Abonnenten angewendet wird.

Wenn eine der Verbindungen nicht ausgeführt oder commit ausgeführt werden kann, werden alle Verbindungen den aktuellen Batch abgebrochen, und der Agent verwendet einen einzelnen Datenstrom, um die fehlgeschlagenen Batches erneut zu versuchen. Vor dem Abschluss dieser Wiederholungsphase kann es auf dem Abonnenten vorübergehend zur Transaktionsinkonsistenzen kommen. Nach dem erfolgreichen Ausführen (Commit) der fehlgeschlagenen Batches wird der Abonnent wieder in einen Zustand der Transaktionskonsistenz versetzt.

Abonnementdatenströme funktionieren nicht für Artikel, die für die Bereitstellung von Transact-SQL konfiguriert sind. Um Abonnementdatenströme zu verwenden, konfigurieren Sie Artikel, um stattdessen Gespeicherte Prozeduraufrufe zu übermitteln.

-SubscriptionTableName subscription_table

Der Name der Abonnementtabelle, die bei dem angegebenen Abonnenten generiert oder verwendet wird. Wenn nicht angegeben, wird die MSreplication_subscriptions Tabelle verwendet. Verwenden Sie diese Option für Datenbankverwaltungssysteme (DBMS), die keine langen Dateinamen unterstützen.

-SubscriptionType [ 0 | 1 | 2 ]

Gibt den Abonnementtyp für die Verteilung an. Ein Wert von 0 "Pushabonnement", ein Wert von 1 "Pull-Abonnement" und ein Wert von 2 "Anonymes Abonnement".

-TransactionsPerHistory [ 0 | 1 | ... 10000 ]

Gibt das Transaktionsintervall für die Verlaufsprotokollierung an. Wenn die Anzahl von Transaktionen mit ausgeführtem Commit seit der letzten Instanz der Verlaufsprotokollierung den Wert dieser Option übersteigt, wird eine Verlaufsmeldung protokolliert. Der Standard ist 100. Ein Wert von 0 gibt unendlich TransactionsPerHistoryan. Siehe den vorherigen –MessageIntervalParameter.

-UseDTS

Muss als Parameter für eine Veröffentlichung angegeben werden, die eine Datentransformation ermöglicht.

-UseInprocLoader

Verbessert die Leistung der Anfangsmomentaufnahme, indem der Verteilungs-Agent veranlasst wird, beim Anwenden von Momentaufnahmedateien auf dem Abonnenten den BULK INSERT-Befehl zu verwenden. Dieser Parameter ist veraltet, da er nicht mit dem XML-Datentyp kompatibel ist. Wenn Sie keine XML-Daten replizieren, kann dieser Parameter verwendet werden. Dieser Parameter kann nicht mit Momentaufnahmen des Zeichenmodus oder Nicht-SQL Server-Abonnenten verwendet werden. Wenn Sie diesen Parameter verwenden, benötigt das SQL Server-Dienstkonto beim Abonnenten Leseberechtigungen für das Verzeichnis, in dem sich die Snapshotdatendateien .bcp befinden. Wenn dieser Parameter nicht verwendet wird, liest der Agent (für Nicht-SQL Server-Abonnenten) oder der ODBC-Treiber, der vom Agent (für SQL Server-Abonnenten) geladen wurde, aus den Dateien, sodass der Sicherheitskontext des SQL Server-Dienstkontos nicht verwendet wird.

-UseOledbStream

Wenn dieser Parameter angegeben wird, wird die Bindung der BLOB-Daten (Binary Large Object) als Datenstrom aktiviert. Hiermit geben Sie -OledbStreamThreshold die Größe in Byte an, über der ein Datenstrom verwendet wird. UseOledbStreaming ist standardmäßig aktiviert.

In SQL Server 2017 (14.x) CU 22 und höheren Versionen UseOledbStreaming wird in den C:\Users\<DistributionAgentAccount>\AppData\Temp Ordner geschrieben.

Schreibt vor SQL Server 2017 (14.x) CU 22 UseOledbStreaming in den C:\Program Files\Microsoft SQL Server\<version>\COM Ordner.

In SQL Server 2019 (15.x) CU 29, SQL Server 2022 (16.x) CU 16 und höheren Versionen können Sie OLE DB-Streaming deaktivieren, indem Sie aktualisieren-UseOledbStreaming, um 0 den in der Fehlermeldung erwähnten Fehler zu vermeiden, wenn Sie die Verteilungs-Agent in SQL Server ausführen.

Hinweise

Wenn Sie SQL Server-Agent installiert haben, um unter einem lokalen Systemkonto statt unter einem Domänenbenutzerkonto (Standardeinstellung) ausgeführt zu werden, kann der Dienst nur auf den lokalen Computer zugreifen. Wenn die Verteilungs-Agent, die unter SQL Server-Agent ausgeführt wird, für die Verwendung des Windows-Authentifizierungsmodus konfiguriert ist, wenn sie sich bei einer Instanz von SQL Server anmeldet, schlägt die Verteilungs-Agent fehl. Die Standardeinstellung ist die SQL Server-Authentifizierung. Weitere Informationen zum Ändern von Sicherheitskonten finden Sie unter View and Modify Replication Security Settings.

Führen Sie die Eingabeaufforderung aus, distrib.exe um die Verteilungs-Agent zu starten. Informationen hierzu finden Sie unter Ausführbare Konzepte für die Programmierung von Replikations-Agents.

Zugehöriger Inhalt

• Verwaltung des Replikations-Agents