---
description: 存储用户组基本信息及其层级、排序和分组归属。
navTitle: USER_GROUPS
---
# **USER\_GROUPS 用户组表**

用户组表用于存储用户组信息。用户组可以通过人工维护成员，也可以通过匹配条件自动圈选用户，常用于批量授权、菜单可见范围、授信应用可用范围和数据权限配置。

## 位置{#position}

模型路径：`/sysdata/data/tables/sec/USER_GROUPS.tbl`

物理表名：`SZSYS_5_USER_GROUPS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| GROUP\_ID | VARCHAR(64) | ID，用户组表主键，创建用户组时默认与用户组编号相同，创建后不可再修改，主键 |
| GROUP\_NUMBER | VARCHAR(64) | 用户组编号，用于业务识别和外部同步 |
| GROUP\_NAME | VARCHAR(128) | 用户组名称 |
| MATCH\_EXP | VARCHAR(1024) | 用户匹配条件，用于自动匹配符合条件的用户 |
| DESC | VARCHAR(1024) | 描述信息 |
| CREATE\_TIME | TIMESTAMP | 创建时间 |
| MODIFY\_TIME | TIMESTAMP | 修改时间 |
| CREATOR | VARCHAR(64) | 创建者 |
| MODIFIER | VARCHAR(64) | 修改者 |
| ENABLED | NUMBER(1) | 是否启用，1代表启用，0代表禁用 |
| REFRESH\_STATE | NUMBER(1) | 用户组映射关系刷新状态，1代表已刷新，0代表待刷新 |
| CATALOG | VARCHAR(32) | 分组 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | GROUP\_ID | 是 | 唯一标识一条记录 |
| 索引 | - | - | - | 该表未定义其他索引 |

## 使用注意{#notice}

1. `GROUP_ID` 是稳定标识，创建后不建议修改；`GROUP_NUMBER` 是用户组编号，便于业务识别和同步。
2. `MATCH_EXP` 会影响自动成员范围，调整前应确认会新增或移除哪些用户。
3. `REFRESH_STATE` 表示自动成员关系是否已刷新；当匹配条件调整后，成员结果可能需要刷新后才完全生效。