{"id":18802399,"url":"https://github.com/jd-opensource/vtdriver","last_synced_at":"2025-04-11T11:09:09.644Z","repository":{"id":37100071,"uuid":"431048647","full_name":"jd-opensource/vtdriver","owner":"jd-opensource","description":null,"archived":false,"fork":false,"pushed_at":"2024-06-05T01:23:44.000Z","size":5476,"stargazers_count":85,"open_issues_count":8,"forks_count":16,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-25T07:36:07.430Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jd-opensource.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-23T10:03:01.000Z","updated_at":"2025-03-19T09:38:56.000Z","dependencies_parsed_at":"2024-01-05T03:30:49.189Z","dependency_job_id":"9fb7c901-4db6-4b5c-8f9b-9f571351c199","html_url":"https://github.com/jd-opensource/vtdriver","commit_stats":null,"previous_names":["jd-opensource/vtdriver"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvtdriver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvtdriver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvtdriver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jd-opensource%2Fvtdriver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jd-opensource","download_url":"https://codeload.github.com/jd-opensource/vtdriver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248381787,"owners_count":21094526,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T22:27:56.405Z","updated_at":"2025-04-11T11:09:09.623Z","avatar_url":"https://github.com/jd-opensource.png","language":"Java","readme":"# VtDriver\n[![build\u0026test](https://github.com/vtdriverio/vtdriver/actions/workflows/maven_test.yml/badge.svg?branch=main)](https://github.com/vtdriverio/vtdriver/actions/workflows/maven_test.yml)\n---\n[English Docs](./docs/readme.en.md)\n\nVtDriver是一套基于分布式数据库Vitess而开发的Vitess\nJava客户端解决方案，在Java的JDBC层实现了Vitess关于分库、健康检查、灵活水平拆分和主从切换等额外服务。VtDriver通过jar包的形式提供服务，帮助应用程序直连数据库而非使用中间代理（VTGate）节点。因为完全基于标准的JDBC接口来实现的，VtDriver可以理解为Vitess的JDBC驱动，兼容JDBC、大部分主流数据库链接池和ORM框架。\n\n## Content Table\n\n* [Why VtDriver](#why_vtdriver)\n* [Architecture](#architecture)\n* [Quick Start](#quick_start)\n* [Features/Configuration](#features)\n* [Road Map](#road_map)\n* [Acknowledgements](#acknowledgements)\n\n## \u003cp id=\"why_vtdriver\"\u003eWhy VtDriver\u003c/p\u003e\n\nVtDriver是对Vitess生态的一种解决方案补充，旨在缩短数据访问链路、提高性能和节约资源，从而达到节能增效的目的，适用于Java开发的对性能有极高要求的OLTP应用和对资源消耗有极其严苛限制的场景，以下图为例：\n\n![image](./docs/VtDriver.png)\n\n如图左所示，作为一款分布式数据库，Vitess开发了一些中间代理模块来解决异构语言、集群管理/保护、数据同步和适配多数据引擎等问题。这样的设计能够为数据库带来高可用、灵活性和扩展性。但出于提升数据库性能，降低访问时延和节约资源的考虑，VtDriver在最消耗资源的sql请求和数据返回的链路上做出了改变，如上图所示。\n\n相比于Vitess，一个数据请求（DML）从应用端发出到接收，需要经过 app-\u003eVTGate-\u003eVTTablet-\u003edatabase-\u003eVTTablet-\u003eVTGate-\u003e\napp的路径，VtDriver通过jar包的形式将VTGate的能力（分布式SQL改写、结果收集处理、健康检查/切换）赋能给了各应用程序节点，使得应用程序能够直接访问数据库app -\u003edatabase\n（图右所示），从而减少了网络上的开销。并且，因为降低了对于中间节点的依赖，可以不再像原来一样需要投入大量资源来维护中间节点的稳定性，对于那些非常在意CPU资源消耗的使用者来说，更加合适。\n\n需要注意的是，VtDriver是Vitess生态的补充方案而非替代方案，VtDriver仍然需要与VTTablet，Topo元数据等进行交互，来完成健康检查、故障自动切换和横向扩缩容等功能。因此在部署上仍然需要先搭建一套完整的Vitess架构。此外，因为跳过了VTTablet直连数据库，在某些情况下也会造成数据库链接消耗过大的情况，这也需要使用者在使用时注意。以下是使用Vitess传统链接方式VTGate和VtDriver方式所带来的一些特点的比较：\n\n|            | **Vitess-VTGate** | **Vitess-VtDriver** |\n| ---------- | ----------------- | --------------- |\n| 链接数消耗 | 低                | 高              |\n| 异构语言   | 任意              | 仅Java          |\n| 性能       | 损耗略高          | 损耗低          |\n| 客户端入口 | 有                | 无              |\n\n## \u003cp id=\"architecture\"\u003eArchitecture\u003c/p\u003e\n\n如图所示，是VtDriver的设计架构，主要分为接口API模块，查询计划生成的Plan模块，负责执行和计算的Engine模块，负责事务的TX模块，数据库底层连接的Datasource模块和分布式数据库管理的Topo模块：\n\n![image](./docs/Architecture.png)\n\n* __API__：实现了JDBC标准接口模块，Java用户只需要替换驱动，代码不需要做任何修改便可使用VtDriver\n* __Plan__：基于SQL请求和数据库Topo元数据生成相应的执行计划\n* **Engine**：负责执行Plan生成的执行计划，并收集和计算各个分片返回的结果\n* **TX**：负责单库时候和多库执行时候的事务管理， 严格的两阶段提交功能目前还在开发当中\n* **Datasource**：负责与各个分片集群的真实数据库的连接，包括了连接池管理，驱动管理（目前仅支持MySQL）和配置管理\n* **Topo Management**\n  ：负责读取和管理分布式数据库的Topo信息和元数据，包括了Tablet信息和状态、数据库表信息和分表Index，实时健康检查，并负责在监测到Tablet异常、主从切换或resharding完成的时候执行响应操作\n\n## \u003cp id=\"quick_start\"\u003eQuick Start\u003c/p\u003e\n\n* 可参考[VtDriver环境搭建](./docs/QuickStart.md)\n\n## \u003cp id=\"features\"\u003eFeatures/Configuration\u003c/p\u003e\n\n因为是基于Vitess开发出来的Java 驱动客户端，因此VtDriver在很多方面保持了跟Vitess一样的特性，比如分片执行计划/引擎、事物管理、topo和健康管理等。不过因为VtDriver是以Java\nJDBC驱动为目的开发的，导致其在某些方面的设计与以数据库服务器为特性开发的Vitess VTGate有些许不同，并且大部分配置信息通过url进行配置。另外，基于业务等需求等原因，我们也在Vitess上面加了些许新的功能。\n\n### Split Table：\n\n分表是VtDriver开发的一个新功能点，基于现有的分片执行计划/引擎基础开发而来，主要针对单表数据量过大而影响性能的问题。具体可查看[VtDriver分表](./docs/splitTable.md)\n\n### Read-Write Splitting：\n\n不同于Vitess读写分离，VtDriver通过在datasource的Url中配置role=rr/rw来确定读写分离，默认为读主。\n\n### Consolidation：\n\nQuery\nConsolidation是Vitess在VTTablet层开发的一个用以保护数据库不受某个特定慢查询反复同时执行拖累而过载的一个功能，VtDriver将其移植到了驱动层。其原理是当一个SQL请求发给VtDriver，VtDriver监测到其一样的一个SQL请求还在执行当中时，会将当前SQL请求暂存，等到其前一个SQL请求的返回结果，并将其返回结果同时也当作当前SQL的返回结果返回。\n\n与读写分离一样，该功能同样需要其在datasource的Url中配置queryConsolidator=true。\n\n### Specified Shard Destination\n\nVtDriver/Vitess通过解析SQL语句中的分片键与值来判断SQL需要被发往哪个分片的。但是有些时候，分片条件并不存在于SQL，而存在于外部业务逻辑。因此，VtDriver允许使用者通过发送sql带注释的方式，在执行计划前解析注释中set_shard指令来确定是否需要指定分片执行，例如：/\\*shard=-80\\*/\nselect \\* from table。\n\n需要注意的是，出于水平扩展的考虑，指定分片只支持update\\delete\\select，不支持insert。另外，如果数据库进行了水平拆分，需要修改指定shard范围，否则会报错。\n\n### VtDriver支持配置的参数\n\n* [VtDriver支持配置的参数](./docs/properties.md)\n\n## \u003cp id=\"road_map\"\u003eRoad Map\u003c/p\u003e\n\n### Database\n\n* Vitess based on MySQL （其他数据库产品，直连MySQL暂不支持）\n\n### VIndex\n\n* 仅支持murmurHash Vitess的分片算法目前暂未实现\n\n### DML/DDL\n\n* Select/Insert/Update/Delete\n* 部分SET语句\n* SHOW语句暂不支持\n* DDL语句暂不支持\n\n### SQL\n\n* AGGREGATION\n* DISTINCT\n* HAVING\n* ORDER BY\n* GROUP BY\n* JOIN\n* UNION / UNION ALL\n* SUBQUERY / PULLOUT SUBQUERY\n\n详细内容请参考 [VtDriver支持的SQL](./docs/VtDriver支持的SQL.md)。\n\n### Query Method\n\n* Simple Query\n* Stream Query\n* MultiQuery (JOIN/UNION/PULLOUT SUBQUERY不支持)\n\n### Auto Increment Key\n\n* Sequence （暂不支持）\n\n### Distributed Transactions\n\n* best-effort distributed transactions\n* 暂不支持2PC (two-phase commit)\n\n## \u003cp id=\"acknowledgements\"\u003eAcknowledgements\u003c/p\u003e\n\nVtDriver在开发中借鉴了许多开源的程序、框架的方法和意见，在此做出感谢，是他们让我们站在了巨人的肩膀上去眺望世界：\n\n* [Vitess](https://vitess.io/)\n* [Druid](https://github.com/alibaba/druid)\n* [mysql-connector](https://github.com/mysql/mysql-connector-j)\n* [prometheus](https://prometheus.io/)\n* [HikariCp](https://github.com/brettwooldridge/HikariCP)\n* [ShardingSphere](https://shardingsphere.apache.org/)\n\nNote: 以上特别感谢Vitess，Vitess给我们节省大量研发成本，感谢[PlanetScale CTO Sugu Sougoumarane](https://github.com/sougou) 对我们团队的支持。\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjd-opensource%2Fvtdriver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjd-opensource%2Fvtdriver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjd-opensource%2Fvtdriver/lists"}