Replikationsmomentaufnahme-AgentReplication Snapshot Agent

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL DatabaseAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL Database

Der Replikationsmomentaufnahme-Agent ist eine ausführbare Datei, die Momentaufnahmedateien vorbereitet, die das Schema und die Daten von veröffentlichten Tabellen und Datenbankobjekten enthalten, die Dateien im Momentaufnahmeordner speichert und Synchronisierungsaufträge in der Verteilungsdatenbank aufzeichnet.The Replication Snapshot Agent is an executable file that prepares snapshot files containing schema and data of published tables and database objects, stores the files in the snapshot folder, and records synchronization jobs in the distribution database.

Hinweis

  • Parameter können in beliebiger Reihenfolge angegeben werden.Parameters can be specified in any order.

Hinweis

Azure SQL Managed Instance kann als Herausgeber, Verleger und Abonnent der Momentaufnahmen- und Transaktionsreplikation fungieren.Azure SQL Managed Instance can be a publisher, distributor, and subscriber for snapshot and transactional replication. Datenbanken in Azure SQL-Datenbank können nun Pushabonnenten der Momentaufnahmen- und Transaktionsreplikation sein.Databases in Azure SQL Database can only be push subscribers for snapshot and transactional replication. Weitere Informationen finden Sie unter Transaktionsreplikation mit Azure SQL-Datenbank.For more information, see Transactional replication with Azure SQL Database.

SyntaxSyntax

  
snapshot [ -?]   
-Publisher server_name[\instance_name]   
-Publication publication_name   
[-70Subscribers]   
[-BcpBatchSize bcp_batch_size]  
[-DefinitionFile def_path_and_file_name]  
[-Distributor server_name[\instance_name]]  
[-DistributorDeadlockPriority [-1|0|1] ]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1] ]  
[-DynamicFilterHostName dynamic_filter_host_name]  
[-DynamicFilterLogin dynamic_filter_login]  
[-DynamicSnapshotLocation dynamic_snapshot_location]   
[-EncryptionLevel [0|1|2]]  
[-FieldDelimiter field_delimiter]  
[-HistoryVerboseLevel [0|1|2|3] ]  
[-HRBcpBlocks number_of_blocks ]  
[-HRBcpBlockSize block_size ]  
[-HRBcpDynamicBlocks ]  
[-KeepAliveMessageInterval keep_alive_interval]  
[-LoginTimeOut login_time_out_seconds]  
[-MaxBcpThreads number_of_threads ]  
[-MaxNetworkOptimization [0|1]]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2] ]  
[-PacketSize packet_size]  
[-PrefetchTables [0|1] ]  
[-ProfileName profile_name]  
[-PublisherDB publisher_database]  
[-PublisherDeadlockPriority [-1|0|1] ]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-PublisherLogin publisher_login]  
[-PublisherPassword publisher_password]   
[-PublisherSecurityMode [0|1] ]  
[-QueryTimeOut query_time_out_seconds]  
[-ReplicationType [1|2] ]  
[-RowDelimiter row_delimiter]  
[-StartQueueTimeout start_queue_timeout_seconds]  
[-UsePerArticleContentsView use_per_article_contents_view]  

ArgumenteArguments

-?-?
Druckt alle verfügbaren Parameter.Prints all available parameters.

-Publisher server_name[ \ instance_name]-Publisher server_name[\instance_name]
Der Name des Verlegers.Is the name of the Publisher. Geben Sie „server_name“ für die Standardinstanz von MicrosoftMicrosoft SQL ServerSQL Server auf diesem Server an.Specify server_name for the default instance of MicrosoftMicrosoft SQL ServerSQL Server on that server. Geben Sie server_name \ instance_name für eine benannte Instanz von SQL ServerSQL Server auf diesem Server an.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-Publication publication-Publication publication
Der Name der Veröffentlichung.Is the name of the publication. 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.This parameter is only valid if the publication is set to always have a snapshot available for new or reinitialized subscriptions.

-70Subscribers-70Subscribers
Muss verwendet werden, wenn Abonnenten vorhanden sind, auf denen SQL ServerSQL Server , Version 7.0, ausgeführt wird.Must be used if any Subscribers are running SQL ServerSQL Server version 7.0.

