Agente di lettura coda repliche
Si applica a: 
SQL Server
L'agente di lettura coda repliche è un eseguibile che consente di leggere i messaggi archiviati in una coda o Message Queue e di applicare tali messaggi al server di pubblicazione. L'agente di lettura coda viene utilizzato con le pubblicazioni snapshot e transazionali che consentono l'aggiornamento in coda.
Nota
I parametri possono essere specificati in qualsiasi ordine. Quando i parametri facoltativi non vengono specificati, vengono utilizzati i valori predefiniti basati sul profilo agente predefinito.
Sintassi
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]]
Argomenti
-?
Visualizza informazioni sull'utilizzo.
-Continuous
Specifica se l'agente tenta di elaborare continuamente le transazioni in coda. Se è specificato, l'agente continua l'esecuzione anche se non vi sono transazioni in coda in sospeso in alcuno dei Sottoscrittori.
-DefinitionFile def_path_and_file_name
Percorso del file di definizione dell'agente. Un file di definizione dell'agente contiene argomenti della riga di comando per l'agente. Il contenuto del file viene analizzato come file eseguibile. Utilizzare virgolette doppie (") per specificare valori dell'argomento contenenti caratteri arbitrari.
-Distributor server_name[\instance_name]
Nome del database di distribuzione. Specificare server_name per l'istanza predefinita di SQL Server in tale server. Specificare server_name instance_name\ per un'istanza denominata di SQL Server in tale server. Se non specificato, il nome viene impostato per impostazione predefinita sul nome dell'istanza predefinita di SQL Server nel computer locale.
-DistributionDB distribution_database
Database di distribuzione.
-DistributorLogin distributor_login
Nome dell'account di accesso del database di distribuzione.
-DistributorPassword distributor_password
Password del database di distribuzione.
-DistributorSecurityMode [ 0| 1]
Specifica la modalità di sicurezza del database di distribuzione. Il valore 0 indica la modalità di autenticazione di SQL Server (impostazione predefinita) e il valore 1 indica la modalità di autenticazione di Windows.
-EncryptionLevel [ 0 | 1 | 2 ]
Livello di crittografia TLS (Transport Layer Security), noto in precedenza come SSL (Secure Sockets Layer), usato dall'agente di lettura coda quando vengono stabilite le connessioni.
| Valore di EncryptionLevel | Descrizione |
|---|---|
| 0 | Specifica che TLS non viene usato. |
| 1 | Specifica che TLS viene usato, ma l'agente non verifica che il certificato server TLS/SSL sia firmato da un'autorità di certificazione attendibile. |
| 2 | Specifica che TLS viene usato e che il certificato viene verificato. |
Nota
Un certificato TLS/SSL valido è definito con un nome di dominio completo di SQL Server. Affinché l'agente possa connettersi correttamente quando si imposta - EncryptionLevel su 2, creare un alias nel Server SQL locale. Il parametro 'Nome alias' deve corrispondere al nome del server e il parametro 'Server' deve essere impostato sul nome completo dell'istanza di SQL Server.
Per altre informazioni, vedere Visualizzare e modificare le impostazioni di sicurezza della replica.
-HistoryVerboseLevel [ 0| 1| 2| 3]
Specifica la quantità di cronologia registrata durante un'operazione dell'agente di lettura coda. Per ridurre al minimo l'effetto della registrazione della cronologia sulle prestazioni, selezionare 1.
| Valore di HistoryVerboseLevel | Descrizione |
|---|---|
| 0 | Nessuna registrazione della cronologia (opzione non consigliata). |
| 1 | Predefinito. Aggiorna sempre un messaggio di cronologia precedente con lo stesso stato (avvio, avanzamento, esito positivo e così via). Se non è presente un record precedente con lo stesso stato, inserisce un nuovo record. |
| 2 | Inserisce nuovi record della cronologia, inclusi record per messaggi inattivi o messaggi di processo con esecuzione prolungata. |
| 3 | Inserisce nuovi record della cronologia che includono informazioni aggiuntive che potrebbero essere utili per la risoluzione dei problemi. |
-LoginTimeOut login_time_out_seconds
Numero di secondi prima del timeout dell'accesso. Il valore predefinito è 15 secondi.
-Output output_path_and_file_name
Percorso del file di output dell'agente. Se non viene specificato il nome file, l'output viene inviato alla console. Se il nome file specificato esiste già, l'output viene aggiunto al file.
-OutputVerboseLevel [ 0| 1| 2]
Specifica se l'output deve essere dettagliato. Se il livello di dettaglio è 0, vengono stampati solo i messaggi di errore. Se il livello di dettaglio è 1, vengono stampati tutti i messaggi di report di stato. 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.
-PollingInterval polling_interval
È rilevante solo per l'aggiornamento delle sottoscrizioni che usano code basate su SQL Server. Specifica la frequenza, in secondi, del polling della coda di SQL Server per le transazioni in coda in sospeso. Il valore può essere compreso tra 0 e 240 secondi. Il valore predefinito è 5 secondi.
-PublisherFailoverPartner server_name[\instance_name]
Specifica l'istanza partner di failover di SQL Server che partecipa a una sessione di mirroring del database con il database di pubblicazione. Per altre informazioni, vedere Mirroring e replica del database (SQL Server).
-ProfileName agent_profile_name
Nome di un profilo agente utilizzato per fornire un set di valori predefiniti all'agente. Per altre informazioni, vedere Profili degli agenti di replica.
-QueryTimeOut query_time_out_seconds
Numero di secondi prima del timeout della query. Il valore predefinito è 1800 secondi.
-ResolverState [ 1| 2| 3]
Specifica in che modo vengono risolti i conflitti degli aggiornamenti in coda. 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à. Un valore 2 indica che il conflitto viene vinto dal Sottoscrittore e che la transazione in coda sostituirà i valori nel server di pubblicazione. 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. L'impostazione predefinita è 1 per le pubblicazioni transazionali e 3 per le pubblicazioni snapshot.
Osservazioni:
Per avviare l'agente di lettura coda, eseguire qrdrsvc.exe dal prompt dei comandi. Per informazioni, vedere File eseguibili dell'Agente di replica.