数据库工作台
数据库工作台
文档指南
请输入
- 文档首页
数据库工作台PostgreSQL 用户指南运维管理观测诊断SQL 洞察与审计管理
复制全文
下载 pdfSQL 洞察与审计管理
文档反馈
问问助手数据库工作台 DBW 提供 SQL 洞察与审计功能，该功能可以捕获、审查和分析所有的 SQL 语句，以此来帮助您提升数据库的性能和稳定性。本文介绍 SQL 洞察与审计功能的注意事项、优势和开启、关闭、查看的操作步骤。
背景信息
SQL 洞察与审计包含数据库审计和全量 SQL 洞察两个功能。SQL 洞察与审计以数据库审计为基础，因此在全量 SQL 洞察时，默认同步开启数据库审计。
SQL 洞察与审计功能支持自动记录和分析数据库内核生成的 SQL 语句，包括执行账号、IP 地址和执行详情等信息。其中 SQL语句类型包括 SELECT、INSERT、UPDATE、DELETE、ALTER、CREATE、DROP、RENAME、TRUNCATE 和 OTHER（其他全部 SQL 类型）。
目前数据库审计已在全部地域上线，全量 SQL 洞察功能仅在中国地域华北2（北京）、华东2（上海）、华南1（广州），以及海外地域亚太东南（柔佛）发布上线。关于 SQL 洞察与审计的计费信息，请参见计费项与价格。
优势
- CPU 消耗低：SQL 语句是数据库内核生成的，对系统的 CPU 资源消耗非常低。
- 提供全面视角：全量 SQL 洞察可以捕获和分析所有在数据库实例中运行的所有 SQL 语句，为您提供全面的视角，可以用于发现数据库实例的性能瓶颈。
- 问题定位和诊断：通过对实时监控和历史趋势的分析，全量 SQL 洞察可以帮助您定位和诊断数据库实例的问题，例如慢查询、并发死锁等。
- 优化数据库结构：全量 SQL 洞察功能可提供查看哪些表被经常使用，哪些 SQL 语句最耗费资源等信息，从而帮助您改进数据库的结构。
- 提升数据库的可用性和稳定性：全量 SQL 洞察可以帮助您更好地了解数据库实例的整体运行状况，从而提升数据库的可用性和稳定性。
注意事项
- 功能开启前提
- 请先关闭旧版数据库审计功能，再开启 SQL 洞察与审计。
- 若已单独开启“数据库审计”或“全量 SQL 洞察”，需先在服务设置中关闭“全量 SQL 洞察”，然后重新统一开启“SQL 洞察与审计”功能，以确保配置一致。
- 数据准确性说明
- SQL 洞察与审计的数据基于数据库内核分析生成，可能受以下因素影响：
- 内核采集机制本身的限制；
- 查询结果集过大时，可能导致统计信息不完整或不准确。
- 存储资源
- 存储位置：SQL 审计数据由 DBW 提供存储，不占用数据库实例自身存储空间。
- 分层存储策略
- 超出标准保留期限的审计日志将自动转存至低频存储：
- 低频存储单价显著低于标准存储，适用于长期归档、访问频率低的历史日志。
- 虽读取时可能产生少量 Retrieval（取回）费用，但整体成本远低于长期使用标准存储。
- 在保障数据可查性的前提下，有效降低长期存储开支。
- 数据保留与删除风险
- 关闭 SQL 洞察与审计后，所有历史数据将被永久清空。
- 请务必在关闭前将所需数据下载至本地，避免不可逆丢失。
- 若数据库实例被删除，其关联的数据库审计与全量 SQL 洞察功能将自动关闭并清除数据。
- SQL 语句记录长度限制
- 系统最多记录 8KB（8192 字节） 的 SQL 语句，超出部分将被截断。实际记录长度受实例参数控制：
- 当参数 ≤ 8KB 时，以参数值为上限；
- 当参数 > 8KB 时，上限仍为 8KB。
- 因系统采集时会添加内部前缀标识，实际可记录的 SQL 长度略小于设定值。
费用
计费规则：
- 推广期内：免费存储 1 天。
- 推广期后：按实际使用时长计费，详细信息，请参见计费项与价格。
前提条件
- 已创建云数据库 PostgreSQL 版实例，实例状态处于运行中，且实例的旧版数据库审计功能处于关闭状态。详细操作，请参见创建实例。
- 如果目标实例已开启安全管控，那么您需为当前账号申请目标实例的运维只读或运维读写权限。详细信息，请参见开启云数据库 PostgreSQL 版实例安全管控和申请云数据库 PostgreSQL 版相关操作权限。
开启 SQL 洞察与审计
- 登录 DBW 控制台。
- 在顶部菜单栏，选择地域。
- 在左侧导航栏，选择运维管理 > 观测诊断。
- 在运维观测页面切换目标实例，具体操作如下：
- 在页面右上角，单击下拉图标，切换实例类型为云数据库 PostgreSQL 版。
- 在运维观测页面左上角，单击下拉图标，切换目标实例。
- 在目标实例页面，单击 SQL 洞察与审计。
- （可选）在SQL 洞察与审计页签，设置以下参数。
- 参数说明需开通的功能由于 SQL 洞察与审计中的 SQL 明细所记录的为数据库审计信息，因此在开启 SQL 洞察与审计之时，默认同步开启数据库审计。您也可以仅开启数据库审计功能，以此开启 SQL 洞察与审计的 SQL 明细功能。更多关于数据库审计信息，请参见数据库审计管理。说明在开启 SQL 洞察与审计前，请确保当前实例的旧版数据库审计功能处于关闭状态。标准存储时长按需选择审计日志的存储时长，当前支持选择 1 天（默认值）、7 天、30 天、180 天、1 年或 3 年。按需勾选是否开启低频存储优化使用成本。低频存储时长使用成本功能，可将不常被访问但不能删除的数据，以更低成本安全存储，实现成本与性能的平衡。
- 不勾选：若不勾选，DBW 会清空超出标准存储时长的 SQL 审计日志，建议将 SQL 审计日志下载保存至本地，以便后续查询。
- 勾选：若勾选，DBW 会将超出标准存储时长的 SQL 审计日志转存至低频存储中，进入低频存储的数据，检索效率将有所降低。同时，您还需设置以下参数信息：
- 低频存储时长：按需设置低频存储时长，取值范围为 30~3650。
- SQL 存储时长：SQL 存储时长默认是标准存储时长+低频存储时长，且不支持修改。
说明SQL 数据的存储空间是由 DBW 侧提供，不占用数据库实例的存储空间。标签标签用于标记资源，便于搜索和资源聚合。单击添加一行，设置标签键和标签值，为实例添加标签。标签键和标签值的配置规则如下：- 不支持设置以任何形式的 volc: 为开头的 Key，例如 Volc:、VOLC: 等。
- 可以包含语言字符、数字、空格和英文符号，英文符号包括 _、.、:、/、=、+、- 和 @。
- 长度需在 1~128 个字符内。
- 使用 UTF-8 编码的 Unicode 格式。
协议阅读并勾选我已阅读并同意《数据库工作台 DBW 服务条款》。
- 单击开启数据库审计 & SQL 洞察。
设置 SQL 洞察与审计
- 登录 DBW 控制台。
- 在顶部菜单栏，选择地域。
- 在左侧导航栏，选择运维管理 > 观测诊断。
- 在观测诊断页面，单击 SQL 洞察与审计。
- 在页面右上角的下拉列表中，选择目标数据库类型即云数据库 PostgreSQL 版。
- 在页面左上角下拉列表中，选择目标实例。
- 在 SQL 洞察与审计页签，单击服务设置。
- 在服务设置对话框，您可以进行以下操作。
- 参数说明关闭 SQL 洞察与审计关闭 SQL 洞察与审计时，即同时关闭数据库审计和全量 SQL 洞察。说明在关闭 SQL 洞察与审计后，所有的存储数据都将被清空。如果有需要，请在数据清空前请将所有数据都下载至本地，否则可能会导致数据丢失。开启或关闭全量 SQL 洞察SQL 洞察与审计中包含数据库审计和全量 SQL 洞察两个特性，在 SQL 洞察与审计中，您可以按需开启或关闭全量 SQL 洞察功能。
- 单击开启，可开启全量 SQL 洞察功能。
- 单击关闭，可关闭全量 SQL 洞察功能。
说明- 在关闭 SQL 洞察后，将不会采集和存储新的数据。已有的存储数据不会被立即清空，DBW 仍按照之前设置的 SQL 存储时长清理 SQL 洞察数据。
- 开启或关闭全量 SQL 洞察，会有费用的变化，更多信息请参见 PostgreSQL 计费项与价格。
标准存储时长按需选择审计日志的存储时长，当前支持选择 1 天（默认值）、7 天、30 天、180 天、1 年或 3 年。按需勾选是否开启低频存储优化使用成本。低频存储时长使用成本功能，可将不常被访问但不能删除的数据，以更低成本安全存储，实现成本与性能的平衡。- 不勾选：若不勾选，DBW 会清空超出标准存储时长的 SQL 审计日志，建议将 SQL 审计日志下载保存至本地，以便后续查询。
- 勾选：若勾选，DBW 会将超出标准存储时长的 SQL 审计日志转存至低频存储中，进入低频存储的数据，检索效率将有所降低。同时，您还需设置以下参数信息：
- 低频存储时长：按需设置低频存储时长，取值范围为 30~3650。
- SQL 存储时长：SQL 存储时长默认是标准存储时长+低频存储时长，且不支持修改。
说明SQL 数据的存储空间是由 DBW 侧提供，不占用数据库实例的存储空间。设置标签标签用于标记资源，便于搜索和资源聚合。单击标签后的编辑图标，设置标签键和标签值，为实例添加标签。标签键和标签值的配置规则如下：- 不支持设置以任何形式的 volc: 为开头的 Key，例如 Volc:、VOLC: 等。
- 可以包含语言字符、数字、空格和英文符号，英文符号包括 _、.、:、/、=、+、- 和 @。
- 长度需在 1~128 个字符内。
- 使用 UTF-8 编码的 Unicode 格式。
- 单击确定。
查看全量 SQL 洞察信息
说明
- 当 SQL 语句执行成功时，仅表示该 SQL 语句在执行过程中未出现异常且已顺利完成执行。例如，在发生事务回滚的情况下，若事务中的单条 SQL 执行成功且无异常，则该条 SQL 会被判定为执行成功。
- 查询全量 SQL 洞察信息时，仅支持在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。如需查询更大时间范围的 SQL 记录，建议您导出后进行查询。导出功能会异步导出日志，适合大时间范围内的查询。
- 在全量 SQL 洞察功能中不仅支持查看全量 SQL 的趋势、SQL 模板还包括 SQL 明细。
- 登录 DBW 控制台。
- 在顶部菜单栏，选择地域。
- 在左侧导航栏，选择运维管理 > 观测诊断。
- 在观测诊断页面，单击 SQL 洞察与审计。
- 在页面右上角的下拉列表中，选择目标数据库类型即云数据库 PostgreSQL 版。
- 在页面左上角下拉列表中，选择目标实例。
- 在 SQL 洞察与审计页签，查看全量 SQL 洞察信息、SQL 明细和 SQL 写分析，具体如下所示。
- 类型说明全量 SQL 洞察在 SQL 洞察 & 审计页签的全量 SQL 洞察子页签，查看实例内 SQL 的发展趋势和 SQL 模板列表。同时，也可以按需选择实例节点查看指定节点的全量 SQL 洞察信息。具体如下所示：
- 区间查看全量 SQL 洞察信息在 SQL 洞察 & 审计页签的全量 SQL 洞察子页签，按需选择需要查看全量 SQL 洞察的时间范围和目标节点，您可以在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。由于 SQL 洞察记录所有数据库行为，会记录大量 SQL 语句，在线查询选择时间范围过大，会导致长时间没有返回查询结果，甚至查询超时。查看选定时间段内实例的 SQL 发展趋势和 SQL 模板列表，具体如下所示：
- 全量 SQL 趋势：在指定时间段内，可查看 SQL 在执行耗时的性能分析和统计，在全量 SQL 趋势区域，您可以查看以下信息：
- 执行耗时阶段：支持按需勾选查看 WaitLockTime 指标项在各时间点的发展趋势。
- 执行耗时分布：展示选定时间段内，所有 SQL 的执行耗时分布，将执行耗时分为 7 个区间，每分钟计算一次，具体如下所示：
- (0,1]ms：表示满足 0ms ＜ 执行耗时 ≤ 1ms SQL 执行次数占比。
- (1,2]ms：表示满足 1ms ＜ 执行耗时 ≤ 2ms SQL 执行次数占比。
- (2,3]ms：表示满足 2ms ＜ 执行耗时 ≤ 3ms SQL 执行次数占比。
- (3,10]ms：表示满足 3ms ＜ 执行耗时 ≤ 10ms SQL 执行次数占比。
- (10,100]ms：表示满足 10ms ＜ 执行耗时 ≤ 100ms SQL 执行次数占比。
- (0.1,1]s：表示满足 0.1s ＜ 执行耗时 ≤ 1s SQL 执行次数占比。
- >1 s：表示满足 1s ＜ 执行耗时 SQL 执行次数占比。
- 执行次数：执行时间段内 SQL 执行次数的统计。支持查看各时间点的执行总次数的发展趋势。
- SQL 模板列表：在 SQL 模板列表区域，支持通过包括数据库名、表名、SQL 类型、平均扫描行数及执行次数维度进行精准筛选。
按需求筛选后，列表将展示丰富的性能指标包括平均 SQL 执行耗时、SQL 耗时、SQL 模板、SQL 类型、数据库名称、表名、SQL 执行总耗时、执行次数、Postgre 锁等待时间、平均影响行数、平均扫描行数、平均返回行数、平均发送字节数。 单击 SQL 模板，在 SQL 详情控制面板，查看该 SQL 模板的执行次数、执行耗时、影响行数、返回行数、SQL 模板、SQL 文本和 SQL 优化，您也可以单击收藏图标，便于后续查看目标 SQL 模板。说明- SQL 执行总耗时 = 平均 SQL 执行耗时 * 执行次数。
- 在 SQL 优化建议对话框，查看 SQL 优化建议包括执行的 SQL 语句、执行计划、优化建议包括索引优化和 SQL 改写。
- 收藏 SQL 模板：在 SQL 模板列表区域，单击目标 SQL 模板操作列的收藏图标，收藏 SQL 模板。
- 查看收藏的 SQL 模板：在 SQL 模板列表区域，单击我收藏的，可以查看您在所有 SQL 模板列表中收藏的 SQL 模板，您也可以单击目标 SQL 模板的操作列，取消您收藏的 SQL 模板。
- 查看 SQL 详情：在 SQL 模板列表区域，单击目标 SQL 模板列的 SQL 信息，即可查看 SQL 详情，包括执行次数、执行耗时、影响行数、返回行数的趋势图，以及耗时 TOP 5 的 SQL 信息和全部 SQL 信息。
- 查看 SQL 优化建议：在 SQL 模板列表区域，单击目标 SQL 模板列的 SQL 信息，在 SQL 详情面板中，单击 TOP 5 或全部 SQL 列表操作列中的 SQL 优化，即可查看 SQL 优化建议，包括索引优化和 SQL 改写等信息。
- 对比查看全量 SQL 洞察信息在全量 SQL 洞察子页签，勾选时间对比，按需选择需要对比查看全量 SQL 洞察的时间段，查看执行耗时阶段、执行耗时分布、执行次数和对比时间段内的 SQL 模板列表等信息。
说明您也可以单击目标 SQL 文本操作列的查看执行计划，在执行计划对话框查看更多信息。SQL 审计SQL 明细在 SQL 明细子页签，您可以查看 SQL 语句明细，按需选择需要查看全量 SQL 明细的时间范围，您可以在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。由于 SQL 洞察记录所有数据库行为，会记录大量 SQL 语句，在线查询选择时间范围过大，会导致长时间没有返回查询结果，甚至查询超时。SQL 语句的明细包括执行耗时、SQL 耗时（ms）、数据库名称、SQL 语句、SQL 模板、执行结果、节点名称、SQL 类型、会话 ID、用户名、进程 ID、客户端 IP、表名、开始时间、WaitLockTime、影响行数、扫描行数、返回行数、发送字节数、日志等级、日志类型。您也可以单击高级筛选，筛选符合条件的 SQL 语句。说明- 您也可以单击目标 SQL 语句操作列的 SQL 优化，在 SQL 优化弹窗中查看 SQL 优化建议，包括索引优化和 SQL 改写等信息。
- 在 SQL 明细的高级筛选的关键词中，支持通过模糊搜索查询目标 SQL 信息，模糊搜索不区分大小写，关键词格式为SQL 关键词 + *，例如 select *。
检索分析DBW 提供了日志检索和分析功能，支持通过检索分析语句过滤和筛选日志数据，并对筛选结果进行统计分析。在检索分析子页签，您可以执行以下操作。- 查看历史检索分析结果。在查询区域，单击搜索框左侧的历史查询图标，即可选择查看历史检索信息。
- 检索分析日志。检索时间范围默认为 5 分钟，您可以自定义检索的时间范围；输入检索分析语句，或使用点选模式自定义添加筛选项和分析语句，并单击搜索。
- 查看检索分析结果。检索分析结果支持以原始日志和统计图表的方式展示，并支持自定义更多展示条件，以满足您的结果展示需求。关于日志检索分析的更多信息，请参见检索分析 SQL 日志。
说明- 检索分析语句由检索语句和 SQL 分析语句构成，两者之间由管道符（|）分割，表示在符合检索条件的结果中进行数据统计与分析。
- 页面默认以表格方式展示查询分析结果，您也可以指定为其他统计图表，并添加对应的图表设置。
- 查询结果区域中同时展示当前日志分析的基本信息，包括日志总数、查询结果是否精确等。
写分析通过写分析，您可以全面监控和分析数据库的写入操作。 在写分析子页签，您可以按需查看指定时间（按需选择需要查看全量 SQL 写分析的时间范围，您可以在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。由于 SQL 洞察记录所有数据库行为，会记录大量 SQL 语句，在线查询选择时间范围过大，会导致长时间没有返回查询结果，甚至查询超时。）、指定数据库和表内数据库的写入操作，包括表名、数据库名称、执行次数、SQL 平均耗时、DML 总执行时间、DML 执行次数、DML 平均执行耗时、DML 平均扫描行、DML 平均影响行数、DML 平均锁等待时间、DML 最大执行耗时、DDL 总执行时间、DDL 执行次数、DDL 平均执行耗时、DDL 平均扫描行、DDL 平均影响行数、DDL 平均锁等待时间和 DDL 最大执行耗时。 同时，您也可以在表名列单击目标表的名称，查看关于表的更多信息，具体如下所示：- DML：在目标表控制面板的 DML 子页签，您可以查看在指定时间内表内执行的 DML 明细，包括 DML 的执行次数、总耗时和影响行数。
- DDL：在目标表控制面板的 DDL 子页签，您可以查看在指定时间内表内执行的 DDL 明细，包括 DDL 的执行次数、总耗时和影响行数。
- SQL 模板列表：在目标表控制面板的 SQL 模板区域，您可以查看在指定时间内表内每个 SQL 模板的平均 SQL 执行耗时、SQL 耗时(ms)、SQL 模板、SQL 类型、数据库名称、表名、SQL 执行总耗时、执行次数、Postgres 锁等待时间、平均影响行数、平均扫描行数、平均返回行数、平均发送字节数。
- 单击 SQL 模板，在 SQL 详情控制面板，查看表级别 SQL 模板的执行次数、执行耗时、影响行数、返回行数、SQL 模板和 SQL 文本。
- 收藏 SQL 模板：在 SQL 模板列表区域，单击目标 SQL 模板操作列的收藏图标，收藏 SQL 模板。
用量查询
- 登录 DBW 控制台。
- 在顶部菜单栏，选择地域。
- 在左侧导航栏，选择运维管理 > 观测诊断。
- 在观测诊断页面，单击 SQL 洞察 & 审计。
- 在页面右上角的下拉列表中，选择目标数据库类型即云数据库 PostgreSQL 版。
- 在页面左上角下拉列表中，选择目标实例。
- 在 SQL 洞察 & 审计页签，单击用量查询。在用量查询面板中，可以查看最近 24 小时的存储用量、采集量与索引流量和全量聚合分析量。将鼠标悬浮于折线上，可以查看对应时间的相关数据量。
下载全量 SQL
说明
说明
如果要查看或下载导出日志文件，请单击下载图标，然后选择导出历史。
- 登录 DBW 控制台。
- 在顶部菜单栏，选择地域。
- 在左侧导航栏，选择运维管理 > 观测诊断。
- 在观测诊断页面，单击 SQL 洞察 & 审计。
- 在页面右上角的下拉列表中，选择目标数据库类型即云数据库 PostgreSQL 版。
- 在页面左上角下拉列表中，选择目标实例。
- 在 SQL 洞察 & 审计页签，按需下载 SQL 数据：
- 下载所有 SQL
- 在全量 SQL 洞察子页签的 SQL 模板区域，单击所有。
- 单击导出当前页（下载）图标。
- 在导出 SQL 模板列表对话框中，按需勾选需要导出的数据库实例字段。
- 单击确定。
- 下载收藏 SQL
- 在全量 SQL 洞察子页签的 SQL 模板区域，单击我收藏的。
- 单击导出当前页（下载）图标。
- 在导出 SQL 模板列表对话框中，按需勾选需要导出的数据库实例字段。
- 单击确定。
- 下载所有全量 SQL 明细
- 在 SQL 审计子页签的 SQL 明细中，单击下载图标，选择下载类型。
- 导出当前页
- 单击导出当前页。
- 在导出数据对话框，按需勾选需要下载的审计日志字段。
- 单击确定。
- 导出全部日志
- 导出日志
- 单击导出全部日志。
- 在导出审计日志对话框，配置相关参数信息，具体如下表所示。
-
- 单击确定。
- 下载日志
- 在 SQL 审计页签，单击下载图标，然后选择导出历史。
- 在导出历史对话框，选择状态为已生成的目标任务，单击操作列下的下载文件。
- 下载表内全量 SQL 写分析
- 在写分析子页签，按需设置时间、数据库名称、表名和节点。
- 单击目标表的名称。
- 在目标表详情控制面板，单击下载图标。
- 在导出所有 SQL 模板列表对话框，按需勾选需要导出的列表字段。
- 单击确定。
常见问题
Q：数据库审计与 SQL 洞察与审计以及全量 SQL 洞察的关系是？
- 三者之间的关系如下。
-
Q：在开启 SQL 洞察与审计前，为什么要先关闭旧版或 V1 版的数据库审计？
- 旧版数据库审计（V1）由 TLS 进行收费，新版数据库审计（V2）由 DBW 进行收费。由于开启 SQL 洞察与审计功能时，必须要开启新版数据库审计（V2）功能，为了避免出现同时收取 V1 和 V2 版数据库审计费用的情况，则需要您先关闭 V1 版数据审计功能。
Q：在 SQL 洞察与审计中，当前只开启了数据库审计，如果想再开启全量 SQL 洞察，如何操作？
- 您可以通过服务设置，开启全量 SQL 洞察功能，更多信息请参见设置 SQL 洞察与审计。
最近更新时间：2026.09.01 14:02:01
这个页面对您有帮助吗？
有用
有用
无用
无用