---
title: "AUDIT_LOG_FILTER_SET_USER - OceanBase 数据库 V4.4.2 | OceanBase 文档中心"
description: "AUDIT_LOG_FILTER_SET_USER 描述 该函数（表达式）用于将过滤器设置到用户上。 功能适用性 该内容仅适用于 OceanBase 数据库企业版，OceanBase 数据库社区版暂不支持审计功能。 语法 AUDIT_LOG_FILTER_SET_USER('user_name', 'filter_n…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.4.2 LTS

# AUDIT_LOG_FILTER_SET_USER

更新时间：2026-07-16 20:01:47

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.4.2/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/400.functions-of-mysql-mode/970.audit-functions-of-mysql-mode/500.audit-log-filter-set-user-of-mysql-mode.md)  

## 描述

该函数（表达式）用于将过滤器设置到用户上。

#### 功能适用性

该内容仅适用于 OceanBase 数据库企业版，OceanBase 数据库社区版暂不支持审计功能。

## 语法

```sql
AUDIT_LOG_FILTER_SET_USER('user_name', 'filter_name');

```

## 说明

### 参数解释

- `user_name`：用于指定用户名称。

  #### 说明

  `AUDIT_LOG_FILTER_SET_USER` 指定的 `user@host` 不要求是已存在的用户，可以写通配符或不存在的用户。`user_name` 有以下限制：

     - 不支持指定 `host` 字段。
     - `user` 只支持对整个字段进行通配，即 `%`，不支持 `test_%` 这种部分通配的写法。
 - `filter_name`：用于指定过滤器名称。

  #### 说明

  `AUDIT_LOG_FILTER_SET_USER` 是 `CREATE OR REPLACE` 语义，对已存在的对象执行 DDL 会覆盖。指定的 `filter_name` 不存在时，DDL 不生效但也不报错。

### 返回值

表达式输入必须是字符串常量，输出是字符串类型。

- 当 DDL 执行成功时，表达式返回 `OK`。
 - 当 DDL 执行失败时，`SELECT` 语句仍然执行成功，表达式的输出结果为错误信息。

## 示例

将过滤器 `log_all` 设置到用户上 `user001`。

```sql
SELECT AUDIT_LOG_FILTER_SET_USER('user001', 'log_all');

```

返回结果如下：

```shell
+-------------------------------------------------+
| AUDIT_LOG_FILTER_SET_USER('user001', 'log_all') |
+-------------------------------------------------+
| OK                                              |
+-------------------------------------------------+
1 row in set

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线