Traccia dati in ADO.NET

ADO.NET include la nuova funzionalità di analisi dei dati predefinita supportata dai provider di dati .NET per SQL Server, Oracle, OLE DB e ODBC, nonché dall'oggetto DataSet di ADO.NET e dai protocolli di rete di SQL Server.

L'analisi delle chiamate API di accesso ai dati consente di diagnosticare i seguenti problemi:

  • Mancata corrispondenza di schema tra il programma client e il database.

  • Database non disponibile o problemi nella libreria di rete.

  • Sintassi SQL non corretta definita a livello di codice o generata da un'applicazione.

  • Logica di programmazione non corretta.

  • Problemi risultanti dall'interazione tra più componenti ADO.NET o tra ADO.NET e i componenti dell'utente.

Per supportare tecnologie di traccia diverse, questa funzionalità è estensibile, pertanto uno sviluppatore può tracciare un problema a qualsiasi livello dello stack dell'applicazione. Sebbene la funzionalità di analisi non sia esclusiva di ADO.NET, i provider Microsoft usano l'analisi generalizzata e le API della strumentazione.

Per altre informazioni sull'impostazione e sulla configurazione dell'analisi gestita in ADO.NET 2.0, vedere Analisi di accesso ai dati.

Accesso alle informazioni di diagnostica nel registro eventi estesi

Nel provider di dati di .NET Framework per SQL Server, l'analisi dell'accesso ai dati (Analisi di accesso ai dati) è stata aggiornata per rendere più facile correlare gli eventi client con le informazioni diagnostiche, ad esempio errori di connessione, informazioni del buffer circolare di connettività del server e informazioni sulle prestazioni dell'applicazione nel registro eventi esteso. Per ulteriori informazioni sulla lettura del log degli eventi estesi, vedere View Event Session Data (Visualizzare i dati di una sessione di eventi).

Per le operazioni di connessione, ADO.NET invierà un ID della connessione client. In caso di errore di connessione, è possibile accedere al buffer circolare della connettività (Risoluzione dei problemi relativi alla connettività in SQL Server 2008 con il buffer circolare della connettività), individuare il campo ClientConnectionID e ottenere le informazioni di diagnostica sul problema di connessione. Gli ID di connessione client vengono registrati nel buffer circolare solo se si verifica un errore. Se la connessione non riesce prima di inviare il pacchetto di preaccesso, non verrà generato un ID di connessione client. L'ID di connessione client è un GUID a 16 byte. È anche possibile trovare l'ID di connessione client nell'output di destinazione di eventi estesi, se l'azione client_connection_id viene aggiunta agli eventi in una sessione di eventi estesi. È possibile abilitare l'analisi di accesso ai dati ed eseguire di nuovo il comando di connessione e osservare il campo ClientConnectionID nell'analisi di accesso ai dati, se si necessita di ulteriore assistenza per la diagnostica dei driver del client.

È possibile ottenere l'ID di connessione cliente a livello di codice usando la proprietà SqlConnection.ClientConnectionID.

ClientConnectionID è disponibile per un oggetto di SqlConnection che stabilisce correttamente una connessione. Se un tentativo di connessione non riesce, ClientConnectionID può essere disponibile tramite SqlException.ToString.

ADO.NET invia inoltre un ID di attività specifico del thread. L'ID attività viene acquisito nelle sessioni di eventi estesi se le sessioni sono avviate con l'opzione TRACK_CAUSALITY abilitata. Per problemi di prestazioni con una connessione attiva, è possibile ottenere l'ID attività dalla traccia di accesso ai dati del client (campoActivityID) e individuare quindi l'ID attività nell'output degli eventi estesi. L'ID attività negli eventi estesi è un GUID a 16 byte (diverso dal GUID per l'ID di connessione client seguito da un numero in sequenza di quattro byte). Il numero di sequenza rappresenta l'ordine di una richiesta all'interno di un thread e indica l'ordine relativo di istruzioni batch e RPC per il thread. ActivityID viene attualmente inviato facoltativamente per le istruzioni batch SQL e le richieste RPC quando è abilitata l'analisi di accesso ai dati e il diciottesimo bit della parola di configurazione dell'analisi di accesso ai dati è ON.

Di seguito è riportato un esempio di utilizzo di Transact-SQL per avviare una sessione di eventi estesi che verrà archiviata in un buffer circolare e verrà registrato l'ID attività inviato da un client in operazioni RPC e batch.

create event session MySession on server
add event connectivity_ring_buffer_recorded,
add event sql_statement_starting (action (client_connection_id)),
add event sql_statement_completed (action (client_connection_id)),
add event rpc_starting (action (client_connection_id)),
add event rpc_completed (action (client_connection_id))
add target ring_buffer with (track_causality=on)

Vedi anche