ByteHouse 云数仓版为您提供 SQL 审计能力和界面化查看 SQL 执行日志的功能，支持查看 SQL 历史和运行中的查询，帮助您快速定位并优化慢查询、排查错误、审计用户行为以保障数据安全，适用于数据库性能调优、安全合规审计、事后故障追溯等场景。同时 ByteHouse 也提供详细 SQL 日志表，打开详细日志开关后，即可查看对应详细 SQL 日志表数据，进一步查看更细致的日志数据。本文为您介绍如何使用 ByteHouse SQL 审计功能。

ByteHouse SQL 审计功能支持查看 SQL 历史与运行中的查询，其中，SQL 历史中可查看慢 SQL 查询、错误查询、ID 或 SQL 语句内容精准检索。
该功能提供全面的审计维度，包括查询 ID、状态、用户名/ID、有效角色、计算组、开始/结束时间、时长、SQL 类型、SQL 语句、CPU 总耗时、内存最大用量（Segment）等。同时该功能也支持丰富的筛选项，便于您进行高效分析 SQL 执行情况。

此外，ByteHouse 也支持查看详细日志。启用该功能后，ByteHouse 将开始积攒数据（需重新与 ByteHouse 建立连接），并自动创建名为 bh_system 的数据库及库内 query_log 表，用于记录详细的 SQL 执行日志数据，您拥有该库和表的全部权限。该表默认数据生命周期为 7 天，如果需要保留更长周期，您可执行 SQL 命令按需删除 TTL 或修改 TTL 时间，操作详情请参见调整 query_log 表生命周期。

• 管理员可查看所有用户的 SQL 审计信息，包括 SQL 历史、运行中的查询和详细日志，子用户仅能查看当前账号的 SQL 审计信息。子用户如需查看所有用户的 SQL 审计信息，可联系管理员授予全局审计日志权限，操作详情请参考资源权限设置。
• SQL 历史列表中的 ‘CPU 总耗时’ 和 ‘内存最大用量（Segment）’ 这两个展示项是 Beta 功能且要求引擎版本为 v2.3 及以上版本，如需查看对应信息，请提交工单或联系 ByteHouse 团队获取白名单权限。
• 详细日志为非公开功能，如需使用，请提交工单或联系 ByteHouse 团队获取白名单权限。

1. 登录 ByteHouse 控制台，单击顶部审计日志，单击 SQL 审计，在 SQL 历史页签下，可以看到历史查询列表。您可以通过筛选条件筛选 SQL 历史，支持通过查询 ID 或 SQL 语句查询，您可从下拉列表中选择并切换。
   
   1. SQL 历史列表中包含如下信息：
      • 查询 ID：SQL 查询的唯一 ID 号。
      • 状态：事件完成状态，如“成功”或“失败”。失败的事件，可以在后侧按钮查询具体情况。
      • 有效角色：执行此事件的角色类型。
      • 计算组：执行查询的计算组 VW 名称。
      • CPU总耗时：计算组所有 segment 的 CPU 耗时总和。由于 segment 可并行运行，因此该值可能大于查询时长。
      • 内存最大用量（Segment）：该计算组执行的所有 segment 的最大内存用量。
      • 开始时间：事件发生的具体时间。
      • 结束时间：事件结束的具体时间。
      • 时长：事件执行的时间长度。
      • SQL 类型：执行 SQL 语句的类型，如 CREATE、DROP、INSERT、DELETE 等。
      • SQL 语句：执行的 SQL 语句内容，以及其方言类型。
   2. 切换到“错误查询”页签可以快速定位失败事件，并根据需求查询相关状态。
      
   3. 切换到“ID或SQL查询”页签，可以根据查询 ID 或 SQL 语句进行查询。
2. 切换到“运行中的查询”页签，可以看到正在执行的查询列表，可查看查询 ID、开始时间、计算组、SQL 语句，您也可以使用查询 ID、SQL 语句或计算组查询正在执行的查询。

   说明

   您也可以通过使用 SQL 命令 SHOW PROCESSLIST 查看当前运行中的查询，使用方式请参见SHOW PROCESSLIST。

获取白名单权限后，您可以在 SQL 审计页面的右上角打开开启详细日志开关，启用后，ByteHouse 会为您在系统中创建一张 query_log 的表，用于写入详细的 SQL 执行日志数据。

1. 打开开启详细日志开关。
   
   打开详细日志按钮后，ByteHouse 将获得您的授权，在您的【租户-环境】下创建 bh_system 数据库，并在该数据库中创建一张 query_log 表，您拥有该库和表的全部权限。
   该表在打开后立即生效并开始积攒数据，但您需要重新与 ByteHouse 建立连接，旧连接将无法成功写入日志数据。

   注意

   由于 ByteHouse 将您执行的 SQL 日志信息持续写入到 bh_system.query_log 表中，对于该表的增删改操作将会影响日志写入。禁止对该表进行除修改 TTL 外的增删改操作。

2. 查看 query_log 表。您可以通过单击页面顶部的数据库或 SQL 工作表查看 query_log 表。
   以使用 SQL 工作表查看 query_log 表为例，您可以在 SQL 工作表的左侧数据对象中的 bh_system 数据库中看到该表。
   

调整 query_log 表生命周期

bh_system.query_log 表默认数据生命周期只有 7 天， 如果需要保留更长周期，请参考以下命令按需删除 TTL 或修改 TTL 时间。

# 查看 bh_system.query_log 表当前生命周期
SHOW CREATE TABLE bh_system.query_log;

# 删除 TTL
ALTER TABLE bh_system.query_log REMOVE TTL;

# 将默认 TTL 从 7 天改为 180 天（您可以将 180 替换为您希望保留日志的天数，需管理员权限执行）
ALTER TABLE bh_system.query_log  MODIFY TTL event_time + INTERVAL 180 DAY;

query_log 表信息