---
title: "oceanbase.DBA_OB_USER_DEFINED_RULES - OceanBase 数据库 V4.4.2 | OceanBase 文档中心"
description: oceanbase.DBA_OB_USER_DEFINED_RULES 说明 该视图从 V4.1.0 版本开始引入。 功能描述 记录了当前租户下自定义改写 SQL 语句的规则。 字段说明 字段 类型 是否可以为 NULL 描述 DB_NAME varchar(128) NO 规则定义时指定的 DB_NAME RULE…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# oceanbase.DBA_OB_USER_DEFINED_RULES

更新时间：2026-07-13 20:58:52

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.4.2/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/24000.o-dba_ob_user_defined_rules-of-sys-tenant.md)

#### 说明

该视图从 V4.1.0 版本开始引入。

## 功能描述

记录了当前租户下自定义改写 SQL 语句的规则。

## 字段说明

| 字段 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| DB_NAME | varchar(128) | NO | 规则定义时指定的 DB_NAME |
| RULE_NAME | varchar(256) | NO | 规则名称 |
| RULE_ID | bigint(20) | NO | 规则 ID |
| PATTERN | longtext | NO | 规则匹配的语句的模板 |
| REPLACEMENT | longtext | NO | 指示如何重写与 Pattern 匹配的语句模板 |
| NORMALIZED_PATTERN | longtext | NO | 参数化之后的 Pattern |
| STATUS | varchar(10) | NO | - ENABLE 指当前规则生效 - DISABLE 指当前规则不生效 |
| VERSION | bigint(20) | NO | 规则版本号 |
| PATTERN_DIGEST | bigint(20) unsigned | NO | NORMALIZED_PATTERN 的 Hash 值 |

## 查询示例

查看本租户的自定义改写 SQL 语句的规则。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_USER_DEFINED_RULES;

```

查询结果如下：

```shell
+---------+-----------+---------+--------------------+------------------------+--------------------+--------+---------+---------------------+
| DB_NAME | RULE_NAME | RULE_ID | PATTERN            | REPLACEMENT            | NORMALIZED_PATTERN | STATUS | VERSION | PATTERN_DIGEST      |
+---------+-----------+---------+--------------------+------------------------+--------------------+--------+---------+---------------------+
| test    | rule1     |  500019 | select ? from dual | select ? + 1 from dual | select ? from dual | ENABLE |       3 | 2647993221679348756 |
+---------+-----------+---------+--------------------+------------------------+--------------------+--------+---------+---------------------+
2 rows 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) 咨询热线