ADO.NET 具有内置数据跟踪功能的.NET 数据提供程序支持的 SQL Server、 Oracle、 OLE DB 和 ODBC,以及 ADO.NET xref:System.Data.DataSet,和 SQL Server 网络协议。
跟踪数据访问 API 调用可以帮助诊断以下问题:
-
客户端程序和数据库之间的架构不匹配。
-
数据库不可用或网络库问题。
-
不正确的 SQL,无论是硬编码还是由应用程序生成。
-
不正确的编程逻辑。
-
多个 ADO.NET 组件之间或 ADO.NET 与您自己的组件之间的交互引发的问题。
为了支持不同的跟踪技术,跟踪是可扩展的,这样,开发人员可以在任何应用程序堆栈级别上跟踪问题。 尽管跟踪不属于纯 ADO.NET 功能,但是,Microsoft 提供程序利用通用的跟踪和规范 API。
有关设置和在 ADO.NET 中配置托管的跟踪的详细信息,请参阅跟踪数据访问。
访问扩展事件日志中的诊断信息
在 SQL Server.NET Framework Data Provider,数据访问跟踪 (数据访问跟踪) 已更新以使其能够更轻松地更轻松地将客户端事件与诊断信息,如连接失败,关联从服务器的连接环形缓冲区和应用程序中扩展的事件日志的性能信息。 有关读取扩展的事件日志的信息,请参阅查看事件会话数据。
对于连接操作,ADO.NET 将发送一个客户端连接 ID。 如果连接失败,可以访问连接环形缓冲区 (在 SQL Server 2008 使用连接环形缓冲区解决连接问题) 并找到ClientConnectionID字段并获取的诊断信息连接失败。 如果出现错误,则将客户端连接 ID 记录在环形缓冲区中。 (如果在发送预登录数据包之前连接失败,将不会生成客户端连接 ID。)客户端连接 ID 为 16 字节的 GUID。 如果 client_connection_id 操作已添加到扩展事件会话中的事件,则还可以在扩展事件目标输出中找到查找客户端连接 ID。 如果需要进一步的客户端驱动程序诊断帮助,可以启用数据访问跟踪并重新运行连接命令,然后观察 ClientConnectionID 字段。
还可以通过使用 SqlConnection.ClientConnectionID 属性以编程方式获取客户端连接 ID。
ClientConnectionID 可用于成功建立连接的 xref:System.Data.SqlClient.SqlConnection 对象。 如果连接尝试失败,则 ClientConnectionID 可通过 SqlException.ToString 提供。
ADO.NET 还会发送一个特定于线程的活动 ID。 如果会话开始使用 TRACK_CAUSALITY 选项处于启用状态,在扩展的事件会话中捕获的活动 ID。 有关活动连接的性能问题,可以从客户端的数据访问跟踪获取活动 ID(ActivityID 字段),然后查找扩展事件输出中的活动 ID。 扩展事件中的活动 ID 为追加了 4 字节序列号的 16 字节的 GUID(与客户端连接 ID 的 GUID 不同)。 序列号表示请求在线程中的顺序,并指示线程的批处理和 RPC 语句的相对顺序。 启用数据访问跟踪以及数据访问跟踪配置字中的第 18 位处于打开状态时,当前可以针对 SQL 批处理语句和 RPC 请求选择发送 ActivityID。
下面是使用 TRANSACT-SQL 来启动将存储在环形缓冲区中并记录从 RPC 和批处理操作上的客户端发送的活动 ID 的扩展的事件会话的示例。
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)
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
