Risoluzione dei problemi: Trovare gli errori con la replica transazionale di SQL Server

Si applica a:SQL ServerIstanza gestita di SQL di Azure

La risoluzione degli errori di replica può risultare frustrante senza una conoscenza di base del funzionamento della replica transazionale. Il primo passaggio per la creazione di una pubblicazione prevede che l'agente di snapshot crei lo snapshot e lo salvi nella cartella degli snapshot. Successivamente, l'agente di distribuzione applica lo snapshot al sottoscrittore.

Questo processo crea la pubblicazione e la pone nello stato di sincronizzazione in corso. La sincronizzazione funziona in tre fasi:

  1. Le transazioni vengono eseguite su oggetti replicati e contrassegnati "per la replica" nel log delle transazioni.
  2. L'agente di lettura log esegue l'analisi del log delle transazioni ed esegue una ricerca delle transazioni contrassegnate “per la replica”. Quelle transazioni vengono poi salvate sul database di distribuzione.
  3. L'agente di distribuzione esegue un'analisi del database di distribuzione tramite il thread di lettura. Quindi, usando il thread di scrittura, questo agente si connette al sottoscrittore per applicare tali modifiche nel sottoscrittore.

Gli errori possono verificarsi in qualsiasi passaggio del processo. Trovare questi errori può essere l'aspetto più complesso della risoluzione dei problemi di sincronizzazione. Fortunatamente, l'uso di Monitoraggio replica semplifica questo processo.

Nota

  • Lo scopo di questa guida alla risoluzione dei problemi è insegnare una metodologia di risoluzione dei problemi. Non è progettata per risolvere errori specifici, ma per fornire indicazioni generali per l'individuazione degli errori con la replica. Vengono forniti alcuni esempi specifici, ma la loro risoluzione può variare a seconda dell'ambiente.
  • Gli errori riportati in questa guida come esempi sono basati sull'esercitazione Configurare la replica tra due server sempre connessi (replica transazionale).

Metodologia di risoluzione degli errori

Domande da porsi

  1. In quale fase del processo di sincronizzazione si verificano errori della replica?
  2. Per quale agente si verifica un errore?
  3. Quando ha funzionato correttamente la replica per l'ultima volta? Cosa è cambiato da allora?

Passaggi da eseguire

  1. Usa Monitoraggio replica per identificare il punto in cui la replica riscontra l'errore (quale agente?):
    • Se gli errori si verificano nella sezione Dal server di pubblicazione al database di distribuzione, il problema riguarda l'agente di lettura log.
    • Se gli errori si verificano nella sezione Dal database di distribuzione al Sottoscrittore, il problema riguarda l'agente di distribuzione.
  2. Esaminare la cronologia dei processi dell'agente in Monitoraggio attività processi per identificare i dettagli dell'errore. Se la cronologia processo non mostra dettagli sufficienti, è possibile abilitare la registrazione dettagliata per tale agente specifico.
  3. Provare a determinare una soluzione per l'errore.

Trovare gli errori che riguardano l'agente di snapshot

L'agente di snapshot genera lo snapshot e lo scrive nella cartella degli snapshot specificata.

  1. Visualizzare lo stato dell'agente di snapshot:

    a. In Esplora oggetti espandere il nodo Pubblicazione locale in Replica.

    b. Fare clic con il pulsante destro del mouse sulla pubblicazione AdvWorksProductTrans>Visualizza stato agente snapshot.

    Screenshot del comando Visualizza agente di snapshot stato nel menu di scelta rapida.

  2. Se nello stato dell'agente di snapshot viene segnalato un errore, è possibile trovare altri dettagli nella cronologia processo dell'agente di snapshot:

    a. Espandere SQL Server Agent in Esplora oggetti e aprire Monitoraggio attività processi.

    b. Ordinare per Categoria e identificare l'agente di snapshot in base alla categoria REPL-Snapshot.

    c. Fare clic con il pulsante destro del mouse sull'agente di snapshot e quindi scegliere Visualizza cronologia.

    Screenshot delle selezioni per l'apertura della cronologia agente di snapshot.

  3. Nella cronologia dell'agente di snapshot selezionare la voce di log pertinente, in genere una o due righe prima della voce che segnala l'errore. (Una X rossa indica errore) Esamina il testo del messaggio nella casella di testo sotto i log:

    Screenshot dell'errore di agente di snapshot per l'accesso negato.

    The replication agent had encountered an exception.
    Exception Message: Access to path '\\node1\repldata.....' is denied.
    

