Agente di lettura coda replicheReplication Queue Reader Agent

Agente di lettura coda repliche è un eseguibile che consente di leggere i messaggi archiviati in una coda MicrosoftMicrosoft SQL ServerSQL Server o MSMQ ( MicrosoftMicrosoft Message Queue) e di applicare tali messaggi nel server di pubblicazione.The Replication Queue Reader Agent is an executable that reads messages stored in a MicrosoftMicrosoft SQL ServerSQL Server queue or a MicrosoftMicrosoft Message Queue and then applies those messages to the Publisher. L'agente di lettura coda viene utilizzato con le pubblicazioni snapshot e transazionali che consentono l'aggiornamento in coda.Queue Reader Agent is used with snapshot and transactional publications that allow queued updating.

Nota

I parametri possono essere specificati in qualsiasi ordine.Parameters can be specified in any order. Quando i parametri facoltativi non vengono specificati, vengono utilizzati i valori predefiniti basati sul profilo agente predefinito.When optional parameters are not specified, predefined values based on the default agent profile are used.

SintassiSyntax


qrdrsvc [-?]  
[-Continuous]  
[-DefinitionFile definition_file]  
[-Distributor server_name[\instance_name]]  
[-DistributionDB distribution_database]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-LoginTimeOut login_time_out_seconds]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PollingInterval polling_interval]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-ProfileName agent_profile_name]  
[-QueryTimeOut query_time_out_seconds]  
[-ResolverState [1|2|3]]  

ArgomentiArguments

-?-?
Visualizza le informazioni sull'utilizzo.Displays usage information.

