PolarDB-X 1.0-用户指南-自定义HINT-扫描全部或部分分库分表

本文涉及的产品
云原生数据库 PolarDB 分布式版,标准版 2核8GB
简介: 除了可以将SQL单独下发到一个或多个分库执行,POlarDB-X还提供了扫描全部/部分分库与分表的SCAN HINT。使用SCAN HINT,您可以一次将SQL下发到每一个分库执行, 比如查看某个分库上的所有分表,或者查看某个逻辑表的每张物理表中的数据量等。

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

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

  • 在所有分库的所有分表上执行。
  • 在指定分库的所有分表上执行。
  • 在指定分库分表上执行,根据条件计算物理表名称。
  • 在指定分库分表上执行,显式指定物理表名。

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

本文适用于PolarDB-X 5.3及以上版本,其他版本请参见PolarDB-X 5.2扫描全部分库分表 HINT文档

注意事项

  • 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

从5.4.1版本开始,POlarDB-X在拆分表的物理表名中增加了4个字符的随机串,请务必使用SHOW TOPOLOGY命令获取逻辑表拓扑和实际的物理表名。

示例

  • 在所有分库的所有分表上执行
  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"
  • 执行后会首先计算出逻辑表t1t2满足condition条件的所有物理表,然后下发SQL语句并将结果集合并后返回。

使用该自定义注释需要保证两张表的分库和分表数量一致,否则POlarDB-X计算出的两个键值对应的分库不一致,就会报错。

  • 在指定分库分表上执行,显式指定物理表名
  1. SELECT /*+TDDL:scan('t1', real_table=("t1_00", "t1_01"))*/ COUNT(1) FROM t1
  • 执行后会下发SQL语句到所有分库的t1_00t1_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_00t2_00t1_01t2_01分表上,合并结果集后返回。
相关实践学习
跟我学:如何一键安装部署 PolarDB-X
《PolarDB-X 动手实践》系列第一期,体验如何一键安装部署 PolarDB-X。
相关文章
|
SQL 机器学习/深度学习 运维
【笔记】用户指南—备份与恢复—将PolarDB-X与其他阿里云服务集成
阿里云提供众多与数据相关的产品和服务,PolarDB-X作为一款云原生分布式数据库产品,同时也是阿里云生态的重要组成部分。PolarDB-X通过打通与其他云产品的连接,提供了更加原生的生态互通能力,为更多的业务场景提供了便利。
103 0
|
SQL 机器学习/深度学习 运维
【笔记】用户指南—备份与恢复—将PolarDB-X与其他阿里云服务集成
阿里云提供众多与数据相关的产品和服务,PolarDB-X作为一款云原生分布式数据库产品,同时也是阿里云生态的重要组成部分。PolarDB-X通过打通与其他云产品的连接,提供了更加原生的生态互通能力,为更多的业务场景提供了便利。
|
SQL 机器学习/深度学习 运维
【笔记】用户指南—备份与恢复—将PolarDB-X与其他阿里云服务集成
阿里云提供众多与数据相关的产品和服务,PolarDB-X作为一款云原生分布式数据库产品,同时也是阿里云生态的重要组成部分。PolarDB-X通过打通与其他云产品的连接,提供了更加原生的生态互通能力,为更多的业务场景提供了便利。
|
SQL 机器学习/深度学习 运维
用户指南—备份与恢复—将PolarDB-X与其他阿里云服务集成
阿里云提供众多与数据相关的产品和服务,PolarDB-X作为一款云原生分布式数据库产品,同时也是阿里云生态的重要组成部分。PolarDB-X通过打通与其他云产品的连接,提供了更加原生的生态互通能力,为更多的业务场景提供了便利。
105 0
|
SQL 机器学习/深度学习 运维
用户指南—备份与恢复—将PolarDB-X与其他阿里云服务集成
阿里云提供众多与数据相关的产品和服务,PolarDB-X作为一款云原生分布式数据库产品,同时也是阿里云生态的重要组成部分。PolarDB-X通过打通与其他云产品的连接,提供了更加原生的生态互通能力,为更多的业务场景提供了便利。
|
存储 SQL 关系型数据库
PolarDB-X 1.0-用户指南-实例管理-实例介绍
实例介绍 PolarDB-X 1.0由计算层与存储层资源构成,计算层在物理资源上由多个计算节点所组成的分布式集群,业务数据存储在下挂的多个私有定制RDS实例中。目前售卖的PolarDB-X 1.0计算资源实例皆为专享实例,其中包括主实例和只读实例。
126 0
PolarDB-X 1.0-用户指南-实例管理-实例介绍
|
存储 Cloud Native 关系型数据库
PolarDB-X 1.0-用户指南-实例管理-创建实例
本文将介绍如何创建PolarDB-X 1.0计算资源DRDS实例。
150 0
|
12天前
|
SQL 运维 关系型数据库
PolarDB产品使用合集之PolarDB 2.3.0 版本的 CDC 功能支持 Polardb-X 到 Polardb-X 的数据同步吗
PolarDB产品使用合集涵盖了从创建与管理、数据管理、性能优化与诊断、安全与合规到生态与集成、运维与支持等全方位的功能和服务,旨在帮助企业轻松构建高可用、高性能且易于管理的数据库环境,满足不同业务场景的需求。用户可以通过阿里云控制台、API、SDK等方式便捷地使用这些功能,实现数据库的高效运维与持续优化。
|
8月前
|
SQL Oracle 关系型数据库
Polar DB-O (兼容 Oracle 语法版本)和Polar DB PostgreSQL 版本概述(二)
Polar DB-O (兼容 Oracle 语法版本)和Polar DB PostgreSQL 版本概述(二)
845 0
|
存储 SQL 安全
PolarDB-X内核新版本:将MySQL进行到底
在PolarDB-X最新的内核版本5.4.15中,提供诸多新功能:存储过程,读写分离优化,表级分区管理,密码、审计优化等。
429 0
PolarDB-X内核新版本:将MySQL进行到底

热门文章

最新文章

相关产品

  • 云原生分布式数据库 PolarDB-X