-BcpBatchSize bcp_ batch_ size-BcpBatchSize bcp_ batch_ size
Die Anzahl von Zeilen, die in einem Massenkopiervorgang gesendet werden sollen.Is the number of rows to send in a bulk copy operation. Bei Ausführung eines bcp in -Vorgangs entspricht die Batchgröße der Anzahl von Zeilen, die als eine Transaktion an den Server gesendet werden sollen, und ebenso der Anzahl von Zeilen, die gesendet werden müssen, bevor der Verteilungs-Agent eine bcp -Statusmeldung protokolliert.When performing a bcp in operation, the batch size is the number of rows to send to the server as one transaction, and also the number of rows that must be sent before the Distribution Agent logs a bcp progress message. Bei Ausführung eines bcp out -Vorgangs wird eine feste Batchgröße von 1000 verwendet.When performing a bcp out operation, a fixed batch size of 1000 is used. Durch den Wert 0 wird angezeigt, dass keine Meldungsprotokollierung ausgeführt wird.A value of 0 indicates no message logging.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
Der Pfad der Agentdefinitionsdatei.Is the path of the agent definition file. Eine Agentdefinitionsdatei enthält Befehlszeilenargumente für den Agent.An agent definition file contains command line arguments for the agent. Der Inhalt der Datei wird als ausführbare Datei analysiert.The content of the file is parsed as an executable file. Verwenden Sie doppelte Anführungszeichen ("), um Argumentwerte anzugeben, die beliebige Zeichen enthalten.Use double quotation marks (") to specify argument values containing arbitrary characters.

-Distributor server_name[ \ instance_name]-Distributor server_name[\instance_name]
Der Name des Verteilers.Is the Distributor name. Geben Sie server_name für die Standardinstanz von SQL ServerSQL Server auf diesem Server an.Specify server_name for the default instance of SQL ServerSQL Server on that server. Geben Sie server_name \ instance_name für eine benannte Instanz von SQL ServerSQL Server auf diesem Server an.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-DistributorDeadlockPriority [ -1|0|1]-DistributorDeadlockPriority [-1|0|1]
Die Priorität der Momentaufnahme-Agent-Verbindung mit dem Verteiler, wenn ein Deadlock auftritt.Is the priority of the Snapshot Agent connection to the Distributor when a deadlock occurs. Dieser Parameter wird angegeben, um Deadlocks zu beheben, die möglicherweise während der Momentaufnahmegenerierung zwischen dem Momentaufnahme-Agent und Benutzeranwendungen auftreten.This parameter is specified to resolve deadlocks that may occur between the Snapshot Agent and user applications during snapshot generation.

Wert von DistributorDeadlockPriorityDistributorDeadlockPriority value BESCHREIBUNGDescription
-1-1 Bei Auftreten eines Deadlocks auf dem Verteiler haben andere Anwendungen als der Momentaufnahme-Agent Priorität.Applications other than the Snapshot Agent have priority when a deadlock occurs at the Distributor.
0 (Standard)0 (Default) Es wird keine Priorität zugewiesen.Priority is not assigned.
11 Bei Auftreten eines Deadlocks auf dem Verteiler hat der Momentaufnahme-Agent Priorität.Snapshot Agent has priority when a deadlock occurs at the Distributor.

-DistributorLogin distributor_login-DistributorLogin distributor_login
Der Anmeldename, der verwendet wird, um mithilfe der SQL ServerSQL Server -Authentifizierung eine Verbindung mit dem Verteiler herzustellen.Is the login used when connecting to the Distributor using SQL ServerSQL Server Authentication.

-DistributorPassword distributor_password-DistributorPassword distributor_password
Das Kennwort, das verwendet wird, um mithilfe der SQL ServerSQL Server -Authentifizierung eine Verbindung mit dem Verteiler herzustellen.Is the password used when connecting to the Distributor using SQL ServerSQL Server Authentication. erforderlich..

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
Gibt den Sicherheitsmodus des Verteilers an.Specifies the security mode of the Distributor. Der Wert 0 steht für den SQL ServerSQL Server -Authentifizierungsmodus (Standard), der Wert 1 für den Windows-Authentifizierungsmodus.A value of 0 indicates SQL ServerSQL Server Authentication Mode (default), and a value of 1 indicates Windows Authentication Mode.