-Continuous-Continuous
Specifica se l'agente tenta di elaborare continuamente le transazioni in coda.Specifies whether the agent attempts to process queued transactions continuously. Se è specificato, l'agente continua l'esecuzione anche se non vi sono transazioni in coda in sospeso in alcuno dei Sottoscrittori.If specified, the agent continues execution even if there are no queued transactions pending from any of the subscribers.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
Percorso del file di definizione dell'agente.Is the path of the agent definition file. Un file di definizione dell'agente contiene argomenti della riga di comando per l'agente.An agent definition file contains command-line arguments for the agent. Il contenuto del file viene analizzato come file eseguibile.The content of the file is parsed as an executable file. Utilizzare virgolette doppie (") per specificare valori dell'argomento contenenti caratteri arbitrari.Use double quotation marks (") to specify argument values containing arbitrary characters.

-Distributor server_name[\instance_name]-Distributor server_name[\instance_name]
Nome del database di distribuzione.Is the Distributor name. Specificare server_name per l'istanza predefinita di SQL ServerSQL Server in tale server.Specify server_name for the default instance of SQL ServerSQL Server on that server. Specificare server_name\instance_name per un'istanza denominata di SQL ServerSQL Server in tale server.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server. Se non specificato, per impostazione predefinita viene utilizzato il nome dell'istanza predefinita di SQL ServerSQL Server nel computer locale.If not specified, the name defaults to the name of the default instance of SQL ServerSQL Server on the local computer.

-DistributionDB distribution_database-DistributionDB distribution_database
Database di distribuzione.Is the distribution database.

-DistributorLogin distributor_login-DistributorLogin distributor_login
Nome dell'account di accesso del database di distribuzione.Is the Distributor login name.

-DistributorPassword distributor_password-DistributorPassword distributor_password
Password del database di distribuzione.Is the Distributor password.

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
Specifica la modalità di sicurezza del database di distribuzione.Specifies the security mode of the Distributor. Un valore 0 indica la modalità di autenticazione di SQL ServerSQL Server (impostazione predefinita), mentre un valore 1 indica la modalità di autenticazione di Windows.A value of 0 indicates SQL ServerSQL Server Authentication Mode (default), and a value of 1 indicates Windows Authentication Mode.

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
Livello di crittografia SSL (Secure Sockets Layer) utilizzato dall'agente di lettura coda quando vengono stabilite le connessioni.Is the level of Secure Sockets Layer (SSL) encryption used by the Queue Reader Agent when making connections.

Valore di EncryptionLevelEncryptionLevel value DescrizioneDescription
00 Specifica che SSL non viene utilizzato.Specifies that SSL is not used.
11 Specifica che SSL viene utilizzato, ma l'agente non verifica che il certificato server SSL sia firmato da un'autorità emittente attendibile.Specifies that SSL is used, but the agent does not verify that the SSL server certificate is signed by a trusted issuer.
22 Specifica che SSL viene utilizzato e che il certificato viene verificato.Specifies that SSL is used, and that the certificate is verified.

Per altre informazioni, vedere Panoramica della sicurezza (replica).For more information, see Security Overview (Replication).

-HistoryVerboseLevel [ 0| 1| 2| 3]-HistoryVerboseLevel [ 0| 1| 2| 3]
Specifica la quantità di cronologia registrata durante un'operazione dell'agente di lettura coda.Specifies the amount of history logged during a queue reader operation. Per ridurre al minimo l'effetto della registrazione della cronologia sulle prestazioni, selezionare 1.You can minimize the effect of history logging on performance by selecting 1.

Valore di HistoryVerboseLevelHistoryVerboseLevel value DescrizioneDescription
00 Nessuna registrazione della cronologia (opzione non consigliata).No history logging (not recommended).
11 Valore predefinito.Default. Aggiorna sempre un messaggio di cronologia precedente con lo stesso stato (avvio, avanzamento, esito positivo e così via).Always update a previous history message of the same status (startup, progress, success, and so on). Se non è presente un record precedente con lo stesso stato, inserisce un nuovo record.If no previous record with the same status exists, insert a new record.
22 Inserisce nuovi record della cronologia, inclusi record per messaggi inattivi o messaggi di processo con esecuzione prolungata.Insert new history records, including idle messages or long-running job messages.
33 Inserisce nuovi record della cronologia che includono informazioni aggiuntive che potrebbero essere utili per la risoluzione dei problemi.Insert new history records that include additional details that may be useful for troubleshooting.

-LoginTimeOut login_time_out_seconds-LoginTimeOut login_time_out_seconds
Numero di secondi prima del timeout di accesso. Il valore predefinito è 15 secondi.Is the number of seconds before the login times out. The default is 15 seconds.

-Output output_path_and_file_name-Output output_path_and_file_name
Percorso del file di output dell'agente.Is the path of the agent output file. Se non viene specificato il nome file, l'output viene inviato alla console.If the file name is not provided, the output is sent to the console. Se il nome file specificato esiste già, l'output viene aggiunto al file.If the specified file name exists, the output is appended to the file.

-OutputVerboseLevel [ 0| 1| 2]-OutputVerboseLevel [ 0| 1| 2]
Specifica se l'output deve essere dettagliato.Specifies whether the output should be verbose. Se il livello di dettaglio è 0, vengono stampati solo i messaggi di errore.If the verbose level is 0, only error messages are printed. Se il livello di dettaglio è 1, vengono stampati tutti i messaggi di report di stato.If the verbose level is 1, all the progress report messages are printed. Se il livello di dettaglio è 2 (impostazione predefinita), vengono stampati tutti i messaggi di errore e i messaggi di report di stato. Questa opzione è utile per l'esecuzione del debug.If the verbose level is 2 (default), all error messages and progress report messages are printed, which is useful for debugging.

-PollingInterval polling_interval-PollingInterval polling_interval
Rilevante solo per sottoscrizioni aggiornabili che utilizzano code basate su SQL ServerSQL Server .Is relevant only for updating subscriptions that use SQL ServerSQL Server based queues. Specifica la frequenza, in secondi, di polling della coda SQL ServerSQL Server per le transazioni in coda in sospeso.Specifies how often, in seconds, the SQL ServerSQL Server queue is polled for pending queued transactions. Il valore può essere compreso tra 0 e 240 secondi.The value can be between 0 and 240 seconds. Il valore predefinito è 5 secondi.The default is 5 seconds.

-PublisherFailoverPartner server_name[\instance_name]-PublisherFailoverPartner server_name[\instance_name]
Specifica l'istanza del partner di failover di SQL ServerSQL Server che partecipa in una sessione di mirroring del database con il database di pubblicazione.Specifies the failover partner instance of SQL ServerSQL Server participating in a database mirroring session with the publication database. Per altre informazioni, vedere Database Mirroring and Replication (SQL Server).For more information, see Database Mirroring and Replication (SQL Server).

-ProfileName agent_profile_name-ProfileName agent_profile_name
Nome di un profilo agente utilizzato per fornire un set di valori predefiniti all'agente.Is the name of an agent profile used to supply a set of default values to the agent. Per altre informazioni, vedere Profili degli agenti di replica.For information, see Replication Agent Profiles.

-QueryTimeOut query_time_out_seconds-QueryTimeOut query_time_out_seconds
Numero di secondi prima del timeout delle query. Il valore predefinito è 1800 secondi.Is the number of seconds before the query times out. The default is 1800 seconds.

-ResolverState [ 1| 2| 3]-ResolverState [ 1| 2| 3]
Specifica in che modo vengono risolti i conflitti degli aggiornamenti in coda.Specifies how queued updating conflicts are resolved. Un valore 1 indica che il conflitto viene vinto dal server di pubblicazione e che verrà eseguito il rollback della transazione in coda in conflitto corrente nel server di pubblicazione e nel Sottoscrittore di aggiornamento di origine. L'elaborazione delle transazioni in coda successive continuerà.A value of 1 indicates the Publisher wins the conflict, and the current conflicting queued transaction will be rolled back on the Publisher and the originating updating Subscriber; the processing of subsequent queued transactions will continue. Un valore 2 indica che il conflitto viene vinto dal Sottoscrittore e che la transazione in coda sostituirà i valori nel server di pubblicazione.A value of 2 indicates the Subscriber wins the conflict, and the queued transaction will override the values on the Publisher. Un valore 3 indica che qualsiasi conflitto comporterà la reinizializzazione del Sottoscrittore. Il conflitto viene vinto dal server di pubblicazione, l'elaborazione delle transazioni in coda successive verrà interrotta e la sottoscrizione verrà reinizializzata.A value of 3 indicates that any conflict will result in Subscriber re-initialization; the Publisher wins the conflict, processing of subsequent queued transactions will be terminated, and the subscription will be reinitialized. L'impostazione predefinita è 1 per le pubblicazioni transazionali e 3 per le pubblicazioni snapshot.The default setting is 1 for transactional publications and 3 for snapshot publications.

OsservazioniRemarks

Per avviare l'agente di lettura coda, eseguire qrdrsvc.exe dal prompt dei comandi.To start the Queue Reader Agent, execute qrdrsvc.exe from the command prompt. Per informazioni, vedere File eseguibili dell'Agente di replica.For information, see Replication Agent Executables.

Vedere ancheSee Also

Amministrazione dell'agente di replicaReplication Agent Administration