ADO.NET 中的資料追蹤

  • 發行項

ADO.NET 具備內建資料追蹤功能，SQL Server、Oracle、OLE DB 和 ODBC 的 .NET 資料提供者，以及 ADO.NET DataSet 和 SQL Server 網路通訊協定都支援這個功能。

追蹤資料存取 API 呼叫可協助診斷下列問題：

  • 用戶端程式與資料庫之間的結構描述不符。

  • 無法使用資料庫或網路程式庫發生問題。

  • SQL 錯誤，該 SQL 是硬式編碼或應用程式所產生的。

  • 錯誤的程式設計邏輯。

  • 多個 ADO.NET 元件之間，或 ADO.NET 與您本身的元件之間互動所發生的問題。

為了支援不同的追蹤技術，我們製作了可擴充的追蹤，讓開發人員追蹤任何應用程式堆疊層級的問題。 雖然追蹤不是 ADO.NET 的特有功能，但 Microsoft 提供者可利用通用的追蹤和檢測應用程式開發介面。

如需在 ADO.NET 中設定 Managed 追蹤的詳細資訊，請參閱追蹤資料存取 (英文)。

存取擴充事件記錄檔中的診斷資訊

在 SQL Server 的 .NET Framework 資料提供者中，資料存取追蹤 (資料存取追蹤) 已更新，因此更容易相互關聯用戶端事件與擴充事件記錄中伺服器連接信號緩衝區與應用程式效能資訊的診斷資訊，例如連接失敗。 如需讀取擴充事件記錄檔的資訊，請參閱檢視事件工作階段資料。

ADO.NET 會傳送用戶端連接 ID 以進行連接作業。 如果連線失敗，您可以存取連線通道緩衝區 (SQL Server 2008 連線通道緩衝區中的連線疑難排解)、尋找 ClientConnectionID 欄位，並且取得有關連接失敗的診斷資訊。 僅在發生錯誤時，才會在信號緩衝區中記錄用戶端連接識別碼。 (如果在傳送登入前封包之前連接失敗，則不會產生用戶端連接識別碼。)用戶端連接識別碼是 16 位元組的 GUID。 如果在擴充事件工作階段中將 client_connection_id 動作加入到事件中，您還可以在擴充事件目標輸出中尋找用戶端連接 ID。 如需進一步的用戶端驅動程式診斷協助，您可以啟用資料存取追蹤並傳回連接命令，同時觀察資料存取追蹤當中的 ClientConnectionID 欄位。

您可以使用 SqlConnection.ClientConnectionID 屬性，以程式設計方式取得用戶端連接 ID。

成功建立連接的 ClientConnectionID 物件可取得 SqlConnection。 如果連接嘗試失敗，可能可以透過 ClientConnectionID 取得 SqlException.ToString。

ADO.NET 也會傳送特定執行緒活動 ID。 如果已啟動工作階段並啟用 TRACK_CAUSALITY 選項，即可在擴充的事件工作階段中擷取活動識別碼。 如需與使用中連接相關的效能問題，您可以從用戶端的資料存取追蹤 (ActivityID 欄位) 取得活動識別碼，然後在擴充的事件輸出中尋找此活動識別碼。 擴充事件記錄中的活動 ID 是 16 個位元組的 GUID (和用戶端連接 ID 的 GUID 不同)，並且附加一個四位元組的序號。 此序號表示執行緒內要求的順序，並指出執行緒的批次和 RPC 陳述式的相對排序。 啟用資料存取追蹤功能，而且開啟資料存取追蹤組態字詞中的第 18 個位元時，目前會選擇性地傳送 SQL 批次陳述式和 RPC 要求的 ActivityID。

以下是使用 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)

另請參閱