< 文档首页
全部产品
弹性计算
存储
数据库
安全
大数据
人工智能
网络与CDN
视频服务
容器与中间件
开发与运维
API与工具
物联网
物联网行业方案
专有云
企业应用与服务
数字金融
域名与网站
工商财税与知识产权
钉钉
移动研发平台EMAS-专有云
解决方案
会员服务
更多

    指定分库执行 SQL

    更新时间：2020-08-12 15:46:16

    ★ 我的收藏
    本页目录

    在使用PolarDB-X的过程中，如果遇到某个PolarDB-X不支持的 SQL 语句，可以通过PolarDB-X提供的NODE HINT，直接将 SQL 下发到一个或多个分库上去执行。此外如果需要单独查询某个分库或者已知分库的某个分表中的数据，也可以使用NODE HINT，直接将 SQL 语句下发到分库中执行。

    本文适用于PolarDB-X 5.3 及以上版本，其他版本请参见PolarDB-X 5.2指定分库执行SQL 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官方客户端命令。
    • 从版本 5.4.1 开始，PolarDB-X在拆分表的物理表名中增加了4个字符的随机串，请务必使用 SHOW TOPOLOGY 命令获取逻辑表拓扑和实际的物理表名。
    • 从版本 5.4.4 开始，PolarDB-X提供开关来控制拆分表的物理表名中是否包含随机串，默认为开启，可以在控制台“参数设置”的数据库级别参数中，将“是否启用随机物理表名 ENABLE_RANDOM_PHY_TABLE_NAME”改为 false 来关闭，也可以用 HINT 来实现语句级别的控制：/*+TDDL:cmd_extra(ENABLE_RANDOM_PHY_TABLE_NAME=FALSE)*/
    • 如果在目标表包含 Sequence 的 INSERT 语句上使用了指定分库的 HINT，那么 Sequence 将不生效。更多相关信息，请参见Sequence限制及注意事项。

    语法

    NODE HINT支持通过分片名指定 SQL 在分库上执行。其中分片名是PolarDB-X中分库的唯一标识，可以通过 SHOW NODE 语句得到。
    通过分库名指定 SQL 在分库上执行分两种使用方式，分别是指定 SQL 在某个分库上执行和指定 SQL 在多个分库上执行。

    • 指定 SQL 在某个分库上执行：
      1. /*+TDDL:node('node_name')*/
      node_name 为分片名，通过这个PolarDB-X自定义 HINT，就可以将 SQL 下发到node_name对应的分库中执行。
    • 指定 SQL 在多个分库上执行：
      1. /*+TDDL:node('node_name'[,'node_name1','node_name2'])*/
      在参数中指定多个分片名，将 SQL 下发到多个分库上执行，分片名之间使用逗号分隔。
      • 使用该自定义 HINT 时，PolarDB-X会将 SQL 直接下发到分库上执行，所以在 SQL 语句中，表名必须是该分库中已经存在的表名。
      • NODE HINT支持 DML、DDL、DAL 语句。

    示例

    对于名为 drds_test 的PolarDB-X数据库，SHOW NODE 的结果如下：

    1. mysql> SHOW NODE\G
    2. *************************** 1. row ******************
    3.                  ID: 0
    4.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS
    5.   MASTER_READ_COUNT: 212
    6.    SLAVE_READ_COUNT: 0
    7. MASTER_READ_PERCENT: 100%
    8.  SLAVE_READ_PERCENT: 0%
    9. *************************** 2. row ******************
    10.                  ID: 1
    11.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0001_RDS
    12.   MASTER_READ_COUNT: 29
    13.    SLAVE_READ_COUNT: 0
    14. MASTER_READ_PERCENT: 100%
    15.  SLAVE_READ_PERCENT: 0%
    16. *************************** 3. row ******************
    17.                  ID: 2
    18.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0002_RDS
    19.   MASTER_READ_COUNT: 29
    20.    SLAVE_READ_COUNT: 0
    21. MASTER_READ_PERCENT: 100%
    22.  SLAVE_READ_PERCENT: 0%
    23. *************************** 4. row ******************
    24.                  ID: 3
    25.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0003_RDS
    26.   MASTER_READ_COUNT: 29
    27.    SLAVE_READ_COUNT: 0
    28. MASTER_READ_PERCENT: 100%
    29.  SLAVE_READ_PERCENT: 0%
    30. *************************** 5. row ******************
    31.                  ID: 4
    32.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0004_RDS
    33.   MASTER_READ_COUNT: 29
    34.    SLAVE_READ_COUNT: 0
    35. MASTER_READ_PERCENT: 100%
    36.  SLAVE_READ_PERCENT: 0%
    37. *************************** 6. row ******************
    38.                  ID: 5
    39.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0005_RDS
    40.   MASTER_READ_COUNT: 29
    41.    SLAVE_READ_COUNT: 0
    42. MASTER_READ_PERCENT: 100%
    43.  SLAVE_READ_PERCENT: 0%
    44. *************************** 7. row ******************
    45.                  ID: 6
    46.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0006_RDS
    47.   MASTER_READ_COUNT: 29
    48.    SLAVE_READ_COUNT: 0
    49. MASTER_READ_PERCENT: 100%
    50.  SLAVE_READ_PERCENT: 0%
    51. *************************** 8. row ******************
    52.                  ID: 7
    53.                NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0007_RDS
    54.   MASTER_READ_COUNT: 29
    55.    SLAVE_READ_COUNT: 0
    56. MASTER_READ_PERCENT: 100%
    57.  SLAVE_READ_PERCENT: 0%
    58. 8 rows in set (0.02 sec)

    可以看到每个分库都有 NAME 这个属性，这就是分库的分片名。每个分片名都唯一对应一个分库名，比如DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0003_RDS这个分片名对应的分库名是drds_test_vtla_0003。得到了分片名，就可以使用PolarDB-X的自定义 HINT 指定分库执行 SQL 语句了。

    • 指定 SQL 在第 0 个分库上执行：

      1. SELECT /*TDDL:node('DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS')*/ * FROM table_name;

    • 指定 SQL 在多个分库上执行：

      1. SELECT /*TDDL:node('DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS','DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0006_RDS')*/ * FROM table_name;

      这条 SQL 语句将在DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS，DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0006_RDS这两个分片上执行。

    • 查看 SQL 在第 0 个分库上物理执行计划：

      1. /*TDDL:node('DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS')*/ EXPLAIN SELECT * FROM table_name;
    上一篇：扫描全部或部分分库分表
    下一篇：读写分离
    相关文档
    相关产品
    • PolarDB-X 云原生分布式数据库
      PolarDB-X（原DRDS升级版）是由阿里巴巴自主研发的云原生分布式数据库，融合分布式SQL引擎DRDS与分布式自研存储X-DB，基于云原生一体化架构设计，可支撑千万级并发规模及百PB级海量存储。专注解决海量数据存储、超高并发吞吐、大表瓶颈以及复杂计算效率等数据库瓶颈问题，历经各届天猫双十一及阿里云各行业客户业务的考验，助力企业加速完成业务数字化转型 。
    • 云数据库 RDS
      阿里云关系型数据库（Relational Database Service，简称RDS）是一种稳定可靠、可弹性伸缩的在线数据库服务。基于阿里云分布式文件系统和SSD盘高性能存储，RDS支持MySQL、SQL Server、PostgreSQL、PPAS（Postgre Plus Advanced Server，高度兼容Oracle数据库）和MariaDB引擎，并且提供了容灾、备份、恢复、监控、迁移等方面的全套解决方案，彻底解决数据库运维的烦恼。
    • PolarDB MySQL 云原生数据库
      POLARDB是阿里云自研的下一代关系型云数据库，兼容MySQL、PostgreSQL、Oracle引擎，存储容量最高可达100TB，单库最多可扩展到16个节点，适用于企业多样化的数据库应用场景。POLARDB采用存储和计算分离的架构，所有计算节点共享一份数据，提供分钟级的配置升降级、秒级的故障恢复、全局数据一致性和免费的数据备份容灾服务。POLARDB既融合了商业数据库稳定可靠、高性能、可扩展的特征，又具有开源云数据库简单开放、自我迭代的优势，例如POLARDB for MySQL性能最高可以提升至MySQL的6倍，而成本只有商用数据库的1/10。