---
description: 记录用户维度的自定义配置键值，用于保存个性化设置或功能配置。
navTitle: CUSTOM_CONFS
---
# **CUSTOM\_CONFS 用户自定义配置表**

记录用户维度的自定义配置键值，用于保存个性化设置或功能配置。

该表适合保存轻量级、可按用户区分的配置，例如界面偏好、功能开关、最近使用项或全局级配置。配置由业务功能按键值读写，值通常是字符串或序列化后的文本。

同一个 `CONF_KEY` 可以分别保存用户级配置和全局配置。用户级配置随用户或功能使用产生，清空配置时删除对应键值；全局配置用于所有用户共享的默认设置。

旧声明中曾把此能力拆成 `USER_CUSTOM_SETTINGS` 和 `PAGE_CUSTOM_SETTINGS` 两类逻辑表，字段名为 `SETTING_KEY`、`SETTING_VALUE`，页面级还包含 `PAGE_ID`，并列出 `CREATE_TIME`、`CREATOR`、`MODIFY_TIME`、`MODIFIER` 等审计字段。当前实现以 `CUSTOM_CONFS.tbl` 为唯一真实表，`$SYSTBL:/MY/CUSTOM_SETTINGS.tbl` 会映射到此表，并自动追加 `USER_ID = $user` 过滤。旧 `SETTING_KEY`、`SETTING_VALUE` 语义分别对应当前 `CONF_KEY`、`CONF_VALUE`；页面级配置应由调用方在 `CONF_KEY` 中编码页面或组件范围。当前真实表未保存旧声明中的页面ID和审计字段。

## 位置{#position}

模型路径：`/sysdata/data/tables/sys/CUSTOM_CONFS.tbl`

物理表名：`SZSYS_5_CUSTOM_CONFS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| USER\_ID | VARCHAR(50) | 用户ID，主键 |
| CONF\_KEY | VARCHAR(512) | 配置键，主键 |
| CONF\_VALUE | BLOB | 配置值，保存字符串或序列化后的配置内容 |

## 表索引{#indexes}

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