## 6.3.1 sql文件编写规则
sqltoy-orm的sql语句一般要求通过xml进行定义,具体格式如下:
* Sql文件必须是以.sql.xml结尾
* 一个xml文件中可以定义多个sql
* Sql的id是必须要填写的,且要唯一。
* Sql文件的xml schema一定要配置,因为有很多好的功能是需要schema自动提醒的。

:-: 图5.3.1 常规sql写法
* 核心注意点:
必要条件参数不要增加#\[\],在参数传递错误的情况下容易隐藏问题!

* **全部sql的配置参数(实际使用如图5.3.1)**
注意:下述xml中定义的功能,通过findByQuery中的QueryExecutor和findEntity中的EntityQuery基本都可以通过代码中实现,而不是必须是xml,请参见后面章节介绍


- 1.简介
- 开发历程
- 技术架构
- 问答了解
- 版本历史
- update-5.1.4、4.18.43
- update-5.1.2
- 早期历史
- 5.1.15.rc1
- 2.快速使用
- 示例与环境
- quickvo工具使用
- 用法说明
- 关键注意事项
- 严格VO(DTO)和POJO(entity)分层
- 3.教程
- spring项目搭建
- Toy-ORM 配置
- 详细配置参数
- 缓存功能
- 缓存配置、缓存扩展
- 扩展缓存框架配置
- 缓存翻译
- 其他缓存应用场景
- 公共功能
- 表(对象)关联
- 公共字段赋值
- 链式操作
- DTO与POJO互转
- 对象操作
- save + update
- delete + trunk
- load加载数据
- 唯一验证
- 树形数据
- sharding分库分表
- SQL操作
- sql文件规则
- filters说明
- 缓存翻译
- 分库分表
- 汇总、环比
- 行列转换
- 数据脱敏
- 格式化-数字日期
- sqlToy的sql查询基本规则
- Sql查询功能
- load操作
- get操作
- find操作
- 分页查询
- 并行查询
- execute操作
- executeSql
- executeStore
- 数据库特性
- 主键策略
- JSON等类型扩展支持
- 跨库说明--异种库兼容
- 数据库保留字处理
- 多源-多库-异库
- 多数据源
- Mongodb支持
- ElasticSearch支持
- 高级扩展
- 补充-if+fast+blank+value+loop
- 高级功能
- 完美sql
- 快速分页
- 缓存翻译
- 防止sql注入
- 字段加解密
- 扩展集成
