Zion建表字段命名须严格遵循MySQL规范、布尔字段用is_前缀且类型为tinyint(1)、业务字段加user_/company_/log_等前缀、敏感字段使用bank_account/credential_no/phone等标准命名,否则将导致建表失败或安全策略失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用函子Zion建表时,字段命名直接影响后续SQL生成、API映射、数据字典自动生成及团队协作效率,不是随便起个名字就能通过校验或被系统识别的。
字段命名必须符合MySQL基础规范
第一步:所有字段名必须为小写字母、数字或下划线,禁止大写字母、中文、空格、特殊符号(如$、#、@);【违反将导致建表语句直接报错】。
第二步:字段名不能以数字开头,例如 3rd_user 或 2024_status 都非法;两个下划线之间不能只出现数字,例如 level__3_name 是明确禁止的。
第三步:禁用MySQL保留字,比如 desc、range、match、delayed、order、group 等——Zion在解析DDL前会做静态词法检查,命中即中断建表流程。
布尔型字段必须用 is_xxx 命名
方法一:统一使用 is_ 开头 + 小写名词,如 is_deleted、is_verified、is_premium。
方法二:字段类型必须为 unsigned tinyint(1),值域仅允许 0 或 1;【若定义为 int、boolean 或 varchar,Zion 会拒绝生成 migration 脚本】。
这一步不能妥协:Zion 的 SDK 自动生成逻辑(如 Java Entity、TypeScript Interface)依赖 is_xxx 前缀识别布尔语义,否则前端开关组件、后端条件判断都会出错。
业务字段需按体系加前缀
① 用户相关字段:user_id、user_name、user_phone、user_avatar_url。
② 机构相关字段:company_id、company_code、company_status。
③ 日志相关字段:log_type、log_content、log_ip、log_duration_ms。
④ 系统通用字段:id、created_at、updated_at、is_deleted —— 这三字段为强制内置,Zion 在建表时自动注入,无需手动声明。
注意:前缀不是可选项,而是Zion元数据扫描的识别锚点。比如你写 phone 而非 user_phone,Zion 就无法将其归类到用户上下文,后续权限策略、审计日志、脱敏规则都将失效。
敏感字段命名有固定词典
方法1:银行卡号 → bank_account
方法2:身份证号 → credential_no
方法3:手机号 → phone
方法4:邮箱 → email
方法5:车牌号 → licence_no
方法6:设备唯一标识 → imei 或 mac(不可写作 device_id 或 uuid)
Zion 内置敏感字段识别引擎,只认这些标准命名。你写 user_mobile 或 id_card_number,系统不会触发自动加密、日志脱敏、导出拦截等安全策略。











