• Articolo

Agente lettura coda repliche

Agente lettura coda repliche è un eseguibile che consente di leggere i messaggi archiviati in una coda Microsoft SQL Server o MSMQ (Microsoft Message Queue) e di applicare tali messaggi nel 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 le 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.

  • -DefinitionFiledef_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.

  • -Distributorserver_name[**\**instance_name]
    Nome del server 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, per impostazione predefinita viene utilizzato il nome dell'istanza predefinita di SQL Server nel computer locale.

  • -DistributionDBdistribution_database
    Database di distribuzione.

  • -DistributorLogindistributor_login
    Nome dell'account di accesso del server di distribuzione.

  • -DistributorPassworddistributor_password
    Password del server di distribuzione.

  • -DistributorSecurityMode [ 0| 1]
    Specifica la modalità di protezione del server di distribuzione. Un valore 0 indica la modalità di autenticazione di SQL Server (impostazione predefinita), mentre un valore 1 indica la modalità di autenticazione di Windows.

  • -EncryptionLevel [ 0 | 1 | 2 ]
    Livello di crittografia SSL (Secure Sockets Layer) utilizzato dall'agente di lettura coda quando vengono stabilite le connessioni.

    Valore di EncryptionLevel

    Descrizione

    0

    Specifica che SSL non viene utilizzato.

    1

    Specifica che SSL viene utilizzato, ma l'agente non verifica che il certificato server SSL sia firmato da un'autorità emittente attendibile.

    2

    Specifica che SSL viene utilizzato e che il certificato viene verificato.

    Per ulteriori informazioni, vedere Panoramica della protezione (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

    Valore 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.

  • -LoginTimeOutlogin_time_out_seconds
    Numero di secondi prima del timeout di accesso. Il valore predefinito è 15 secondi.

  • -Outputoutput_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.

  • -PollingIntervalpolling_interval
    Rilevante solo per sottoscrizioni aggiornabili che utilizzano code basate su SQL Server. Specifica la frequenza, in secondi, di polling della coda SQL Server per le transazioni in coda in sospeso. Il valore può essere compreso tra 0 e 240 secondi. Il valore predefinito è 5 secondi.

  • -PublisherFailoverPartnerserver_name[**\**instance_name]
    Specifica l'istanza del partner di failover di SQL Server che partecipa in una sessione di mirroring del database con il database di pubblicazione. Per ulteriori informazioni, vedere Replica e mirroring del database.

  • -ProfileNameagent_profile_name
    Nome di un profilo agente utilizzato per fornire un insieme di valori predefiniti all'agente. Per informazioni, vedere Profili degli agenti di replica.

  • -QueryTimeOutquery_time_out_seconds
    Numero di secondi prima del timeout delle 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.