Microsoft.Data.SqlClient 透過事件來源揭露資料存取追蹤Microsoft.Data.SqlClient.EventSource。 其他 ADO.NET 元件,如 Oracle、OLE DB 及 ODBC 的 .NET Framework 提供者,以及 DataSet,皆擁有自己的追蹤功能。
追蹤資料存取 API 呼叫有助於診斷下列問題:
用戶端程式與資料庫之間的架構不符。
資料庫無法使用或網路連結庫問題。
無論是硬式編碼還是由應用程式產生,SQL 都不正確。
程序設計邏輯不正確。
多個 ADO.NET 元件或 ADO.NET 與您自己的元件之間的互動所造成的問題。
為了支援不同的追蹤技術,追蹤是可延伸的,因此開發人員可以在應用程式堆疊的任何層級追蹤問題。 雖然追蹤並非 ADO.NET 的專屬功能,Microsoft 提供者會利用一般化的追蹤和工具 API。
如需有關如何收集 Microsoft.Data.SqlClient 追蹤的詳細資訊,請參閱 SqlClient 中的 Enable EventSource tracing。
存取擴展事件記錄檔中的診斷資訊
用 Microsoft.Data.SqlClient 連接 ID 用來將用戶端事件與伺服器診斷資訊(如連線失敗)關聯,這些資訊存在於連線環形緩衝區及擴展事件日誌中。 如需瞭解如何閱讀擴展事件日誌,請參閱 「檢視事件會話資料」。
在連線操作期間,Microsoft.Data.SqlClient 會在預先登入交換期間傳送用戶端連線 ID。 若連線失敗,請在連線環形緩衝區中尋找 ClientConnectionID 欄位,以取得連線失敗的診斷資訊。 僅在發生錯誤時,才會在信號緩衝區中記錄用戶端連接識別碼。 如果連線在預登入交換前失敗,伺服器將無法接收該 ID。 用戶端連接識別碼是 16 位元組的 GUID。 如果你在擴展事件工作階段中的事件新增 client_connection_id 動作,也可以在擴展事件目標輸出中找到客戶端連線 ID。
若要程式化取得用戶端連線 ID,請使用 ClientConnectionId。
連線 ID 會在成功建立連線後可供 SqlConnection 使用。 若連線嘗試失敗,該 ID 可能透過 ClientConnectionId可用。
Microsoft.Data.SqlClient 當事件來源啟用且伺服器支援追蹤標頭時,也會傳送針對批次語句和遠端程序呼叫(RPC)請求的執行緒專屬活動 ID。 若要在擴展事件會話中擷取活動 ID,請啟用 TRACK_CAUSALITY。 對於活躍連線的效能問題,請先在用戶端追蹤中找到活動 ID,再在擴展事件輸出中找到活動 ID。 活動 ID 包含一個 16 位元組的 GUID 和一個 4 位元組的序號。 序列號表示執行緒中請求的相對順序。 舊有的資料存取追蹤設定關鍵字不會設定 Microsoft.Data.SqlClient 的事件來源。
以下是一個使用 Transact-SQL 的範例,來啟動一個擴充事件記錄工作階段。此工作階段將儲存在環形緩衝區中,並記錄從 RPC 和批次作業中由用戶端傳送的活動識別碼。
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)
另請參閱
- .NET Framework 中的網路追蹤
- 追蹤和檢測應用程式
- ADO.NET 概觀