Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Microsoft.Data.SqlClient maakt tracering van gegevenstoegang beschikbaar via de Microsoft.Data.SqlClient.EventSource gebeurtenisbron. Andere ADO.NET onderdelen, zoals de .NET Framework-providers voor Oracle, OLE DB en ODBC, en DataSet, hebben hun eigen traceringsfaciliteiten.
Api-aanroepen voor gegevenstoegang traceren kunnen helpen bij het vaststellen van de volgende problemen:
Schema-verschil tussen het client-programma en de database.
Problemen met onbeschikbaarheid van de database of netwerkbibliotheekproblemen.
Onjuiste SQL, ongeacht of deze in code is vastgelegd of gegenereerd door een toepassing.
Onjuiste programmeerlogica.
Problemen die het gevolg zijn van de interactie tussen meerdere ADO.NET onderdelen of tussen ADO.NET en uw eigen onderdelen.
Voor de ondersteuning van verschillende traceringstechnologieën is tracering uitbreidbaar, zodat een ontwikkelaar een probleem kan traceren op elk niveau van de toepassingsstack. Hoewel tracering geen functie is die alleen ADO.NET betreft, maken Microsoft-providers gebruik van gegeneraliseerde tracering- en instrumentatie-API's.
Voor meer informatie over het verzamelen van Microsoft. Data.SqlClient-traceringen, zie EventSource-tracering inschakelen in SqlClient.
Toegang tot diagnostische gegevens in het uitgebreide gebeurtenissenlogboek
Gebruik Microsoft.Data.SqlClient-verbindings-id's om clientgebeurtenissen te correleren met diagnostische gegevens van de server, zoals verbindingsfouten, in de connectiviteitsringsbuffer en het uitgebreide gebeurtenislogboek. Zie Gebeurtenissessiegegevens weergeven voor meer informatie over het lezen van het uitgebreide gebeurtenissenlogboek.
Voor verbindingsbewerkingen Microsoft. Data.SqlClient verzendt een clientverbindings-id tijdens de prelogin-uitwisseling. Als de verbinding mislukt, zoekt u naar het ClientConnectionID veld in de verbindingsringsbuffer om diagnostische informatie over de verbindingsfout op te halen. Clientverbindings-id's worden alleen in de ringbuffer geregistreerd als er een fout optreedt. Als een verbinding mislukt voordat de prelogin exchange wordt uitgevoerd, ontvangt de server de id niet. De clientverbindings-id is een GUID van 16 bytes. U kunt ook de clientverbindings-id vinden in de uitvoer van het Extended Events-doel als u de actie client_connection_id toevoegt aan gebeurtenissen in een Extended Events-sessie.
Als u de clientverbindings-id programmatisch wilt ophalen, gebruikt u ClientConnectionId.
De verbindings-id is beschikbaar voor SqlConnection nadat deze succesvol een verbinding tot stand heeft gebracht. Als een verbindingspoging mislukt, is de id mogelijk beschikbaar via ClientConnectionId.
Microsoft.Data.SqlClient verzendt ook een threadspecifieke activiteits-id voor batchinstructies en RPC-aanvragen (remote procedure call) wanneer de gebeurtenisbron is ingeschakeld en de server traceringsheaders ondersteunt. Als u de activiteits-id in een sessie met uitgebreide gebeurtenissen wilt vastleggen, schakelt u TRACK_CAUSALITY in. Voor prestatieproblemen met een actieve verbinding zoekt u de activiteits-id in de clienttracering en vervolgens in de uitvoer van de uitgebreide gebeurtenissen. De activiteits-id bevat een GUID van 16 bytes en een reeksnummer van vier bytes. Het volgnummer geeft de relatieve volgorde van aanvragen binnen een thread aan. Het configuratiewoord voor tracering van verouderde gegevenstoegang configureert de gebeurtenisbron van Microsoft.Data.SqlClient niet.
Hier volgt een voorbeeld dat gebruikmaakt van Transact-SQL om een uitgebreide gebeurtenissessie te starten die wordt opgeslagen in een ringbuffer en de activiteits-id registreert die is verzonden vanaf een client op RPC en batchbewerkingen.
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)