Se le autorizzazioni di Windows dell'utente per la cartella degli snapshot non sono configurate correttamente, verrà visualizzato l'errore "accesso negato" per l'agente di snapshot. È necessario verificare le autorizzazioni per la cartella in cui viene archiviato lo snapshot e assicurarsi che l'account usato per eseguire l'agente di snapshot abbia le autorizzazioni per accedere alla condivisione.

Trovare gli errori che riguardano l'agente di lettura log

L'agente di lettura log si connette al database del server di pubblicazione e analizza il log delle transazioni per tutte le transazioni contrassegnate "per la replica". Poi aggiunge quelle transazioni al database di distribuzione.

  1. Connetti il server di pubblicazione in SQL Server Management Studio. Espandere il nodo server, fare clic con il pulsante destro del mouse sulla cartella Replica e quindi selezionare Avvia Monitoraggio replica:

    Screenshot del comando

    Si apre Monitoraggio replica:

    Screenshot di Monitoraggio replica.

  2. La X rossa indica che la pubblicazione non viene sincronizzata. Espandere Server di pubblicazione personali sul lato sinistro e quindi espandere il server di pubblicazione pertinente.

  3. Selezionare la pubblicazione AdvWorksProductTrans a sinistra e quindi cercare la X rossa in una delle schede per identificare dove risiede il problema. In questo caso, la X rossa è nella scheda Agenti e indica che uno degli agenti sta riscontrando un errore:

    Screenshot di Red X nella scheda

  4. Selezionare la scheda Agenti per identificare l'agente per il quale è stato rilevato l'errore:

    Screenshot di Red X nell'agente di lettura log non riuscito in Monitoraggio replica.

  5. Questa visualizzazione mostra due agenti, l'agente di snapshot e l'agente di lettura log. Quello che ha riscontrato un errore è contrassegnato con la X rossa. In questo caso, si tratta dell'agente di lettura log.

    Fare doppio clic sulla riga con la segnalazione dell'errore per aprire la cronologia per l'agente di lettura log. Questa cronologia offre altre informazioni sull'errore:

    Screenshot dei dettagli dell'errore per l'agente di lettura log.

    Status: 0, code: 20011, text: 'The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.'.
    The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.
    Status: 0, code: 15517, text: 'Cannot execute as the database principal because the principal "dbo" does not exist, this type of principal cannot be impersonated, or you do not have permission.'.
    Status: 0, code: 22037, text: 'The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.'.        
    
  6. L'errore si verifica in genere quando il proprietario del server di pubblicazione non è impostato correttamente. Questa situazione può verificarsi quando un database viene ripristinato. Per verificare ciò:

    a. Espandere Database in Esplora oggetti.

    b. Fai clic con il pulsante destro del mouse su AdventureWorks2012>Proprietà.

    c. Verificare l'esistenza di un proprietario nella pagina File. Se questa casella è vuota, questa è la causa probabile del problema.

    Screenshot della pagina

  7. Se il proprietario è vuoto nella pagina File, apri una finestra Nuova query all'interno del contesto del database AdventureWorks2022. Eseguire il codice T-SQL seguente:

    -- set the owner of the database to 'sa' or a specific user account, without the brackets. 
    EXECUTE sp_changedbowner '<useraccount>'
    -- example for sa: exec sp_changedbowner 'sa'
    -- example for user account: exec sp_changedbowner 'sqlrepro\administrator' 
    
  8. Potrebbe essere necessario riavviare l'agente di lettura log:

    a. Espandere il nodo SQL Server Agent in Esplora oggetti e aprire Monitoraggio attività processi.

    b. Ordinare per Categoria e identificare l'agente di lettura log in base alla categoria REPL-LogReader.

    c. Fare clic con il pulsante destro del mouse sul processo dell'agente di lettura log e scegliere Inizia processo al passaggio.

    Screenshot delle selezioni per riavviare l'agente di lettura log.

  9. Verificare che la pubblicazione venga ora sincronizzata aprendo di nuovo Monitoraggio replica. Se non è già aperto, è possibile trovarlo facendo clic con il pulsante destro del mouse su Replica in Esplora oggetti.

  10. Selezionare la pubblicazione AdvWorksProductTrans, selezionare la scheda Agenti e fare doppio clic sull'agente di lettura log per aprire la cronologia dell'agente. È ora possibile vedere l'agente di lettura log in esecuzione, nonché i comandi di replica oppure il messaggio "Nessuna transazione replicata disponibile":

    Screenshot dell'agente di lettura log in esecuzione senza transazioni replicate.

