开发者社区> -技术小助手-> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

PolarDB-X 1.0-SQL 手册-Hint-扫描全部/部分分库分表

简介: 本文适用于PolarDB-X 5.3 及以上版本,其他版本请参见PolarDB-X 5.2 HINT。
+关注继续查看

本文适用于PolarDB-X 5.3 及以上版本,其他版本请参见PolarDB-X 5.2 HINT

除了可以将 SQL 单独下发到一个或多个分库执行,PolarDB-X 还提供了扫描全部/部分分库与分表的SCAN HINT。使用SCAN HINT,您可以一次将 SQL 下发到每一个分库执行, 比如查看某个分库上的所有分表,或者查看某个逻辑表的每张物理表中的数据量等。

通过 SCAN HINT,可以指定四种执行SQL的方式:

  1. 在所有分库的所有分表上执行
  2. 在指定分库的所有分表上执行
  3. 在指定分库分表上执行,根据条件计算物理表名称
  4. 在指定分库分表上执行,显式指定物理表名

SCAN HINT 支持 DML、DDL 和部分 DAL 语句。

注意:

  • PolarDB-X 自定义 HINT 支持 /*+TDDL:hint_command*//!+TDDL:hint_command*/ 两种格式。
  • 如果使用 /*+TDDL:hint_command*/ 格式,在使用 MySQL 官方命令行客户端执行带有 PolarDB-X 自定义 HINT 的 SQL 时,请在登录命令中加上 -c 参数。否则,由于 PolarDB-X 自定义 HINT 是以 MySQL 注释 形式使用的,该客户端会将注释语句删除后再发送到服务端执行,导致 PolarDB-X 自定义 HINT 失效。具体请参见MySQL 官方客户端命令

语法


  1. # SCAN HINT

  2. # 将 SQL 语句下发到所有分库的所有分表上执行
  3. SCAN()

  4. # 将 SQL 语句下发到指定分库的所有分表上执行
  5. SCAN(NODE="node_list") # 指定分库

  6. # 将 SQL 语句下发到指定分库分表上执行,根据条件计算物理表名称
  7. SCAN(
  8. [TABLE=]"table_name_list" # 逻辑表名
  9. , CONDITION="condition_string" # 使用 TABLE 和 CONDITION 中的内容计算物理库表名称
  10. [, NODE="node_list"] ) # 过滤通过 CONDITION 计算出的结果,仅保留指定物理库

  11. # 将 SQL 语句下发到指定分库分表上执行,显式指定物理表名
  12. SCAN(
  13. [TABLE=]"table_name_list" # 逻辑表名
  14. , REAL_TABLE=("table_name_list") # 物理表名,对所有物理库使用相同的物理表名
  15. [, NODE="node_list"] ) # 过滤通过 CONDITION 计算出的结果,仅保留指定物理库


  16. # 物理/逻辑表名列表
  17. table_name_list:
  18. table_name [, table_name]...

  19. # 物理库列表,支持 GROUP_KEY 和 GROUP 的序号, 可以通过 `SHOW NODE` 语句获得
  20. node_list:
  21. {group_key | group_index} [, {group_key | group_index}]...

  22. # 支持 SQL WHERE 的语法,需要为每一张表设置条件,如:t1.id = 2 and t2.id = 2
  23. condition_string:
  24. where_condition

示例

  • 在所有分库的所有分表上执行
    1. SELECT /*+TDDL:scan()*/ COUNT(1) FROM t1
  • 执行后会下发 SQL 语句到t1的所有物理表上执行,并将结果集合并后返回
  • 在指定分库的所有分表上执行
    1. SELECT /*+TDDL:scan(node='0,1,2')*/ COUNT(1) FROM t1
  • 执行后会首先计算出t1在 0000, 0001, 0002 分库上的所有物理表,然后下发 SQL 语句并将结果集合并后返回。
  • 按条件在指定分表上执行
    1. SELECT /*+TDDL:scan('t1', condition='t1.id = 2')*/ COUNT(1) FROM t1
  • 执行后会首先计算出逻辑表t1满足 condition 条件的所有物理表,然后下发 SQL 语句并将结果集合并后返回。
  • 按条件在指定分表上执行,有 JOIN 的情况
    1. SELECT /*+TDDL:scan('t1, t2', condition='t1.id = 2 and t2.id = 2')*/ * FROM t1 a JOIN t2 b ON a.id = b.id WHERE b.name = "test"
  • 执行后会首先计算出逻辑表t1 t2满足 condition 条件的所有物理表,然后下发 SQL 语句并将结果集合并后返回。注意:使用该自定义注释需要保证两张表的分库和分表数量一致,否则 PolarDB-X 计算出的两个键值对应的分库不一致,就会报错。
  • 在指定分库分表上执行,显式指定物理表名
    1. SELECT /*+TDDL:scan('t1', real_table=("t1_00", "t1_01"))*/ COUNT(1) FROM t1
  • 执行后会下发 SQL 语句到所有分库的t1_00``t1_01分表上,合并结果集后返回。
  • 在指定分库分表上执行,显式指定物理表名, 有 JOIN 的情况
    1. SELECT /*+TDDL:scan('t1, t2', real_table=("t1_00,t2_00", "t1_01,t2_01"))*/ * FROM t1 a JOIN t2 b ON a.id = b.id WHERE b.name = "test";
  • 执行后会下发 SQL 语句到所有分库的t1_00 t2_00 t1_01 t2_01分表上,合并结果集后返回。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
PolarDB-X 1.0-SQL 手册--SQL使用限制
PolarDB-X高度兼容MySQL协议和语法,但由于分布式数据库和单机数据库存在较大的架构差异,存在SQL使用限制。本文将介绍相关SQL的使用限制。
101 0
PolarDB-X 1.0-SQL 手册-DDL任务管理-常见场景与限制
新DDL执行引擎引入任务管理,外部行为与之前版本相比有所变化。本文将介绍相关的常见场景与限制。
89 0
PolarDB-X 1.0-SQL 手册-函数-窗口函数
传统的Group By函数会按照分组后的查询结果进行聚合计算,且每个分组只输出一条数据。但与传统的Group By函数不同,窗口函数(也称OLAP函数)可以为每个分组返回多个值,且不会影响记录的数量。本文介绍如何使用窗口函数。
71 0
PolarDB-X 1.0-SQL 手册-函数-函数
DRDS 支持的函数分为日期时间函数、字符串函数、转换函数、聚合函数、数学函数、比较函数、位函数、控制流程函数、信息函数、加密和压缩函数以及其他函数;JSON 函数和地理信息函数的下推执行。
47 0
Spring Boot 2.X(十一):全局异常处理
前言 在 Java Web 系统开发中,不管是 Controller 层、Service 层还是 Dao 层,都有可能抛出异常。如果在每个方法中加上各种 try catch 的异常处理代码,那样会使代码非常繁琐。
808 0
Springboot 2.0.x 集成基于Centos7的Redis集群安装及配置
Springboot 2.0.x 集成基于Centos7的Redis集群安装及配置 Redis简介 Redis是一个基于C语言开发的开源(BSD许可),开源高性能的高级内存数据结构存储,用作数据库、缓存和消息代理。
4581 0
spring boot2.0实现对quartz的集成
最近项目中需要集成quartz这个定时任务,记录集成方法如下: pom.xml的相关引入 org.springframework.
1454 0
1631
文章
0
问答
来源圈子
更多
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载