ATTACH TRACING 语句

此语句用于启动诊断跟踪会话。即开始向诊断表发送诊断信息。

语法

ATTACH TRACING TO { LOCAL DATABASE | connect-string } 
 [ LIMIT { size | history } ]

connect-string : the connection string for the database

size : SIZE nnn { MB | GB }

history : HISTORY nnn { MINUTES | HOURS | DAYS }

nnn : integer

参数

connect-string 与接收跟踪信息的数据库连接所需的连接字符串。仅当要分析的数据库与接收数据的数据库不同时才需要此参数。
connect-string 中允许使用以下参数：DBF、DBKEY、DBN、ENG、LINKS、PWD、UID。

相对于数据库服务器位置指定 DBF。否则，数据库服务器会尝试在当前服务器计算机上启动具有该名称的数据库。

如果指定带有 LINKS 或 ENG 连接参数的 DBF 参数，则会返回一条错误。
LIMIT 子句 存储在跟踪数据库中的数据量限制（按大小或是按时间长度）。

注释

ATTACH TRACING 语句主要由 Sybase Central 中的跟踪向导使用。但是，也可以手工运行它。必须从要分析的数据库中运行它。

ATTACH TRACING 语句用于为要分析的数据库启动跟踪会话。仅在设置了跟踪级别之后才可使用此语句。可以使用 Sybase Central 或使用 sa_set_tracing_level 系统过程设置跟踪级别。

启动会话之后，会根据 sa_diagnostic_tracing_level 表中所设置的跟踪级别生成跟踪信息。通过指定 LOCAL DATABASE，可以向要分析的同一数据库内的跟踪表发送跟踪数据。或者，可通过指定连接此数据库的连接字符串 (connect-string)，将跟踪数据发送到单独的跟踪数据库中。跟踪数据库必须已经存在，且您必须具有访问该数据库权限。

使用 LIMIT SIZE 或 LIMIT HISTORY 子句可限制要存储的跟踪数据的量。若要将跟踪数据量限制为一定大小，可使用 LIMIT SIZE 子句（以兆字节或千兆字节计量）。LIMIT HISTORY 子句用于将跟踪数据量限制为一段时间（以分、小时或天计量）。例如，HISTORY 8 DAYS 将存储在跟踪数据库中的跟踪数据量限制为 8 天的数据量。

要启动跟踪会话，TCP/IP 必须在运行跟踪数据库和生产数据库的数据库服务器上运行。请参见使用 TCP/IP 协议。

包含潜在敏感数据的包在网络接口上是可见的，即使跟踪本地数据库时也是如此。为安全起见，可以在连接字符串中指定加密。

若要确认数据库的当前跟踪级别，请查看 sa_diagnostic_tracing_level 表。请参见sa_diagnostic_tracing_level 表。

要查看发送跟踪数据的目标位置，请检查 SendingTracingTo 数据库属性。请参见数据库属性。

权限

必须连接到要分析的数据库，且必须具有 DBA 或 PROFILE 权限。

副作用

无。

另请参见

标准和兼容性

SQL/2003 服务商扩充。

示例

以下示例使用 sa_set_tracing_level 系统过程将跟踪级别设置为 1。然后它会启动跟踪会话。为本地数据库生成的跟踪数据将被发送到其它计算机上的 mytracingdb（如指定的连接字符串所显示）跟踪数据库中。跟踪会话期间，系统最多会保留两小时的跟踪数据量。请注意，ATTACH TRACING 语句示例的所有内容都在一行上。

CALL sa_set_tracing_level( 1 );
ATTACH TRACING TO 'uid=DBA;pwd=sql;eng=remotedbsrv11;dbn=mytracingdb;links=tcpip'
 LIMIT HISTORY 2 HOURS;