Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Microsoft.Data.SqlClient tillhandahåller dataåtkomstspårning via händelsekällan Microsoft.Data.SqlClient.EventSource. Andra ADO.NET-komponenter, till exempel .NET Framework-providers för Oracle, OLE DB och ODBC, och DataSet, har egna spårningsfunktioner.
Spårning av API-anrop för dataåtkomst kan hjälpa dig att diagnostisera följande problem:
Schemamatchningsfel mellan klientprogrammet och databasen.
Problem med databasens otillgänglighet eller nätverksbibliotek.
Felaktig SQL oavsett om hårdkodad eller genererad av ett program.
Felaktig programmeringslogik.
Problem som beror på interaktionen mellan flera ADO.NET komponenter eller mellan ADO.NET och dina egna komponenter.
För att stödja olika spårningstekniker är spårning utökningsbar, så att en utvecklare kan spåra ett problem på alla nivåer i programstacken. Även om spårning inte är en funktion endast för ADO.NET, drar Microsoft-leverantörer nytta av generaliserade spårnings- och instrumentations-API:er.
Mer information om hur du samlar in Microsoft.Data.SqlClient-spårningar finns i Aktivera EventSource-spårning i SqlClient.
Åtkomst till diagnostikinformation i loggen för utökade händelser
Använd Microsoft.Data.SqlClient-anslutnings-ID för att korrelera klienthändelser med serverdiagnostikinformation, till exempel anslutningsfel, i anslutningsringsbufferten och loggen för utökade händelser. Information om hur du läser loggen för utökade händelser finns i se Visa händelsesessionsdata.
För anslutningsåtgärder, Microsoft.Data.SqlClient skickar ett klientanslutnings-ID under prelogin-utbytet. Om anslutningen misslyckas letar du efter fältet ClientConnectionID i anslutningsringsbufferten för att hämta diagnostikinformation om anslutningsfelet. Klientanslutnings-ID:t loggas endast i ringbufferten om ett fel inträffar. Om en anslutning misslyckas före prelogin-utbytet tar servern inte emot ID:t. Klientanslutnings-ID:t är ett GUID på 16 byte. Du kan också hitta klientanslutnings-ID:t i målutdata för Extended Events om du lägger till åtgärden client_connection_id i händelser i en Extended Events-session.
Om du vill hämta klientanslutnings-ID:t programmatiskt använder du ClientConnectionId.
Anslutnings-ID:t är tillgängligt för SqlConnection när en anslutning har upprättats. Om ett anslutningsförsök misslyckas kan ID:t vara tillgängligt via ClientConnectionId.
Microsoft. Data.SqlClient skickar också ett trådspecifikt aktivitets-ID för batch-instruktioner och RPC-begäranden (Remote Procedure Call) när dess händelsekälla är aktiverad och servern stöder spårningshuvuden. Om du vill samla in aktivitets-ID:t i en utökad händelsesession aktiverar du TRACK_CAUSALITY. För prestandaproblem med en aktiv anslutning letar du upp aktivitets-ID:t i klientspårningen och sedan i utdata för utökade händelser. Aktivitets-ID:t innehåller ett GUID på 16 byte och ett sekvensnummer på fyra byte. Sekvensnumret anger den relativa ordningen för begäranden i en tråd. Konfigurationsnyckeln för spårning av äldre dataåtkomst konfigurerar inte Microsoft.Data.SqlClients händelsekälla.
Följande är ett exempel som använder Transact-SQL för att starta en utökad händelsesession som lagras i en ringbuffert och registrerar aktivitets-ID:t som skickas från en klient i RPC- och batchåtgärder.
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)