-DynamicFilterHostName dynamic_filter_host_name-DynamicFilterHostName dynamic_filter_host_name
Wird verwendet, um einen Wert für HOST_NAME (Transact-SQL) bei der Filterung festzulegen, wenn eine dynamische Momentaufnahme erstellt wird.Is used to set a value for HOST_NAME (Transact-SQL) in filtering when a dynamic snapshot is created. Wenn z. B. für einen Artikel die Teilmengenfilterklausel rep_id = HOST_NAME() angegeben wird und Sie die DynamicFilterHostName -Eigenschaft auf "FBJones" festlegen, bevor Sie den Merge-Agent aufrufen, werden nur Zeilen repliziert, in denen in der Spalte rep_id der Wert "FBJones" enthalten ist.For example, if the subset filter clause rep_id = HOST_NAME() is specified for an article, and you set the DynamicFilterHostName property to "FBJones" before calling the Merge Agent, only rows having "FBJones" in the rep_id column will be replicated.

-DynamicFilterLogin dynamic_filter_login-DynamicFilterLogin dynamic_filter_login
Wird verwendet, um einen Wert für SUSER_SNAME (Transact-SQL) bei der Filterung festzulegen, wenn eine dynamische Momentaufnahme erstellt wird.Is used to set a value for SUSER_SNAME (Transact-SQL)in filtering when a dynamic snapshot is created. Wenn z. B. für einen Artikel die Teilmengenfilterklausel user_id = SUSER_SNAME() angegeben wird und Sie die DynamicFilterLogin -Eigenschaft auf "rsmith" festlegen, bevor Sie die Run -Methode des SQLSnapshot -Objekts aufrufen, enthält die Momentaufnahme nur Zeilen, in denen in der Spalte user_id der Wert "rsmith" enthalten ist.For example, if the subset filter clause user_id = SUSER_SNAME() is specified for an article, and you set the DynamicFilterLogin property to "rsmith" before calling the Run method of the SQLSnapshot object, only rows having "rsmith" in the user_id column will be included in the snapshot.

-DynamicSnapshotLocation dynamic_snapshot_location-DynamicSnapshotLocation dynamic_snapshot_location
Der Speicherort, an dem die dynamische Momentaufnahme generiert werden soll.Is the location where the dynamic snapshot should be generated.

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
Dies ist die Verschlüsselungsebene der Transport Layer Security (TLS, früher als Secure Sockets Layer, SSL, bezeichnet), die vom Momentaufnahmen-Agent beim Herstellen von Verbindungen verwendet wird.Is the level of Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), encryption used by the Snapshot Agent when making connections.

Wert von EncryptionLevelEncryptionLevel value BESCHREIBUNGDescription
00 Gibt an, dass TLS nicht verwendet wird.Specifies that TLS is not used.
11 Gibt an, dass TLS verwendet wird, der Agent jedoch nicht überprüft, ob das TLS/SSL-Serverzertifikat von einem vertrauenswürdigen Aussteller signiert wurde.Specifies that TLS is used, but the agent does not verify that the TLS/SSL server certificate is signed by a trusted issuer.
22 Gibt an, dass TLS verwendet und das Zertifikat überprüft wird.Specifies that TLS is used, and that the certificate is verified.

Hinweis

Ein gültiges TLS/SSL-Zertifikat wird mit dem vollqualifizierten Domänennamen der SQL Server-Instanz definiert.A valid TLS/SSL certificate is defined with a fully qualified domain name of the SQL Server. Damit der Agent die Verbindung erfolgreich herstellen kann, wenn „-EncryptionLevel“ auf 2 festgelegt ist, sollten Sie einen Alias auf der lokalen SQL Server-Instanz erstellen.In order for the agent to connect successfully when setting -EncryptionLevel to 2, create an alias on the local 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.The ‘Alias Name’ parameter should be the server name and the ‘Server’ parameter should be set to the fully qualified name of the SQL Server.

