视图本身不提供rest行为，仅是sql逻辑封装；对外暴露rest接口需依赖上层工具（如sqlrest、azure数据api生成器），且视图必须满足字段名ascii化、禁用order by/limit、时间字段转iso 8601、命名规范及权限授权等硬性约束，否则导致字段丢失、分页失效、时区错误或接口不可用。

视图本身不提供 REST 行为，它只是 SQL 层的逻辑封装；真正对外暴露 REST 接口的是上层工具（如 SQLREST、QuickAPI 或 Azure 的数据 API 生成器），而视图必须满足几个硬性约束，否则这些工具无法正确映射字段、生成 JSON 响应或处理分页/过滤。

字段名必须全为 ASCII，且不能含空格或保留字

很多工具在解析视图元数据时直接将列名映射为 JSON key，一旦出现中文别名（如 昵称 AS name）、带空格的别名（last login time AS last_login_time）或与 SQL 保留字冲突的字段（如 order, group），就会导致字段丢失、解析失败或返回空对象。

• ✅ 正确写法：COALESCE(nickname, '') AS nick_name、status AS user_status
• ❌ 错误写法：nickname AS 昵称、status AS status（与列同名但未加表前缀，在多表 JOIN 视图中可能歧义）
• ⚠️ 注意：SQLREST 在启动时会扫描视图字段，若发现非 ASCII 字符，会跳过该字段且不报错——你只能在调用接口时发现返回 JSON 缺字段

避免在视图定义中使用 ORDER BY 或 LIMIT

ORDER BY 在视图中是非法的（MySQL 8.0+ 允许但多数 REST 工具不兼容），而 LIMIT 会彻底破坏分页能力——因为上层工具通常靠自身参数（如 ?page=1&size=20）控制分页，若视图里已写死 LIMIT 10，所有请求都只返回前 10 条，且无法跳转下一页。

• ✅ 正确做法：把排序逻辑交给 API 工具（如 SQLREST 支持 sort 查询参数）或由客户端传参控制
• ❌ 错误写法：SELECT * FROM users ORDER BY created_at DESC、... LIMIT 50
• ? 补充：SQLREST 的 DSL 模式支持动态 ORDER BY #sort#，比在视图里硬编码更灵活

时间字段需显式转为 ISO 8601 字符串格式

REST 客户端（尤其是前端 JS）依赖标准时间字符串解析，而数据库原生 DATETIME 类型在 JSON 序列化时行为不一致：MySQL 可能返回 "2026-09-18 01:28:00"，PostgreSQL 可能带时区，SQL Server 可能含毫秒。视图必须统一转换。

• ✅ MySQL：DATE_FORMAT(created_at, '%Y-%m-%dT%TZ') AS created_time
• ✅ PostgreSQL：to_char(created_at AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS created_time
• ✅ SQL Server：FORMAT(created_at AT TIME ZONE 'UTC', 'yyyy-MM-ddTHH:mm:ssZ') AS created_time
• ⚠️ 注意：SQLREST 不自动做时区归一化，若数据库字段没转，它就原样吐出字符串，前端 new Date() 可能解析失败或偏移 8 小时

权限与命名需匹配工具识别规则

工具不是“连上数据库就能扫到所有视图”，它们往往按命名约定或权限范围筛选数据源。比如 QuickAPI 默认只加载 V_ 开头的视图，而 SQLREST 虽无强制前缀，但若视图名含 - 或 .，其自动生成的 endpoint 路径会出问题（如 /api/user-profile 可能被解析为两个路径段）。

• ✅ 命名建议：V_user_summary、api_order_list（全小写 + 下划线）
• ✅ 权限命令：GRANT SELECT ON your_db.V_user_summary TO 'api_user'@'%'，漏掉这条，工具连视图结构都读不到
• ⚠️ 关键点：有些工具（如 Azure 数据 API 生成器）要求视图必须属于特定 schema（如 dbo），跨 schema 视图需显式授权并配置 schema 白名单

最常被忽略的是字段类型隐式转换——比如 CASE WHEN status='active' THEN 1 ELSE 0 END AS is_active 在 MySQL 中返回 TINYINT，但某些工具会把它当字符串处理；稳妥做法是加 CAST(... AS UNSIGNED) 或直接写 '1'/'0' 并注释说明布尔语义。这不像语法错误会立刻报错，而是在前端开关组件绑定时悄悄失效。