Trovare gli errori che riguardano l'agente di distribuzione

L'agente di distribuzione trova i dati nel database di distribuzione e quindi li applica al sottoscrittore.

  1. Connetti il server di pubblicazione in SQL Server Management Studio. Espandere il nodo del server, fare clic con il pulsante destro del mouse sulla cartella Replica e quindi scegliere Avvia Monitoraggio replica.

  2. In Monitoraggio replica, seleziona la pubblicazione AdvWorksProductTrans e seleziona la scheda Tutte le sottoscrizioni. Fai clic con il pulsante destro sulla sottoscrizione e seleziona Visualizza dettagli:

    Screenshot del comando

  3. Verrà visualizzata la finestra di dialogo Cronologia database di distribuzione - Sottoscrittore con chiarimenti sull'errore riscontrato dall'agente:

    Screenshot dei dettagli dell'errore per il agente di distribuzione.

    Error messages:
    Agent 'NODE1\SQL2016-AdventureWorks2022-AdvWorksProductTrans-NODE2\SQL2016-7' is retrying after an error. 89 retries attempted. See agent job history in the Jobs folder for more details.
    
  4. L'errore indica che l'agente di distribuzione esegue nuovi tentativi. Per trovare altre informazioni, controllare la cronologia processo dell'agente di distribuzione:

    a. Espandi SQL Server Agent in Esplora oggetti > >Monitoraggio attività processi.

    b. Ordinare i processi per Categoria.

    c. Identificare l'agente di distribuzione in base alla categoria REPL-Distribution. Fare clic con il pulsante destro del mouse sull'agente e scegliere Visualizza cronologia.

    Screenshot delle selezioni per visualizzare la cronologia agente di distribuzione.

  5. Selezionare una delle voci dell'errore e visualizzare il testo corrispondente nella parte inferiore della finestra:

    Screenshot del testo errore che indica una password errata per l'agente di distribuzione.

    Message:
    Unable to start execution of step 2 (reason: Error authenticating proxy NODE1\repl_distribution, system error: The user name or password is incorrect.)
    
  6. Questo errore indica che la password usata dall'agente di distribuzione non è corretta. Per risolvere questo errore:

    a. Espandere il nodo Replica in Esplora oggetti.

    b. Fai clic con il pulsante destro del mouse sulla sottoscrizione >Proprietà.

    c. Selezionare i puntini di sospensione (...) accanto ad Account processo agente e modificare la password.

    Screenshot delle selezioni per la modifica della password per il agente di distribuzione.

  7. Controllare di nuovo Monitoraggio replica facendo clic con il pulsante destro del mouse su Replica in Esplora oggetti. Una X rossa in Tutte le sottoscrizioni indica che l'agente di distribuzione sta ancora riscontrando un errore.

    Aprire la cronologia Da database di distribuzione a Sottoscrittore facendo clic con il pulsante destro del mouse sulla sottoscrizione in Monitoraggio replica>Visualizza dettagli. In questo caso, l'errore è diverso:

    Screenshot dell'errore che indica che il agente di distribuzione non è in grado di connettersi.

    Connecting to Subscriber 'NODE2\SQL2016'        
    Agent message code 20084. The process could not connect to Subscriber 'NODE2\SQL2016'.
    Number:  18456
    Message: Login failed for user 'NODE2\repl_distribution'.
    
  8. Questo errore indica che l'agente di distribuzione non è in grado di connettersi al sottoscrittore, perché l'accesso non è riuscito per l'utente NODE2\repl_distribution. Per analizzare ulteriormente il problema, connettersi al sottoscrittore e aprire il log degli errori di SQL Server corrente nel nodo Gestione in Esplora oggetti:

    Screenshot dell'errore che indica che l'account di accesso non è riuscito per il sottoscrittore.

    Se viene visualizzato questo errore, l'account di accesso risulta mancante nel sottoscrittore. Per correggere l'errore, vedere Autorizzazioni per la replica.

  9. Dopo aver risolto l'errore di accesso, controllare di nuovo Monitoraggio replica. Se tutti i problemi sono stati risolti, si noterà una freccia verde accanto al nome della pubblicazione e lo stato In esecuzione in Tutte le sottoscrizioni.

    Fare clic con il pulsante destro del mouse sulla sottoscrizione per avviare di nuovo la cronologia Dal database di distribuzione al Sottoscrittore e verificare l'esito positivo. Se si tratta della prima esecuzione dell'agente di distribuzione, si noterà che è stata eseguita la copia bulk dello snapshot nel sottoscrittore:

    Screenshot di agente di distribuzione con lo stato