Weitere Informationen finden Sie unter Anzeigen und Ändern von Replikationssicherheitseinstellungen.For more information, see View and modify replication security settings.

-FieldDelimiter field_delimiter-FieldDelimiter field_delimiter
Das Zeichen oder die Zeichenfolge, das bzw. die das Ende eines Felds in der SQL ServerSQL Server -Datendatei für das Massenkopieren markiert.Is the character or character sequence that marks the end of a field in the SQL ServerSQL Server bulk-copy data file. Der Standardwert ist \n<x$3>\n.The default is \n<x$3>\n.

-HistoryVerboseLevel [ 1| 2| 3]-HistoryVerboseLevel [ 1| 2| 3]
Gibt den Umfang des Verlaufs an, der während eines Momentaufnahmevorgangs protokolliert wird.Specifies the amount of history logged during a snapshot operation. Sie können die negativen Auswirkungen der Verlaufsprotokollierung auf die Leistung minimieren, indem Sie den Wert 1auswählen.You can minimize the effect of history logging on performance by selecting 1.

Wert von HistoryVerboseLevelHistoryVerboseLevel value BESCHREIBUNGDescription
00 Statusmeldungen werden entweder an der Konsole ausgegeben oder in eine Ausgabedatei geschrieben.Progress messages are written either to the console or to an output file. Verlaufsdatensätze werden nicht in der Verteilungsdatenbank protokolliert.History records are not logged in the distribution database.
11 Aktualisieren Sie immer eine vorherige Verlaufsmeldung mit dem gleichen Status (Start, Status, Erfolg usw.).Always update a previous history message of the same status (startup, progress, success, and so on). Wenn kein vorheriger Datensatz mit dem gleichen Status vorhanden ist, fügen Sie einen neuen Datensatz ein.If no previous record with the same status exists, insert a new record.
2 (Standardwert)2 (default) Fügen Sie neue Verlaufsdatensätze ein, es sei denn, der Datensatz bezieht sich z. B. auf Leerlaufmeldungen oder Meldungen zu Aufträgen mit langer Ausführungszeit. In diesen Fällen aktualisieren Sie die vorherigen Datensätze.Insert new history records unless the record is for such things as idle messages or long-running job messages, in which case update the previous records.
33 Fügen Sie immer neue Datensätze ein, es sei denn, ein Datensatz bezieht sich auf Leerlaufmeldungen.Always insert new records, unless it is for idle messages.

-HRBcpBlocks number_of_blocks-HRBcpBlocks number_of_blocks
Die Anzahl von bcp -Datenblöcken, die zwischen dem Lese- und dem Schreibthread in die Warteschlange gestellt werden.Is the number of bcp data blocks that are queued between the writer and reader threads. Der Standardwert lautet "50".The default value is 50. HRBcpBlocks wird nur mit Oracle-Veröffentlichungen verwendet.HRBcpBlocks is only used with Oracle publications.

Hinweis

Dieser Parameter wird zur Leistungsoptimierung für bcp von einem Oracle-Verleger verwendet.This parameter is used for performance tuning of bcp performance from an Oracle Publisher.

-HRBcpBlockSizeblock_size-HRBcpBlockSizeblock_size
Die Größe jedes einzelnen bcp -Datenblocks in Kilobytes (KB).Is the size, in kilobytes (KB), of each bcp data block. Der Standardwert ist 64 KB.The default value is 64 KB. HRBcpBlocks wird nur mit Oracle-Veröffentlichungen verwendet.HRBcpBlocks is only used with Oracle publications.

Hinweis

Dieser Parameter wird zur Leistungsoptimierung für bcp von einem Oracle-Verleger verwendet.This parameter is used for performance tuning of bcp performance from an Oracle Publisher.

-HRBcpDynamicBlocks-HRBcpDynamicBlocks
Gibt an, ob die Größe jedes einzelnen bcp -Datenblocks dynamisch zunehmen kann.Is whether or not the size of each bcp data block can grow dynamically. HRBcpBlocks wird nur mit Oracle-Veröffentlichungen verwendet.HRBcpBlocks is only used with Oracle publications.

