开启TaurusDB SQL审计日志

操作场景

当您开通SQL审计功能，系统会将所有的SQL操作记录下来存入日志文件，方便用户下载并查询。TaurusDB默认关闭SQL审计功能，开启此功能可能会影响数据库性能，性能影响程度与审计日志的吞吐量相关。

本章节指导您如何打开、修改或关闭SQL审计日志。

支持的数据库内核版本

内核版本必须大于等于2.0.60.241200。如果您的数据库引擎版本较低，请参考升级内核小版本升级到最新版本。内核版本的查询方法请参见如何查看云数据库 TaurusDB实例的版本号。

使用须知

表1 审计日志约束
审计日志类型	约束限制
SQL审计日志	支持TaurusDB企业版和Serverless，不支持多主实例。 SQL审计日志仅会记录在内核中已执行完成的SQL。规格变更期间，需要进行配置同步，会导致部分流量不被SQL审计日志记录。 SQL审计日志使用UTC时间，不受时区配置的影响。 SQL审计日志开通后，系统会将SQL操作记录下来，生成的审计日志文件会暂存在本地，随后上传到OBS并保存在备份存储空间。 SQL审计日志清理周期为1小时，每隔1小时清理超过保留天数的审计日志。修改审计日志的保留天数后1个小时后生效。
LTS审计日志	访问日志提供了实例所请求的所有详细日志，日志存在LTS云日志服务中。配置完成后不会立即生效，存在10分钟左右的时延，请知悉。 LTS审计日志配置成功后，会产生一定费用，具体计费可参考LTS的定价详情。在您进行LTS审计日志配置后，会默认上传所有审计策略。同时开启SQL审计和开启审计日志上传LTS：开启SQL审计和LTS审计日志开关都会生成审计日志，请注意审计日志中敏感信息没有进行脱敏处理。已开启SQL审计开关，此时再开启LTS审计日志，审计日志将延续已有的SQL操作类型策略，且会在原有的审计日志计费基础上增加您LTS的审计日志收费。原有的审计日志费用会在您关闭原有审计策略后终止。已开启SQL审计开关，此时再开启LTS审计日志，出于对实例的正常运行考虑，建议保留原有审计策略一段时间，待LTS审计日志运行正常后，再关闭原有审计策略。以下场景上传到LTS的审计日志记录可能会有丢失。若您的审计日志开关为打开的状态，您可以通过OBS下载全量的审计日志文件。在业务量大、审计日志产生速度过快或者LTS服务故障等极端情况下，有概率会丢失部分日志记录。当前上传LTS的单条审计日志记录上限为512KB，超过的部分会被截断。日志配置解除后，所生产的日志记录不会再向LTS服务上传。日志配置解除后，不会立即生效，会有10分钟左右的时延。

配置审计日志

登录TaurusDB管理控制台。
在“实例管理”页面，选择目标实例，单击实例名称，进入实例的“实例概览”页签。

在左侧导航栏单击“SQL审计”，单击“设置SQL审计”，在弹出框中设置SQL审计日志保留策略，单击“确定”，保存设置策略。

开启或修改SQL审计：

单击设置为，开启SQL审计日志保留策略。
保留天数默认为7天，可设置范围为1~732天。

图1 设置SQL审计
点击放大

MySQL客户端使用PrepareStatement和定时任务执行的SQL语句分别属于PREPARED_STATEMENT和CREATE大类，JDBC使用PrepareStatement产生的SQL语句无法过滤。

您可以在管理控制台修改“audit_log_buffer_size”参数值，调整审计日志缓冲区的大小。详细内容请参考修改TaurusDB实例参数。

表2 参数描述
参数名称	级别	默认值
audit_log_buffer_size	GLOBAL	审计日志缓冲区的大小（单位：Byte）。默认值：1048576

开启SQL审计后，支持数据定义（DDL）、数据操作（DML）、数据控制（DCL）、以及其他操作类型的权限，具体如下：

表3 DDL操作类型的权限
类型	具体权限
CREATE	create_db, create_event, create_function, create_index, create_procedure, create_table, create_trigger, create_udf, create_view
ALTER	alter_db, alter_db_upgrade, alter_event, alter_function, alter_instance, alter_procedure, alter_table, alter_tablespace
DROP	drop_db, drop_event, drop_function, drop_index, drop_procedure, drop_table, drop_trigger, drop_view
RENAME	rename_table
TRUNCATE	truncate
REPAIR	repair
OPTIMIZE	optimize

表4 DML操作类型的权限
类型	具体权限
INSERT	insert, insert_select
DELETE	delete, delete_multi
UPDATE	update, update_multi
REPLACE	replace, replace_select
SELECT	select

表5 DCL操作类型的权限
类型	具体权限
CREATE_USER	create_user
DROP_USER	drop_user
RENAME_USER	rename_user
GRANT	grant_roles, grant
REVOKE	revoke, revoke_all, revoke_roles
ALTER_USER	alter_user
ALTER_USER_DEFAULT_ROLE	alter_user_default_role

表6 其他操作类型的权限
类型	具体权限
BEGIN/COMMIT/ROLLBACK	begin, commit, release_savepoint, rollback, rollback_to_savepoint, savepoint
PREPARED_STATEMENT	execute_sql,prepare_sql, dealloc_sql
CALL_PROCEDURE	call_procedure
KILL	kill
SET_OPTION	set_option
CHANGE_DB	change_db
UNINSTALL_PLUGIN	uninstall_plugin
INSTALL_PLUGIN	install_plugin
SHUTDOWN	shutdown
SLAVE_START	slave_start
SLAVE_STOP	slave_stop
LOCK_TABLES	lock_tables
UNLOCK_TABLES	unlock_tables
FLUSH	flush
XA	xa_commit,xa_end,xa_prepare,xa_recover,xa_rollback,xa_start