0

0

SQL Vitess 的 VSchema 的 sharded vs unsharded 表类型划分

舞姬之光

舞姬之光

发布时间:2026-02-21 16:44:09

|

669人浏览过

|

来源于php中文网

原创

vitess中sharded表必须显式配置vindex,否则查询失败;unsharded表需声明类型但不可配vindex;join时sharded表须等值关联其vindex列;表类型变更需停服重刷,不支持在线切换。

sql vitess 的 vschema 的 sharded vs unsharded 表类型划分

sharded 表必须显式指定 vindex,否则查询会失败

Vitess 要求所有 sharded 表在 VSchema 中绑定一个有效的 vindex(如 unicode_loose_md5 或自定义函数),否则路由层无法决定数据该发往哪个分片。SELECT * FROM user WHERE id = 123 这类语句在未配置 vindex 时会直接报错:no vindex found for column 'id'

  • 常见错误:只写了 "type": "sharded",但漏掉 "vindexes" 字段或拼错字段名(比如写成 vindex 单数)
  • vindex 必须和 CREATE TABLE 中的列名完全一致,大小写敏感
  • 如果用复合主键,vindex 只能绑定其中一列——Vitess 不支持多列联合 vindex
  • 自定义 vindex 函数需提前注册到 VTTablet,且返回值类型要与目标列兼容(如 BIGINT 列不能配返回 STRING 的 vindex)

unsharded 表仍需声明,但可省略 vindex

unsharded 表本质是全局表(通常放在 0 分片),Vitess 仍要求你在 VSchema 中明确声明其类型,否则会被默认当成 sharded 处理,进而触发 vindex 检查并失败。

  • 典型场景:配置 regioncountry_code 这类小而稳定的维度表
  • 正确写法是:"type": "unsharded",不带 vindexes 字段;加了反而报错:unsharded table cannot have vindexes
  • 注意:即使物理上只有一份数据,unsharded 表的 DML 仍受 Vitess 事务协调器管控,跨分片事务中它会被当作“参与者”处理
  • 性能影响:对 unsharded 表的读请求会固定路由到 0 分片,高并发下可能成为瓶颈,别把它当缓存用

混合使用 sharded 和 unsharded 表时,JOIN 有硬性限制

Vitess 允许 sharded 表和 unsharded 表 JOIN,但前提是 sharded 表的 JOIN 条件必须命中其 vindex 列,且该列是等值条件(=),否则报错:cannot join sharded table without equality condition on vindexed column

Voicenotes
Voicenotes

Voicenotes是一款简单直观的多功能AI语音笔记工具

下载
  • 允许:SELECT u.name, c.name FROM user u JOIN country c ON u.country_id = c.id(假设 user.country_id 是 vindexed 列)
  • 不允许:ON u.country_id > c.idON u.email LIKE CONCAT('%', c.code, '%')、或 ON u.created_at = c.updated_at(非 vindex 列)
  • 如果 JOIN 条件没走 vindex 列,Vitess 会拒绝执行,不会退化为广播查询
  • 多个 unsharded 表之间 JOIN 没限制,但一旦引入 sharded 表,规则立刻生效

修改表类型需停服重刷,没有在线切换路径

Vitess 不支持运行时把 sharded 表改成 unsharded,或反过来。变更必须先停写、导出数据、更新 VSchema、重建分片映射、再导入——整个过程涉及 vtctlclient ApplySchemaApplyVSchema 两步,且中间任何一步失败都会导致元数据不一致。

  • 最容易被忽略的坑:改完 VSchema 后忘了调用 ApplyVSchema,VTGate 仍按旧规则路由
  • 如果原表有外键指向它,unsharded → sharded 会失败,因为 Vitess 不支持跨分片外键约束
  • sharded 改为 unsharded 时,所有分片上的数据必须先合并去重,否则 0 分片会写入冲突
  • 测试阶段务必用真实流量压测路由逻辑,光看 DDL 成功不代表查询不出错

VSchema 里表类型的划分不是语法装饰,它直接决定查询能否发出、怎么路由、是否允许 JOIN——稍有偏差,VTGate 就会拦截,而不是静默降级。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1006

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

334

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

379

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1782

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

376

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1332

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

436

2024.04.29

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

796

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
第二期_大前端线上班
第二期_大前端线上班

共345课时 | 51.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号