tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
TDSQL-C MySQL 版
    文档
    Download PDF

    开启或关闭并行查询

    最后更新时间：2024-10-09 11:58:29
    下载PDF
      TDSQL-C MySQL 版支持并行查询能力，您可通过控制台或命令行调整相关参数，为实例开启或关闭并行查询功能。

      前提条件

      数据库版本：TDSQL-C MySQL 版 8.0 内核版本 3.1.8 及以上。
      使用 新增支持参数能力 需内核版本 TXSQL 8.0 3.1.15及以上。

      参数说明

      说明：
      读写实例与只读实例均支持开启并行查询功能，但实例 CPU 核数需大于等于4。
      您可通过控制台或命令行调整参数 txsql_max_parallel_worker_threads 和 txsql_parallel_degree 不为0，来开启当前实例的并行查询功能。参数的相关信息和具体设置建议如下。 参数信息
      参数
      变量类型
      作用域
      默认值
      取值范围
      说明
      txsql_max_parallel_worker_threads
      Integer
      Global
      0
      0 - 1024
      实例节点可用于并行查询的线程资源总数，设置为0则无并行线程可用，视为关闭并行查询功能。
      txsql_parallel_degree
      Integer
      Global/session
      0
      0 - 1024
      单条语句并行查询时可用的最大线程数（默认并行度）。设置为0时视为关闭并行查询功能。
      设置建议
      并行度规格限制：txsql_parallel_degree 参数的数值表明单条语句并行查询使用的最大线程数，即并行查询的默认并行度，建议并行度不要超过实例 CPU 核数的二分之一。为保证稳定性，CPU 核数小于4的小规格集群将禁用并行查询功能，您将无法在控制台或使用命令行调整并行查询相关参数。
      SQL 语句在执行并行查询时将默认使用 txsql_parallel_degree 所设置的并行度，但用户可通过 hint 语句调整单条 SQL 语句的并行查询并行度，详细说明请参见 hint 语句控制。
      txsql_max_parallel_worker_threads 参数的值表明并行查询中实例可用于并行查询的线程数，txsql_max_parallel_worker_threads / txsql_parallel_degree 的值表明最多同时有多少条 SQL 语句可以执行并行查询。
      txsql_max_parallel_worker_threads 与 txsql_parallel_degree 共同控制并行查询功能的开启与关闭，当任意一个参数设置为0时，表示关闭并行查询功能。
      TDSQL-C MySQL 版也提供了多种参数对并行查询的执行条件进行设置，方便您对业务进行个性化适配，保证业务稳定运行。设置后，TDSQL-C MySQL 版将会对语句的执行代价，表的行数，单条语句执行并行计划时所使用的内存等条件进行判断，确认每一条 SQL 语句是否允许执行并行查询。相关参数说明如下：
      参数
      变量类型
      作用域
      默认值
      取值范围
      说明
      txsql_parallel_cost_threshold
      Numeric
      Global/Session
      50000
      0 - 9223372036854775807
      并行执行代价阈值，只有执行代价高于阈值的语句才会进行并行查询。
      txsql_parallel_table_record_threshold
      Integer
      Global/Session
      5000
      0 - 9223372036854775807
      并行表行数阈值，只有行数高于阈值的表才能被选为并行表。
      txsql_optimizer_context_max_mem_size
      Integer
      Global
      8388608
      0 - 9223372036854775807
      单条语句可申请的并行查询计划环境最大内存限制。
      txsql_parallel_execution_max_lob_size
      Integer
      Global /Session
      65536
      128 - 9223372036854775807
      单个溢出字段的内存限制。
      注意：
      并行查询等所有参数均无需重启实例，设置后即时生效。
      标有 session 作用域的参数表明该参数支持对单条语句进行设置。

      通过控制台开启或关闭并行查询

      您可通过 TDSQL-C MySQL 版控制台进入集群参数设置页面通过设置相关参数开启或关闭功能。
      设置 txsql_max_parallel_worker_threads 和 txsql_parallel_degree 不为0表示开启并行查询能力。
      设置 txsql_max_parallel_worker_threads 和 txsql_parallel_degree 任意一个为0表示关闭并行查询能力。
      也可设置相关执行条件参数。控制台参数设置页面如下图所示。详细操作方法请参考 设置实例参数。
      

      通过 hint 语句对单条 SQL 语句指定并行执行方式

      TDSQL-C MySQL 版支持对单条 SQL 语句进行指定并行执行方式。对单条 SQL 语句进行设置时，将采用 hint 语句的方式进行操作，详细方法请参照 hint 语句控制。

      附录：新增参数说明

      参数
      变量类型
      作用域
      默认值
      取值范围
      说明
      txsql_parallel_partition_verbose
      Boolean
      Global Session
      OFF
      ON/OFF
      启用时 EXPLAIN ANALYZE 打印更详细的分区信息。
      txsql_parallel_limit_enabled
      Boolean
      Global Session
      ON
      ON/OFF
      启用时支持带 LIMIT 限定的有序数据流（无需额外排序）并行。
      txsql_parallel_rollup_pushdown_threshold
      Integer
      Global Session
      4
      0-100
      ROLL UP 下推算法的启用阈值。当 GROUP BY 字段数量大于此阈值时并行计算。
      txsql_parallel_force_scan_enabled
      Boolean
      Global Session
      OFF
      ON/OFF
      全表扫描或全索引扫描查询并行开关。启用时这两类查询才能并行。
      txsql_parallel_force_range_enabled
      Boolean
      Global Session
      ON
      ON/OFF
      索引范围扫描（RANGE/REF）并行开关。启用时这两类查询才能并行。
      txsql_parallel_subselect_cost_threshold
      Numeric
      Global Session
      50000
      0-DBL_MAX
      并行执行代价阈值。只有估计执行代价高于阈值的子查询和 derived table 才能并行执行。
      txsql_parallel_partition_threshold
      Integer
      Global Session
      10000
      0-ULONG_MAX
      Nested Loop Join 并行内表 NDV 阈值。只有连接字段唯一值数量高于该阈值的表才能作为并行表。
      txsql_parallel_force_probe_enabled
      Boolean
      Global Session
      OFF
      ON/OFF
      Hash Join 的 probe 表并行阈值。当 hash table 大于 join buffer size 时考虑 probe 表并行。
      txsql_parallel_derived_enabled
      Boolean
      Global Session
      ON
      ON/OFF
      启用时支持 derived table 单独并行。

      相关文档

      查看并行查询
      并行查询指标
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款