Hinweis

Dieser Parameter wird zur Leistungsoptimierung für bcp von einem Oracle-Verleger verwendet.This parameter is used for performance tuning of bcp performance from an Oracle Publisher.

-KeepAliveMessageInterval keep_alive_interval-KeepAliveMessageInterval keep_alive_interval
Gibt an, wie viele Sekunden der Momentaufnahme-Agent wartet, bevor die Meldung, dass auf eine Back-End-Nachricht gewartet wird, in der MSsnapshot_history -Tabelle protokolliert wird.Is the amount of time, in seconds, that the Snapshot Agent waits before logging "waiting for backend message" to the MSsnapshot_history table. Der Standardwert beträgt 300 Sekunden.The default value is 300 seconds.

-LoginTimeOut login_time_out_seconds-LoginTimeOut login_time_out_seconds
Die Anzahl von Sekunden, nach denen ein Timeout bei der Anmeldung eintritt. Der Standardwert ist 15 Sekunden.Is the number of seconds before the login times out. The default is 15 seconds.

-MaxBcpThreads number_of_threads-MaxBcpThreads number_of_threads
Gibt die Anzahl von Massenkopiervorgängen an, die parallel ausgeführt werden können.Specifies the number of bulk copy operations that can be performed in parallel. Die maximale Anzahl von Threads und gleichzeitig vorhandenen ODBC-Verbindungen entspricht entweder MaxBcpThreads oder der Anzahl von Massenkopieranforderungen, die in der Verteilungsdatenbank in der Synchronisierungstransaktion enthalten sind. Dabei gilt der jeweils kleinere Wert.The maximum number of threads and ODBC connections that exist simultaneously is the lesser of MaxBcpThreads or the number of bulk copy requests that appear in the synchronization transaction in the distribution database. Der Wert vonMaxBcpThreads muss größer als 0 sein. Es ist keine hartcodierte Obergrenze vorhanden.MaxBcpThreads must have a value greater than 0 and has no hard-coded upper limit. Der Standardwert ist das Doppelte der Anzahl der Prozessoren.The default is twice the number of processors.

Hinweis

Wenn das replizierte Objekt über einen Filter verfügt, generiert der Momentaufnahme-Agent nur eine BCP-Datei für diesen Artikel, anstatt mehrere BCP-Dateien zu erstellen.If the replicated object has a filter, then the Snapshot agent will generate only one BCP file for that article instead of generating multiple BCP files.

- MaxNetworkOptimization [ 0| 1]- MaxNetworkOptimization [ 0| 1]
Wird verwendet, wenn irrelevante Löschvorgänge an den Abonnenten gesendet werden.Is if irrelevant deletes are sent to the Subscriber. Bei irrelevanten Löschvorgängen handelt es sich um DELETE-Befehle, die für Zeilen, die nicht zur Partition des Abonnenten gehören, an den Abonnenten gesendet werden.Irrelevant deletes are DELETE commands that are sent to Subscribers for rows that do not belong to the Subscriber's partition. Irrelevante Löschvorgänge beeinträchtigen weder die Datenintegrität noch die Konvergenz, allerdings können sie zu unnötigem Netzwerkverkehr führen.Irrelevant deletes do not affect data integrity or convergence, but they can result in unnecessary network traffic. Der Standardwert von MaxNetworkOptimization lautet 0.The default value of MaxNetworkOptimization is 0. Wenn Sie MaxNetworkOptimization auf 1 festlegen, minimieren Sie dadurch das Risiko irrelevanter Löschvorgänge, wodurch der Netzwerkverkehr verringert und eine Netzwerkoptimierung erzielt wird.Setting MaxNetworkOptimization to 1 minimizing the chances of irrelevant deletes thereby reducing network traffic and maximizing network optimization. Gleichzeitig werden bei Festlegung dieses Parameters auf 1 u. U. mehr Metadaten gespeichert, und auf dem Verleger kann es zu Leistungseinbußen kommen, wenn mehrere Ebenen von Joinfiltern und komplexe Teilmengenfilter vorhanden sind.Setting this parameter to 1 can also increase the storage of metadata and cause performance to degrade at the Publisher if multiple levels of join filters and complex subset filters are present. Daher sollten Sie die Replikationstopologie sorgfältig bewerten und MaxNetworkOptimization nur dann auf 1 festlegen, wenn durch irrelevante Löschvorgänge mehr Netzwerkverkehr entsteht, als akzeptabel ist.You should carefully assess your replication topology and set MaxNetworkOptimization to 1 only if network traffic from irrelevant deletes is unacceptably high.

