mycat用户手册

### Mycat 1.5 用户手册关键知识点概览 #### 一、重要改进与新功能 **1. 支持Galera集群状态检测同步切换机制** - **概述**: Mycat 1.5 首次支持基于Galera集群的状态检测同步切换机制，这种机制可以在集群节点出现故障时自动进行排查并进行相应的同步切换，确保服务的连续性和高可用性。 - **应用场景**: 适用于使用Galera集群架构的企业级应用，特别是那些对于数据一致性和服务连续性要求极高的场景。 **2. 引入Zookeeper** - **概述**: Mycat 1.5 引入了Zookeeper作为其分布式协调服务，这使得Mycat能够更好地管理和协调集群中的各个组件，同时提供了可视化的管理界面。 - **应用场景**: 适用于需要高可用性、分布式协调和管理复杂集群环境的应用场景。 **3. 安全性增强** - **概述**: 包括IP白名单、SQL黑名单、数据库账号密码加密等功能，增强了Mycat的安全性。 - **应用场景**: 适用于需要严格控制访问来源、防止恶意SQL注入攻击以及保护敏感数据的应用场景。 **4. 连接管理改进** - **概述**: 修复了在LVS等前端负载均衡器模式下，频繁建立和关闭连接可能导致的连接ID整数越界问题。 - **应用场景**: 对于依赖于高并发连接处理的应用场景尤为重要。 **5. SQL执行改进** - **概述**: 支持SQL指定到分片执行，改进了`reload@@config`命令，避免了因频繁重载配置而导致的系统卡死问题。 - **应用场景**: 适用于需要高效地执行复杂查询以及动态更新配置的应用场景。 **6. 监控与调试工具** - **概述**: 新增了多种监控和调试工具，如慢SQL监控功能(`show@@sql.slow`)、远程查看日志的指令(`show@@syslog limit=10`)等。 - **应用场景**: 适用于需要实时监控系统性能和诊断问题的应用场景。 **7. 服务降级配置** - **概述**: 增加了用户(mycatuser)服务降级的配置及测试功能，即使在写服务挂掉的情况下，读服务仍然可用。 - **应用场景**: 适用于高流量应用，特别是在高峰期为了保证基本服务可用性而采取的措施。 **8. 统计服务** - **概述**: 新增统计服务功能，可以根据用户的使用情况统计SQL执行情况，并提供图表展示。 - **应用场景**: 适用于需要对SQL执行效率进行精细化管理的应用场景。 **9. 兼容性改进** - **概述**: 新增对mysqljdbc 5.1.37的支持，增加了对CURD语句的过滤功能等。 - **应用场景**: 适用于使用特定版本MySQL驱动的应用程序。 **10. 错误修复** - **概述**: 修复了多个重要缺陷，包括loaddata语句对不同字符集的支持、explain显示缺陷等。 - **应用场景**: 所有使用Mycat 1.5的应用场景都会从中受益，尤其是那些依赖于数据准确性和系统稳定性的场景。 #### 二、新增功能详细说明 **1. show@@sysparam指令** - **描述**: 用于查看系统参数。 - **使用方法**: `show@@sysparam`。 **2. loaddata对转义字符的支持** - **描述**: 支持loaddata命令中转义字符的正确解析。 - **使用方法**: 在使用loaddata命令时确保特殊字符被正确转义。 **3. 循环使用的日期分片规则** - **描述**: 提供了一种新的日期分片策略，允许按照循环方式进行数据分片。 - **使用方法**: 配置schema.xml中的日期分片规则。 **4. 慢SQL监控功能** - **描述**: 可以通过`show@@sql.slow`命令查看慢查询。 - **使用方法**: 执行`show@@sql.slow`来查看慢查询列表。 **5. 归并监控SQL** - **描述**: 对特定SQL进行归并监控，以便于问题定位。 - **使用方法**: 配置特定SQL进行监控。 **6. 远程查看日志指令** - **描述**: 使用`show@@syslog limit=10`命令可以在客户端远程查看系统日志信息。 - **使用方法**: 输入`show@@syslog limit=10`，`limit`后的数字用于限制日志显示的数量。 **7. 读写权重配置** - **描述**: 允许配置不同的读写权重，优化数据访问模式。 - **使用方法**: 在配置文件中设置读写权重。 **8. 心跳曲线监控功能** - **描述**: 提供了对心跳时间精度的监控，并以曲线形式展示。 - **使用方法**: 通过管理界面查看心跳曲线。 **9. 主从同步监控功能** - **描述**: 实现了对主从同步状态的监控。 - **使用方法**: 通过管理界面或命令行工具查看主从同步状态。 **10. 集群心跳检测功能** - **描述**: 支持集群内各节点的心跳检测。 - **使用方法**: 自动进行检测，无需手动配置。 **11. syslog指令帮助** - **描述**: 提供了关于`syslog`指令的帮助文档。 - **使用方法**: 查看帮助文档了解如何使用`syslog`指令。 **12. 用户服务降级配置** - **描述**: 允许在部分服务不可用时，降级提供有限的服务。 - **使用方法**: 配置降级策略并在必要时启用。 **13. prepare记录** - **描述**: 记录prepared statements的相关信息。 - **使用方法**: 通过管理界面查看prepare记录。 **14. connection执行SQL记录** - **描述**: 记录每个连接上次执行的SQL语句。 - **使用方法**: 通过管理界面查看connection的SQL执行记录。 **15. Zookeeper数据写入本地XML文件** - **描述**: 可以将Zookeeper上保存的数据写入本地XML文件。 - **使用方法**: 配置相关选项将数据写入本地XML文件。 **16. 表级别统计分析** - **描述**: 提供针对表级别的统计分析功能。 - **使用方法**: 使用特定命令进行表级别统计分析。 **17. SQL执行情况统计数据重置** - **描述**: 可以通过`show@@sql@@sql.sum@@sql.slow`命令重置统计数据。 - **使用方法**: 执行`show@@sql@@sql.sum@@sql.slow`。 **18. reload@@user_stat指令** - **描述**: 用于重新加载用户统计信息。 - **使用方法**: 执行`reload@@user_stat`。 **19. sqlhint通过datanode路由** - **描述**: 支持通过datanode路由使用sqlhint。 - **使用方法**: 在SQL语句中使用sqlhint。 **20. 并发数显示字段重构** - **描述**: 改进了并发数显示字段。 - **使用方法**: 查看并发数相关数据。 **21. tempReadHostAvailable定义** - **描述**: 在DTD中新增了tempReadHostAvailable定义。 - **使用方法**: 在DTD文件中查看定义。 **22. Zookeeper配置文件上传下载** - **描述**: 支持Zookeeper配置文件的上传和下载。 - **使用方法**: 使用相关命令进行配置文件的上传和下载。 **23. explain2命令** - **描述**: 通过datanode获取物理节点的SQL解析。 - **使用方法**: 使用`explain2`命令获取SQL解析结果。 **24. 默认节点的showtable命令** - **描述**: 支持默认节点的`showtable`命令。 - **使用方法**: 执行`showtable`查看默认节点下的表信息。 **25. IP白名单与密码加密** - **描述**: 支持IP白名单和密码加密功能。 - **使用方法**: 在配置文件中设置IP白名单和密码加密选项。 **26. table级别的统计分析** - **描述**: 支持针对特定表的统计分析功能。 - **使用方法**: 使用特定命令进行table级别的统计分析。 **27. SQL黑名单** - **描述**: 支持SQL黑名单功能。 - **使用方法**: 配置SQL黑名单，阻止特定SQL语句执行。 **28. 高频SQL分析** - **描述**: 分析高频执行的SQL语句。 - **使用方法**: 使用特定命令查看高频SQL分析结果。 **29. CURD语句过滤** - **描述**: 支持对非CURD语句的过滤。 - **使用方法**: 配置过滤规则。 **30. MySQLJDBC支持** - **描述**: 支持MySQL JDBC 5.1.37。 - **使用方法**: 使用兼容版本的MySQL JDBC驱动。 #### 三、已修复的问题 Mycat 1.5还修复了多个重要问题，包括但不限于： - **loaddata字符集支持问题** - **explain显示缺陷** - **tempSchema空指针错误** - **PHP字符集设置错误** - **跨分片处理时主动关闭后端的问题** - **分页无效遍历** - **update别名路由错误** - **DDL路由BUG** - **执行DDL语句的大写转换问题** - **CREATE/DROP INDEX功能** - **DDLRouteTest测试用例问题** - **order漏判断limitsize=-1功能** - **排序问题** - **集群中多主监控未获取到数据问题** - **limit-1返回控制问题** - **zkcreate1.8方法问题** - **switchtype=-1重启自动切换问题** - **5.1.35 show语句误判问题** - **bufferpool单位问题** 这些修复显著提高了Mycat的稳定性和兼容性，对于使用Mycat的应用来说是非常重要的改进。