后浪云OceanBase教程：OceanBase 与并行执行相关的 Hint

PARALLEL Hint

​PARALLEL​ Hint 是语句级的 Hint，用来指示优化器指定并行操作可使用的并行线程的数量。此 Hint 将覆盖初始化参数 ​PARALLEL_DEGREE_ POLICY​ 的值。该 Hint 适用于语句的 ​SELECT​、​INSERT​、​MERGE​、​UPDATE​ 和 ​DELETE​ 部分，以及表扫描的部分。如果违反了任何的并行限制，则 ​PARALLEL​ Hint 被忽略。

以下是 ​PARALLEL​ Hint 的语法：

/*+ PARALLEL(integer) */

注意 
如果还进行了排序或分组操作，那么可以使用的线程数量是 ​
PARALLEL​ Hint 中的值的两倍。

​PARALLE ​Hint 中参数 integer 的值用来指定并行度。

以下示例中，指定数据库的并行度为 5：

SELECT /*+ PARALLEL(5) */ last_name
  FROM employees;

USE_PX Hint

​USE_PX​ Hint 强制指示服务器在执行 SQL 语句时使用 PX 模式，PX 模式允许在执行语句时采用多线程方式。一般 ​USE_PX​ Hint 和 ​PARALLEL​ Hint 配合使用。

以下是 ​USE_PX​ Hint 的语法：

/*+ USE_PX  */

示例如下：

SELECT /*+ USE_PX PARALLEL(4)*/ e.department_id, sum(e.salary)
 FROM employees e
 WHERE e.department_id = 1001;
 GROUP BY e.department_id;

NO_USE_PX Hint

​NO_USE_PX​ Hint 强制指示服务器在执行 SQL 语句时避免使用 PX 模式。

以下是 ​NO_USE_PX​ Hint 的语法：

/*+ NO_USE_PX  */

示例如下：

SELECT /*+ NO_USE_PX*/ e.department_id, sum(e.salary)
 FROM employees e
 WHERE e.department_id = 1001;
 GROUP BY e.department_id;

PQ_DISTRIBUTE Hint

​PQ_DISTRIBUTE​ Hint 指示优化器怎样在程序（查询）服务器和消耗（负载）查询服务器之间分配行。您可以通过该 Hint 控制联接或负载的行分布​PQ_DISTRIBUTE​ Hint 的语法：

/*+ PQ_DISTRIBUTE
  ( [ @ queryblock ] tablespec 
    { distribution | outer_distribution inner_distribution }
  ) */

控制负载的分配

您可以控制并行语句 ​INSERT ... SELECT​ 和并行语句 ​CREATE TABLE ... AS SELECT​ 的行分布，以此来确定如何在程序（查询）服务器和消耗（负载）服务器之间进行行分配。使用语法的上分支来指定分发方法。分布方法的值及其语义如下表所示：

例如，在以下直接装入插入操作中，该操作的查询和负载部分被组合到每个查询服务器中：

INSERT /*+ APPEND PARALLEL(target_table, 16) PQ_DISTRIBUTE(target_table, NONE) */
  INTO target_table
  SELECT * FROM source_table;

在下面的示例中，创建表时优化器使用表 target_table 的分区来分配行：

CREATE /*+ PQ_DISTRIBUTE(target_table, PARTITION) */ TABLE target_table
  NOLOGGING PARALLEL 16
  PARTITION BY HASH (l_orderkey) PARTITIONS 512
  AS SELECT * FROM source_table;

控制联接的分配

您可以通过指定两种分配方法来控制联接的分配方法，如语法中的下部分支所示，一种外部表的分布方法，一种内部表的分布方法：

• ​outside_distribution​ 是外部表的分布方法。
• ​inner_distribution​ 是内部表的分布方法。

分布方法的值是 ​HASH​、​BROADCAST​、​PARTITION​ 和 ​NONE​。只有下表中的 6 种分布方法组合是有效的：

例如，给定两个使用哈希联接来联接表 r 和 s，以下查询包含使用哈希分配的 Hint：

SELECT /*+ORDERED PQ_DISTRIBUTE(s HASH, HASH) USE_HASH (s)*/ column_list
  FROM r,s
  WHERE r.c=s.c;

要广播外部表 r，查询语句为：

SELECT /*+ORDERED PQ_DISTRIBUTE(s BROADCAST, NONE) USE_HASH (s) */ column_list
  FROM r,s
  WHERE r.c=s.c;