Hinweis

Die Festlegung dieses Parameters auf 1 ist nur dann nützlich, wenn die Option zur Synchronisierungsoptimierung der Mergeveröffentlichung auf TRUE festgelegt ist (der Parameter @keep_partition_changes** von sp_addmergepublication (Transact-SQL)).Setting this parameter to 1 is useful only when the synchronization optimization option of the merge publication is set to true (the @keep_partition_changes** parameter of sp_addmergepublication (Transact-SQL)).

-Output output_path_and_file_name-Output output_path_and_file_name
Der Pfad der Agentausgabedatei.Is the path of the agent output file. Wenn kein Dateiname angegeben ist, wird die Ausgabe an die Konsole gesendet.If the file name is not provided, the output is sent to the console. Wenn eine Datei mit dem angegebenen Namen vorhanden ist, wird die Ausgabe an diese Datei angefügt.If the specified file name exists, the output is appended to the file.

-OutputVerboseLevel [ 0| 1| 2]-OutputVerboseLevel [ 0| 1| 2]
Gibt an, ob die Ausgabe ausführlich sein soll.Specifies whether the output should be verbose.

Wert von OutputVerboseLevelOutputVerboseLevel value BESCHREIBUNGDescription
00 Nur Fehlermeldungen werden gedruckt.Only error messages are printed.
1 (Standard)1 (default) Alle Statusberichtsmeldungen werden gedruckt (Standard).All the progress report messages are printed (default).
22 Alle Fehlermeldungen und Statusberichtsmeldungen werden gedruckt, was zum Debuggen nützlich ist.All error messages and progress report messages are printed, which is useful for debugging.

-PacketSize packet_size-PacketSize packet_size
Die vom Momentaufnahme-Agent beim Herstellen der Verbindung mit SQL ServerSQL Serververwendete Paketgröße (in Bytes).Is the packet size (in bytes) used by the Snapshot Agent when connecting to SQL ServerSQL Server. Der Standardwert ist 8192 Bytes.The default value is 8192 bytes.

Hinweis

Sie sollten die Paketgröße nur dann ändern, wenn Sie sicher sind, dass die Leistung dadurch verbessert werden kann.Do not change the packet size unless you are certain that it will improve performance. Für die meisten Anwendungen empfiehlt sich die Standardpaketgröße.For most applications, the default packet size is best.

-PrefetchTables [ 0| 1]-PrefetchTables [ 0| 1]
Optionaler Parameter, der angibt, ob die Tabellenobjekte vorab abgerufen und zwischengespeichert werden.Optional parameter that specifies if the table objects will be prefetched and cached. Standardmäßig werden bestimmte Tabelleneigenschaften mithilfe der SMO-Komponente basierend auf einer internen Berechnung vorab abgerufen.The default behavior is to prefetch certain table properties using SMO component based on an internal calculation. Dieser Parameter kann in Szenarios hilfreich sein, in denen die Ausführung des SMO-Vorabrufvorgangs erheblich länger dauert.This parameter can be helpful in scenarios where SMO prefetch operation takes considerable longer to run. Wenn dieser Parameter nicht verwendet wird, wird diese Entscheidung zur Laufzeit basierend auf dem Prozentsatz der Tabellen getroffen, die der Veröffentlichung als Artikel hinzugefügt werden.If this parameter is not used, this decision is made at runtime based on the percentage of tables that are added as articles to the publication.