Abilitare la registrazione dettagliata per qualsiasi agente

È possibile usare la registrazione dettagliata per visualizzare informazioni più dettagliate sugli errori che si verificano con qualsiasi agente nella topologia di replica. I passaggi sono gli stessi per ogni agente. È sufficiente assicurarsi di selezionare l'agente corretto in Monitoraggio attività processi.

Nota

Gli agenti possono trovarsi nel server di pubblicazione o nel sottoscrittore, in base al fatto che si tratti di una sottoscrizione pull o push. Se l'agente non è disponibile nel server che si sta esaminando, controllare l'altro server.

  1. Decidere dove si vuole salvare la registrazione dettagliata e verificare che la cartella esista. Questo esempio usa c:\temp.

  2. Espandere il nodo SQL Server Agent in Esplora oggetti e aprire Monitoraggio attività processi.

    Screenshot del comando

  3. Ordinare per Categoria e identificare l'agente di interesse. Questo esempio usa l'agente di lettura log. Fai clic con il pulsante destro del mouse sull'agente di interesse >Proprietà.

    Screenshot delle selezioni per aprire le proprietà dell'agente.

  4. Selezionare la pagina Passaggi ed evidenziare il passaggio Esecuzione dell'agente. Seleziona Modifica

    Screenshot delle selezioni per la modifica del passaggio

  5. Nella casella Comando iniziare una nuova riga, immettere il testo seguente e selezionare OK:

    -Output C:\Temp\OUTPUTFILE.txt -Outputverboselevel 3
    

    È possibile modificare il percorso e il livello di dettaglio in base alle proprie preferenze.

    Screenshot dell'output dettagliato nelle proprietà per il passaggio del processo.

    Nota

    Quando si aggiunge il parametro di output dettagliato, è possibile che l'agente non riesca o che il file outfile sia mancante:

    • È presente un problema di formattazione a causa del quale il trattino diventa un segno meno.
    • Il percorso non esiste nel disco o l'account che esegue l'agente non ha le autorizzazioni per scrivere nel percorso specificato.
    • Manca uno spazio tra l'ultimo parametro e il parametro -Output.
    • Agenti diversi supportano diversi livelli di dettaglio. Se si abilita la registrazione dettagliata, ma l'agente non viene avviato, provare a diminuire il livello di dettaglio specificato di 1.
  6. Riavvia l'agente di lettura log facendo clic con il pulsante destro del mouse sull'agente >Arresta processo al passaggio. Aggiornare selezionando l'icona Aggiorna sulla barra degli strumenti. Fai clic con il pulsante destro del mouse sull'agente >Inizia processo al passaggio.

  7. Esaminare l'output su disco.

    Screenshot del file di testo di output.

  8. Per disabilitare la registrazione dettagliata, seguire gli stessi passaggi precedenti per rimuovere l'intera riga -Output aggiunta in precedenza.

Ottenere aiuto

Contribuire alla documentazione di SQL

Il contenuto SQL può essere modificato. L'autore delle modifiche contribuirà a migliorare la documentazione e verrà accreditato come collaboratore alla realizzazione della pagina.

Per maggiori informazioni, vedere Come contribuire alla documentazione di SQL Server