SQL 审计

GV$OB_SQL_AUDIT 是全局 SQL 审计表，可以用来查看每次请求客户端来源、执行服务器信息、执行状态信息、等待时间以及执行各阶段耗时等。

GV$OB_SQL_AUDIT 字段说明

SQL Audit 相关设置

设置 SQL Audit 的开关

• 开启 SQL Audit：

  ALTER SYSTEM SET enable_sql_audit = true;
  

• 关闭 SQL Audit：

  ALTER SYSTEM SET enable_sql_audit = false;
  

设置 SQL Audit 所使用的内存占租户内存的百分比

ob_sql_audit_percentage 用于设置 SQL Audit 所使用的内存占租户内存的百分比。默认内存百分比为 3，可设置范围为 [0, 80]。

SET GLOBAL ob_sql_audit_percentage = 3;

关于 ob_sql_audit_percentage 的详细介绍信息，参见 ob_sql_audit_percentage。

SQL Audit 淘汰机制

租户的后台任务每隔 1s 会根据 OBServer 节点和 SQL Audit 的内存使用情况来决定是否触发淘汰 SQL。SQL Audit 内存上限根据 ob_sql_audit_percentage 分配可用的最大内存。

当 SQL Audit 的实际内存使用达到指定阈值时，满足触发淘汰的条件，开启淘汰；当 SQL Audit 的实际内存使用降到指定阈值时，满足停止淘汰的条件，停止淘汰。SQL Audit 淘汰机制如下表所示。

示例

通过 GV$OB_SQL_AUDIT 视图可以方便的查询 SQL 执行的各种维度信息。如下示例为查询执行耗时超过 100ms 的 SQL 及其 FLT_TRACE_ID。

1. 开启全链路追踪 Session 级别 Trace，记录当前 Session 所有 SQL 的相关耗时等信息，采样频率为 50%。

   CALL DBMS_MONITOR.OB_SESSION_TRACE_ENABLE(null,1,0.5,'ALL');
   

   关于 DBMS_MONITOR.OB_SESSION_TRACE_ENABLE 的详细介绍信息，参见 OB_SESSION_TRACE_ENABLE。

2. 查看接收到请求到执行结束消耗总时间大于 100000 微秒的前十条信息。

   SELECT request_id, usec_to_time(request_time), ELAPSED_TIME, QUEUE_TIME, EXECUTE_TIME, FLT_TRACE_ID, QUERY_SQL
   FROM oceanbase.V$OB_SQL_AUDIT
   WHERE ELAPSED_TIME > 100000
   LIMIT 10;
   

   返回结果如下：

   +------------+----------------------------+--------------+------------+--------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | request_id | usec_to_time(request_time) | ELAPSED_TIME | QUEUE_TIME | EXECUTE_TIME | FLT_TRACE_ID                         | QUERY_SQL                                                                                                                                                          |
   +------------+----------------------------+--------------+------------+--------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   |    5950244 | 2023-09-07 16:20:47.465958 |       127623 |         26 |       127206 | 000604c0-8981-9184-518a-e234439d873c | CREATE TABLE tbl2(c1 INT PRIMARY KEY,c2 INT)                                                                                                                       |
   |    5951861 | 2023-09-07 16:21:07.887121 |       333776 |         38 |       310298 |                                      | ALTER TABLE tbl2 ADD CONSTRAINT fk1 FOREIGN KEY (c2) REFERENCES tbl3(c1) ON UPDATE SET NULL                                                                        |
   |    5953177 | 2023-09-07 16:21:28.215377 |       174416 |         24 |       174186 | 000604c0-8bef-5afb-f9d3-2ee0dfab4c8f | SELECT request_id,usec_to_time(request_time),ELAPSED_TIME,QUEUE_TIME,EXECUTE_TIME,FLT_TRACE_ID,QUERY_SQL FROM v$OB_SQL_AUDIT where ELAPSED_TIME > 100000           |
   |    5954522 | 2023-09-07 16:21:48.317360 |       128803 |         27 |       128542 | 000604c0-8d22-1659-7b0c-a0ac0645894d | SELECT request_id,usec_to_time(request_time),ELAPSED_TIME,QUEUE_TIME,EXECUTE_TIME,FLT_TRACE_ID,QUERY_SQL FROM v$OB_SQL_AUDIT where ELAPSED_TIME > 100000  limit 10 |
   +------------+----------------------------+--------------+------------+--------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   4 rows in set
   

相关文档

• 关于全链路追踪的详细介绍信息，参见 全链路追踪。
• 关于视图 GV$OB_SQL_AUDIT 的详细介绍信息，参见 GV$OB_SQL_AUDIT（MySQL 模式） 或 GV$OB_SQL_AUDIT（Oracle 模式）。