Wert von OutputVerboseLevelOutputVerboseLevel value BESCHREIBUNGDescription
00 Der Aufruf der Prefetch-Methode der SMO-Komponente ist deaktiviert.Call to Prefetch method of SMO component is disabled.
11 Der Momentaufnahmen-Agent ruft die Prefetch-Methode auf, um einige Tabelleneigenschaften mithilfe von SMO zwischenzuspeichern.Snapshot Agent will call Prefetch method to cache some table properties using SMO

-ProfileName profile_name-ProfileName profile_name
Gibt ein Agentprofil an, das für Agentparameter verwendet werden soll.Specifies an agent profile to use for agent parameters. Wenn ProfileName den Wert NULL aufweist, wird das Agentprofil deaktiviert.If ProfileName is NULL, the agent profile is disabled. Wenn ProfileName nicht angegeben ist, wird das Standardprofil für den Agenttyp verwendet.If ProfileName is not specified, the default profile for the agent type is used. Weitere Informationen finden Sie unter Replication Agent Profiles.For information, see Replication Agent Profiles.

-PublisherDB publisher_database-PublisherDB publisher_database
Der Name der Veröffentlichungsdatenbank.Is the name of the publication database. Der Parameter wird von Oracle-Verlegern nicht unterstützt.This parameter is not supported for Oracle Publishers.

-PublisherDeadlockPriority [ -1|0|1]-PublisherDeadlockPriority [-1|0|1]
Die Priorität der Momentaufnahme-Agent-Verbindung mit dem Verleger, wenn ein Deadlock auftritt.Is the priority of the Snapshot Agent connection to the Publisher when a deadlock occurs. Dieser Parameter wird angegeben, um Deadlocks zu beheben, die möglicherweise während der Momentaufnahmegenerierung zwischen dem Momentaufnahme-Agent und Benutzeranwendungen auftreten.This parameter is specified to resolve deadlocks that may occur between the Snapshot Agent and user applications during snapshot generation.

Wert von PublisherDeadlockPriorityPublisherDeadlockPriority value BESCHREIBUNGDescription
-1-1 Bei Auftreten eines Deadlocks auf dem Verleger haben andere Anwendungen als der Momentaufnahme-Agent Priorität.Applications other than the Snapshot Agent have priority when a deadlock occurs at the Publisher.
0 (Standard)0 (Default) Es wird keine Priorität zugewiesen.Priority is not assigned.
11 Bei Auftreten eines Deadlocks auf dem Verleger hat der Momentaufnahme-Agent Priorität.Snapshot Agent has priority when a deadlock occurs at the Publisher.

-PublisherFailoverPartner server_name[ \ instance_name]-PublisherFailoverPartner server_name[\instance_name]
Gibt die Failoverpartnerinstanz von SQL ServerSQL Server an, die an einer Datenbank-Spiegelungssitzung mit der Veröffentlichungsdatenbank teilnimmt.Specifies the failover partner instance of SQL ServerSQL Server participating in a database mirroring session with the publication database. Weitere Informationen finden Sie unter Datenbankspiegelung und Replikation (SQL Server).For more information, see Database Mirroring and Replication (SQL Server).

-PublisherLogin publisher_login-PublisherLogin publisher_login
Der Anmeldename, der verwendet wird, um mithilfe der SQL ServerSQL Server -Authentifizierung eine Verbindung mit dem Verleger herzustellen.Is the login used when connecting to the Publisher using SQL ServerSQL Server Authentication.

-PublisherPassword publisher_password-PublisherPassword publisher_password
Das Kennwort, das verwendet wird, um mithilfe der SQL ServerSQL Server -Authentifizierung eine Verbindung mit dem Verleger herzustellen.Is the password used when connecting to the Publisher using SQL ServerSQL Server Authentication. ..

-PublisherSecurityMode [ 0| 1]-PublisherSecurityMode [ 0| 1]
Gibt den Sicherheitsmodus des Verlegers an.Specifies the security mode of the Publisher. Der Wert 0 steht für die SQL ServerSQL Server -Authentifizierung (Standard), der Wert 1 für den Windows-Authentifizierungsmodus.A value of 0 indicates SQL ServerSQL Server Authentication (default), and a value of 1 indicates Windows Authentication Mode.

-QueryTimeOut query_time_out_seconds-QueryTimeOut query_time_out_seconds
Die Anzahl von Sekunden, nach denen ein Timeout bei der Abfrage eintritt. Die Standardeinstellung ist 1800 Sekunden.Is the number of seconds before the query times out. The default is 1800 seconds.

-ReplicationType [ 1| 2]-ReplicationType [ 1| 2]
Gibt den Typ der Replikation an.Specifies the type of replication. Der Wert 1 steht für die Transaktionsreplikation, der Wert 2 für die Mergereplikation.A value of 1 indicates transactional replication, and a value of 2 indicates merge replication.

-RowDelimiter row_delimiter-RowDelimiter row_delimiter
Das Zeichen oder die Zeichenfolge, das bzw. die das Ende einer Zeile in der SQL ServerSQL Server -Datendatei für das Massenkopieren markiert.Is the character or character sequence that marks the end of a row in the SQL ServerSQL Server bulk-copy data file. Der Standardwert ist \n<,@g>\n.The default is \n<,@g>\n.

-StartQueueTimeout start_queue_timeout_seconds-StartQueueTimeout start_queue_timeout_seconds
Die maximale Anzahl von Sekunden, die der Momentaufnahmen-Agent wartet, wenn die Anzahl gleichzeitig ausgeführter dynamischer Momentaufnahmeprozesse den Grenzwert erreicht, der mit der Eigenschaft @max_concurrent_dynamic_snapshots von sp_addmergepublication (Transact-SQL) festgelegt wurde.Is the maximum number of seconds that the Snapshot Agent waits when the number of concurrent dynamic snapshot processes running is at the limit set by the @max_concurrent_dynamic_snapshots property of sp_addmergepublication (Transact-SQL). Wenn der Momentaufnahme-Agent nach Verstreichen der maximalen Anzahl von Sekunden immer noch wartet, wird der Agent beendet.If the maximum number of seconds is reached and the Snapshot Agent is still waiting, it will exit. Der Wert 0 bedeutet, dass der Agent unbegrenzt wartet, der Vorgang jedoch abgebrochen werden kann.A value of 0 means that the agent waits indefinitely, although it can be canceled.

- UsePerArticleContentsView use_per_article_contents_view- UsePerArticleContentsView use_per_article_contents_view
Dieser Parameter wurde als veraltet markiert und wird lediglich aus Gründen der Abwärtskompatibilität unterstützt.This parameter has been deprecated and is supported for backward-compatibility only.

BemerkungenRemarks

Wichtig

Wenn Sie den SQL ServerSQL Server -Agent so installiert haben, dass er unter einem lokalen Systemkonto und nicht unter einem Domänenbenutzerkonto (Standard) ausgeführt wird, kann der Dienst nur auf den lokalen Computer zugreifen.If you have installed SQL ServerSQL Server Agent to run under a Local System account rather than under a Domain User account (the default), the service can access only the local computer. Wenn der Momentaufnahme-Agent, der unter dem SQL ServerSQL Server -Agent ausgeführt wird, so konfiguriert ist, dass beim Anmelden bei SQL ServerSQL Serverder Windows-Authentifizierungsmodus verwendet wird, schlägt der Momentaufnahme-Agent fehl.If the Snapshot Agent that runs under SQL ServerSQL Server Agent is configured to use Windows Authentication Mode when it logs in to SQL ServerSQL Server, the Snapshot Agent fails. Die Standardeinstellung ist die SQL ServerSQL Server -Authentifizierung.The default setting is SQL ServerSQL Server Authentication.

Führen Sie zum Starten des Momentaufnahme-Agents von der Eingabeaufforderung snapshot.exe aus.To start the Snapshot Agent, execute snapshot.exe from the command prompt. Informationen hierzu finden Sie im Abschnitt zu den ausführbaren Dateien von Replikations-Agents.For information, see Replication Agent Executables.

Weitere InformationenSee Also

Replikations-Agent-VerwaltungReplication Agent Administration