Config和Hint配置参数

类别

参数

描述

示例

文档链接

新旧集群的切换时间

REPLICATION_SWITCH_TIME_RANGE

新旧集群切换期间，旧集群会有5～10分钟的时间仅支持只读操作。您可以在连接旧集群后，配置REPLICATION_SWITCH_TIME_RANGE来指定切换新旧集群的时间窗口。

SET ADB_CONFIG REPLICATION_SWITCH_TIME_RANGE=`23:00, 23:30`;

数仓版扩缩容

IN条件数限制

MAX_IN_ITEMS_COUNT

设置IN条件的个数限制。取值范围为大于0的正整数。

• 内核版本3.1.8及以下的集群，默认值均为2000。

• 内核版本3.1.9.x ~ 3.1.10.x的集群，默认值是4000。

• 内核版本3.2.1及以上的集群，默认值为20000。

SET ADB_CONFIG MAX_IN_ITEMS_COUNT=4000;

写入与查询

查询超时时间

QUERY_TIMEOUT

集群级别为所有查询配置查询的超时时间。取值范围为大于0的整数。单位：毫秒（ms）。

SET ADB_CONFIG QUERY_TIMEOUT=1000;

INSERT、UPDATE、DELETE超时时间

INSERT_SELECT_TIMEOUT

集群级别修改INSERT、UPDATE和DELETE语句的最大执行时间。默认值：24*3600000，取值范围为大于0的整数。单位：毫秒（ms）。

SET ADB_CONFIG INSERT_SELECT_TIMEOUT=3600000;

使用限制

过滤条件不下推

• 内核版本为3.1.4及以上：FILTER_NOT_PUSHDOWN_COLUMNS

• 内核版本为3.1.4以下：NO_INDEX_COLUMNS

集群级别关闭特定字段的过滤条件下推能力。

• 内核版本为3.1.4及以上：SET ADB_CONFIG FILTER_NOT_PUSHDOWN_COLUMNS=[Schema1.tableName1:colName1|colName2;Schema2.tableName2:colName1|colName2]

• 内核版本为3.1.4以下：SET ADB_CONFIG NO_INDEX_COLUMNS=[tableName1.colName1;colName2,tableName2.colName1]

过滤条件不下推

查询执行模式

QUERY_TYPE

切换实例的查询执行模式，取值：

• interactive

• batch

SET ADB_CONFIG QUERY_TYPE=interactive;

查询执行模式

查询队列

XIHE_ENV_QUERY_ETL_MAX_CONCURRENT_SIZE

单个前端节点LOWEST队列的最大可运行查询数，默认值为20。

SET ADB_CONFIG XIHE_ENV_QUERY_ETL_MAX_CONCURRENT_SIZE=20;

Interactive型资源组的优先级队列与并发

XIHE_ENV_QUERY_ETL_MAX_QUEUED_SIZE

单个前端节点LOWEST队列的最大可排队查询数，默认值为200。

SET ADB_CONFIG XIHE_ENV_QUERY_ETL_MAX_QUEUED_SIZE=200;

XIHE_ENV_QUERY_LOW_PRIORITY_MAX_CONCURRENT_SIZE

单个前端节点LOW队列的最大可运行查询数，默认值为20。

SET ADB_CONFIG XIHE_ENV_QUERY_LOW_PRIORITY_MAX_CONCURRENT_SIZE=20;

XIHE_ENV_QUERY_LOW_PRIORITY_MAX_QUEUED_SIZE

单个前端节点LOW队列的最大可排队查询数，默认值为200。

SET ADB_CONFIG XIHE_ENV_QUERY_LOW_PRIORITY_MAX_QUEUED_SIZE=200;

XIHE_ENV_QUERY_NORMAL_MAX_CONCURRENT_SIZE

单个前端节点NORMAL队列的最大可运行查询数，默认值为20。

SET ADB_CONFIG XIHE_ENV_QUERY_NORMAL_MAX_CONCURRENT_SIZE=20;

XIHE_ENV_QUERY_NORMAL_MAX_QUEUED_SIZE

单个前端节点NORMAL队列的最大可排队查询数，默认值为200。

SET ADB_CONFIG XIHE_ENV_QUERY_NORMAL_MAX_QUEUED_SIZE=200;

XIHE_ENV_QUERY_HIGH_MAX_CONCURRENT_SIZE

单个前端节点HIGH队列的最大可运行查询数，默认值为40。

SET ADB_CONFIG XIHE_ENV_QUERY_HIGH_MAX_CONCURRENT_SIZE=40;

XIHE_ENV_QUERY_HIGH_MAX_QUEUED_SIZE

单个前端节点HIGH队列的最大可排队查询数，默认值为400。

SET ADB_CONFIG XIHE_ENV_QUERY_HIGH_MAX_QUEUED_SIZE=400;

XIHE BSP作业优先级

QUERY_PRIORITY

BSP作业的优先级。取值：

• HIGH

• NORMAL（ 默认值）

• LOW

• LOWEST

SET ADB_CONFIG QUERY_PRIORITY=HIGH;

配置项列表

XIHE BSP作业使用的最大ACU数

ELASTIC_JOB_MAX_ACU

单个XIHE BSP作业所使用的最大ACU数。默认值是9，最小值为3，取值范围

为[3,Job型资源组最大资源量]。

SET ADB_CONFIG ELASTIC_JOB_MAX_ACU=20;

XIHE BSP作业查询超时时间

BATCH_QUERY_TIMEOUT

XIHE BSP作业的超时时间。默认值是7200000 ms，取值范围为大于0的整数。单位：毫秒（ms）。

SET ADB_CONFIG BATCH_QUERY_TIMEOUT=3600000 ;

OSS外表导入

HIVE_SPLIT_ASYNC_GENERATION_ENABLED

Hive生成执行计划时，是否将Hive Split任务异步提交到队列中执行。取值：

• true：是。

• false（默认值）：否。

SET ADB_CONFIG HIVE_SPLIT_ASYNC_GENERATION_ENABLED=true;

无

MaxCompute外表导入

SQL_OUTPUT_BATCH_SIZE

批量导入数据时的数据条数。取值范围为大于0的整数。

SET ADB_CONFIG SQL_OUTPUT_BATCH_SIZE = 6000;

导入与导出

ENABLE_ODPS_MULTI_PARTITION_PART_MATCH

是否预先遍历获取每个MaxCompute分区的记录数。

SET ADB_CONFIG ENABLE_ODPS_MULTI_PARTITION_PART_MATCH=false;

ASYNC_GET_SPLIT

MaxCompute生成执行计划时，是否通过优化Split加载性能，将任务异步提交到队列中执行。取值：

• true：是。

• false（默认值）：否。

SET ADB_CONFIG ASYNC_GET_SPLIT=true;

BUILD自动调度时间

RC_CSTORE_BUILD_SCHEDULE_PERIOD

限制BUILD任务调度时间段，不限任务执行时间段。取值为0~24之间的整数。

SET ADB_CONFIG RC_CSTORE_BUILD_SCHEDULE_PERIOD=`6,8`;

配置BUILD自动调度时间

BUILD调度优先级

ADB_CONFIG RC_BUILD_TASK_PRIORITY_LIST

支持对单表或多表配置BUILD调度的优先级，且优先级一直生效，直至再次配置该表优先级时，才会改变。

BUILD调度的优先级由参数task_priority控制，取值为整数，默认值为0。

SET ADB_CONFIG RC_BUILD_TASK_PRIORITY_LIST = `<db1_name>.<table1_name>.<task_priority>;<db2_name>.<table2_name>.<task_priority>`;

BUILD

弹性导入

RC_ELASTIC_JOB_SCHEDULER_ENABLE

弹性导入数据时需手动打开弹性导入开关。

SET ADB_CONFIG RC_ELASTIC_JOB_SCHEDULER_ENABLE=true;

• 通过外表弹性导入OSS数据

• 通过外表弹性导入MaxCompute数据

REMOTE_CALL函数

XIHE_REMOTE_CALL_SERVER_ENDPOINT

通过REMOTE_CALL函数远程调用函数计算服务中自定义的函数时，函数计算服务的内网服务接入地址。详细信息，请参见服务接入地址。

SET ADB_CONFIG XIHE_REMOTE_CALL_SERVER_ENDPOINT="1234567890000****.cn-zhangjiakou-internal.fc.aliyuncs.com"

自定义函数UDF

XIHE_REMOTE_CALL_SERVER_AK

通过REMOTE_CALL函数远程调用函数计算服务中自定义的函数时，函数计算服务所属阿里云账号或者RAM用户的AccessKey ID。

SET ADB_CONFIG XIHE_REMOTE_CALL_SERVER_AK=************;

XIHE_REMOTE_CALL_SERVER_SK

通过REMOTE_CALL函数远程调用函数计算服务中自定义的函数时，函数计算服务所属阿里云账号或者RAM用户的AccessKey Secret。

SET ADB_CONFIG XIHE_REMOTE_CALL_SERVER_SK=************;

XIHE_REMOTE_CALL_COMPRESS_ENABLED

通过REMOTE_CALL函数远程调用函数计算服务中自定义的函数时，是否使用GZIP格式压缩数据再传输至函数计算服务。

SET ADB_CONFIG REMOTE_CALL_COMPRESS_ENABLED=true;

XIHE_REMOTE_CALL_MAX_BATCH_SIZE

通过REMOTE_CALL函数远程调用函数计算服务中自定义的函数时，向函数计算服务发送的数据行数。

SET ADB_CONFIG XIHE_REMOTE_CALL_MAX_BATCH_SIZE=500000;

扫描并发控制

ADB_CONFIG SPLIT_FLOW_CONTROL_ENABLED

AnalyticDB for MySQL支持配置扫描并发额度，避免因查询的扫描并发过大、占用过多资源，导致节点不稳定的情况。取值如下：

• true（默认值）：开启扫描并发控制功能。

• false：关闭扫描并发控制功能。

SET ADB_CONFIG SPLIT_FLOW_CONTROL_ENABLED=true;

扫描并发控制

ADB_CONFIG NODE_LEVEL_SPLIT_FLOW_CONTROL_ENABLED

AnalyticDB for MySQL支持根据节点整体的扫描并发额度，动态调整Task的扫描并发额度。取值如下：

• true：开启动态调整Task扫描并发控制功能。

• false（默认值）：关闭动态调整Task扫描并发控制功能。

SET ADB_CONFIG NODE_LEVEL_SPLIT_FLOW_CONTROL_ENABLED=true;

MIN_RUNNING_SPLITS_LIMIT_PER_TASK

Task扫描并发额度的最小值。默认值为1，取值范围为[1,TARGET_RUNNING_SPLITS_LIMIT_PER_TASK]。

SET ADB_CONFIG MIN_RUNNING_SPLITS_LIMIT_PER_TASK=24;

TARGET_RUNNING_SPLITS_LIMIT_PER_TASK

Task扫描并发额度的中间值，基于该值增加或降低扫描并发额度。默认值为32，取值范围为[MIN_RUNNING_SPLITS_LIMIT_PER_TASK,MAX_RUNNING_SPLITS_LIMIT_PER_TASK]。

TARGET_RUNNING_SPLITS_LIMIT_PER_TASK=32;

MAX_RUNNING_SPLITS_LIMIT_PER_TASK

Task扫描并发额度的最大值。默认值为64，取值范围大于TARGET_RUNNING_SPLITS_LIMIT_PER_TASK值。

SET ADB_CONFIG MAX_RUNNING_SPLITS_LIMIT_PER_TASK=128;

ADB_CONFIG WORKER_MAX_RUNNING_SOURCE_SPLITS_PER_NODE

存储节点的扫描并发额度默认为256，扫描并发额度过大或过小都会影响集群性能，建议您不要修改默认值。

SET ADB_CONFIG WORKER_MAX_RUNNING_SOURCE_SPLITS_PER_NODE=256;

ADB_CONFIG EXECUTOR_MAX_RUNNING_SOURCE_SPLITS_PER_NODE

计算节点的扫描并发额度默认为256，扫描并发额度过大或过小都会影响集群性能，建议您不要修改默认值。

SET ADB_CONFIG EXECUTOR_MAX_RUNNING_SOURCE_SPLITS_PER_NODE=256;

逻辑视图大小写敏感

VIEW_OUTPUT_NAME_CASE_SENSITIVE

设置逻辑视图大小写敏感。取值如下：

• true：大小写敏感。

• false（默认值）：大小写不敏感。

SET ADB_CONFIG VIEW_OUTPUT_NAME_CASE_SENSITIVE=true;

CREATE VIEW

连续执行多个SQL语句

ALLOW_MULTI_QUERIES

使用Multi-Statement功能连续执行多个SQL语句时，手动开启Multi-Statement功能。取值如下：

• true：开启。

• false（默认值）：关闭。

SET ADB_CONFIG ALLOW_MULTI_QUERIES=true;

Multi-Statement

开启Binlog

BINLOG_ENABLE

• 内核版本3.2.0.0之前的集群，需先手动开启Binlog特性，才能为表开启Binlog功能。

• 内核版本3.2.0.0及之后的集群，默认已开启Binlog特性，无需配置该参数。

SET ADB_CONFIG BINLOG_ENABLE=true;

刷新物化视图

Paging Cache（深分页性能优化）

PAGING_CACHE_SCHEMA

指定存储分页查询临时缓存表的数据库。若未指定，则使用当前连接的内部数据库。

SET ADB_CONFIG PAGING_CACHE_SCHEMA=paging_cache;

Paging Cache（深分页性能优化）

PAGING_CACHE_MAX_TABLE_COUNT

设置临时缓存表的最大个数限制。超过此数量时创建新的缓存将失败。默认值：100，取值范围为大于0的整数。

SET ADB_CONFIG PAGING_CACHE_MAX_TABLE_COUNT=100;

PAGING_CACHE_EXPIRATION_TIME

指定缓存的过期时间阈值，自动清理指定时间内未访问的分页查询缓存。默认值：600，取值范围为大于0的整数，单位：秒（s）。

SET ADB_CONFIG PAGING_CACHE_EXPIRATION_TIME=600;

PAGING_CACHE_ENABLE

指定是否全局关闭Paging Cache功能。取值如下：

• true（默认值）：开启。

• false：关闭。

SET ADB_CONFIG PAGING_CACHE_ENABLE=false;

指定表引擎

RC_DDL_ENGINE_REWRITE_XUANWUV2

在集群全局指定表引擎。取值：

• true（默认值）：存量表的表引擎不变，新建表的表引擎默认为XUANWU_V2。即使在新建表时显式指定ENGINE=XUANWU，也会自动将其改写为XUANWU_V2。

• false：存量表的表引擎不变，新建表的表引擎默认均为XUANWU。

SET ADB_CONFIG RC_DDL_ENGINE_REWRITE_XUANWUV2=true;

指定表引擎

类别

参数

描述

示例

文档链接

查询超时时间

QUERY_TIMEOUT

查询级别为单次查询配置查询的超时时间。取值范围为大于0的整数，单位：毫秒（ms）。

/*+ QUERY_TIMEOUT=1000 */select count(*) from t;

写入与查询

INSERT、UPDATE、DELETE超时时间

INSERT_SELECT_TIMEOUT

查询级别修改INSERT、UPDATE和DELETE语句的最大执行时间。默认值：24*3600000，取值范围为大于0的整数，单位：毫秒（ms）。

/*+ INSERT_SELECT_TIMEOUT=3600000 */update customer set customer_name ='adb' where customer_id ='2369';

使用限制

过滤条件不下推

• 内核版本为3.1.4及以上：FILTER_NOT_PUSHDOWN_COLUMNS

• 内核版本为3.1.4以下：NO_INDEX_COLUMNS

查询级别关闭特定字段的过滤条件下推能力。

• 内核版本为3.1.4及以上：/*+ FILTER_NOT_PUSHDOWN_COLUMNS=[Schema1.table1:colName1|colName2;Schema2.table2:colName1|colName2] */

• 内核版本为3.1.4以下：/*+ NO_INDEX_COLUMNS=[tableName1.colName1;colName2,tableName2.colName1] */

过滤条件不下推

BUILD调度优先级

BUILD_TASK_PRIORITY

修改BUILD任务调度的优先级。目前只支持使用Hint对单表配置BUILD调度的优先级。默认值为0，取值范围为大于或等于0的整数，数值越大，BUILD任务调度的优先级越高。

/*+ BUILD_TASK_PRIORITY = 2*/ BUILD TABLE db.table;

配置BUILD调度优先级

弹性导入

• ELASTIC_LOAD

• ELASTIC_LOAD_CONFIGS

选择弹性导入并配置执行弹性导入任务的Job型资源组。

/*+ ELASTIC_LOAD=true, ELASTIC_LOAD_CONFIGS=[adb.load.resource.group.name=resource_group]*/

SUBMIT JOB INSERT OVERWRITE INTO adb_demo.adb_import_test SELECT * FROM adb_external_db.person;

• 通过外表弹性导入OSS数据

• 通过外表弹性导入MaxCompute数据

调整执⾏计划

• 内核版本3.1.8及以上O_CBO_RULE_SWAP_OUTER_JOIN

• 内核版本3.1.8及以下LEFT_TO_RIGHT_ENABLED

Hash Join的实现会以右表做BUILD，且Left Join不会做左右表的重新排序，在右表数据量很大时会造成执行慢、消耗过多内存资源等多个问题。您可以通过添加Hint指定优化器根据资源损耗把Left Join转为Right Join。取值：

• true：开启。

• false（默认值）：关闭。

• /*+ O_CBO_RULE_SWAP_OUTER_JOIN=true*/

• /*+ LEFT_TO_RIGHT_ENABLED=true*/

Left join优化改写为Right join

REORDER_JOINS

AnalyticDB for MySQL默认开启自动调整Join顺序的功能，您可以根据查询的数据特征手动调整Join顺序，让查询直接根据SQL书写方式中的Join顺序来执行。取值：

• true（默认值）：开启自动调整Join顺序功能。

• false：关闭自动调整Join顺序功能。

/*+ REORDER_JOINS=false*/

手动调整Join顺序

AGGREGATION_PATH_TYPE

如果使用两步聚合方式，在分组聚合的分组数较多时，会消耗很多计算资源。您可以使用该Hint语句跳过局部聚合，直接进行最终聚合。取值：

• single_agg：跳过局部聚合。

• auto（默认值）：优化器自动判断是否跳过局部聚合。

/*+ AGGREGATION_PATH_TYPE=single_agg*/

分组聚合查询优化

调整运⾏时策略

HASH_PARTITION_COUNT

每个计算任务都会被切分成多个Task并发执行，充分利用计算资源。您可使用该Hint设置并发度。默认值为32，取值范围为大于0的整数。

/*+ HASH_PARTITION_COUNT=32*/

无

TASK_WRITER_COUNT

INSERT INTO SELECT导入任务的并发数，当Worker负载过高时，可修改该Hint降低并发数。默认值为16，取值范围为大于0的整数。

/*+ TASK_WRITER_COUNT=8*/

CTE_EXECUTION_MODE

是否开启CTE执行优化。CTE执行优化功能开启后，CTE子查询被多次引用时，只执行一次，提升部分查询的查询性能。取值：

• shared：开启CTE执行优化功能。

• inline（默认值）：关闭CTE执行优化功能。

/*+ CTE_EXECUTION_MODE=shared*/

WITH

查询条件限制

QUERY_MAX_SHUFFLE_DATA_SIZE_MB

查询的Shuffle数据量。默认情况下，无论查询的数据量为多少，都不会触发报错。若设置了该参数，查询的数据量超过设定阈值后系统会直接终止查询并报错。取值范围为大于0的整数，单位为MB。

/*+ QUERY_MAX_SHUFFLE_DATA_SIZE_MB=1024*/

无

MAX_SELECT_ITEMS_COUNT

设置SELECT条件的个数限制。默认值：1024，取值范围为大于0的整数。

/*+ MAX_SELECT_ITEMS_COUNT=2048*/

MAX_IN_ITEMS_COUNT

设置IN条件的个数限制。默认值：4000，取值范围为大于0的整数。

/*+ MAX_IN_ITEMS_COUNT=1000*/

MAX_WHERE_ITEMS_COUNT

设置WHERE条件的个数限制。默认值：256，取值范围为大于0的整数。

/*+ MAX_WHERE_ITEMS_COUNT=512*/

XIHE BSP作业优先级

QUERY_PRIORITY

BSP作业的优先级。取值：

• HIGH

• NORMAL（ 默认值）

• LOW

• LOWEST

/*+ QUERY_PRIORITY=HIGH*/

配置项列表

XIHE BSP作业使用的最大ACU数

ELASTIC_JOB_MAX_ACU

单个XIHE BSP作业所使用的最大ACU数。默认值为9，最小值为3，取值范围

为[3,Job型资源组最大资源量]。

/*+ ELASTIC_JOB_MAX_ACU=20*/

XIHE BSP作业查询超时时间

BATCH_QUERY_TIMEOUT

XIHE BSP作业的超时时间。默认值是7200000 ms，取值范围为大于0的整数。单位：毫秒（ms）。

/*+ BATCH_QUERY_TIMEOUT=3600000*/

OSS外表

OUTPUT_FILENAME

通过OSS外表导出数据时，可以在导出语句前添加该Hint，自定义存储在OSS中的文件名称。

/*+ OUTPUT_FILENAME=output.csv*/

导出至OSS

SQL_OUTPUT_OSS_FILE_HEAD_ENABLE

通过OSS外表导出数据时，导出到OSS中的数据文件默认不带列名，只有数据。若您想导出带列名的文件，请在导入语句前添加该Hint。取值：

• true：是。

• false（默认值）：否。

/*+ SQL_OUTPUT_OSS_FILE_HEAD_ENABLE=true*/

HIVE_SPLIT_ASYNC_GENERATION_ENABLED

Hive生成执行计划时，是否将Hive Split任务异步提交到队列中执行。取值：

• true：是。

• false（默认值）：否。

/*+ HIVE_SPLIT_ASYNC_GENERATION_ENABLED=true*/

通过外表导入至湖仓版

FAST_PARQUET_READER_ENABLE

当Parquet文件中的统计信息有误时，

是否回退到原生的Parquet reader。

• true（默认值）：是。

• false：否。

/*+ FAST_PARQUET_READER_ENABLE=true*/

OSS_VECTORIZED_PARQUET_READER_ENABLE

在数据中没有NULL值的情况下，是否开启Parquet向量化读开关。取值：

• true：是。

• false（默认值）：否。

/*+ OSS_VECTORIZED_PARQUET_READER_ENABLE=true*/

OSS_VECTORIZED_PARQUET_READER_NULL_SCENE_ENABLE

在数据中有NULL值的情况下，是否开启Parquet向量化读开关。取值：

• true：是。

• false（默认值）：否。

/*+ OSS_VECTORIZED_PARQUET_READER_NULL_SCENE_ENABLE=true*/

HUDI_METADATA_TABLE_ENABLED

是否加载Hudi的元数据信息。取值：

• true：是。

• false（默认值）：否。

/*+ HUDI_METADATA_TABLE_ENABLED=true*/

HUDI_QUERY_TYPE

设置查询Hudi表的方式。取值：

• snapshot：查询指定时间所有提交或压缩后的数据。

• read_optimized（默认值）：查询最后一次提交或压缩之后的数据。

/*+ HUDI_QUERY_TYPE=snapshot*/

HUDI_REALTIME_SKIP_MERGE

快照查询Hudi表数据时，是否跳过基本文件和日志文件的记录合并。取值：

• true：是。

• false（默认值）：否。

/*+ HUDI_REALTIME_SKIP_MERGE=true*/

HUDI_MAX_SPLIT_SIZE=

最大Split的大小。默认值为128。单位：MB。

/*+ HUDI_MAX_SPLIT_SIZE=128*/

HUDI_SPLIT_PARALLEL_GENERATION_ENABLED

是否并行生成Split。取值：

• true（默认值）：是。

• false：否。

/*+ HUDI_SPLIT_PARALLEL_GENERATION_ENABLED=true*/

HUDI_DATA_SKIPPING_ENABLED

在读取数据时，使用Hudi MetaTable表中的统计信息跳过不需要读取的分片，提升查询性能。取值：

• true：是。

• false（默认值）：否。

/*+ HUDI_DATA_SKIPPING_ENABLED=true*/

HUDI_SPLIT_ASYNC_GENERATION_ENABLED

在生成执行计划的阶段，是否异步生成Hudi Split。取值：

• true（默认值）：是。

• false：否。

/*+ HUDI_SPLIT_ASYNC_GENERATION_ENABLED=true*/

RDS MySQL外表

JDBC_SCAN_SPLITS

通过JDBC执行TableScan时的Split个数。默认值为1，取值范围为1~100。

/*+ JDBC_SCAN_SPLITS=1*/

通过外表导入至湖仓版

JDBC_SPLIT_COLUMN

读取RDS MySQL外表时，切分Split的列。

/*+ JDBC_SPLIT_COLUMN=column1*/

JDBC_INSERT_DIRECTLY

RDS MySQL外表写数据时，默认先写入临时表，再写入目标表。您可以通过修改Hint直接将数据写入目标表，但是在写入过程中，出现任何报错，会导致目标表中有脏数据。取值：

• true：是。

• false（默认值）：否。

/*+ JDBC_INSERT_DIRECTLY=true*/

Tablestore外表

OTS-INSERT-AS-UPDATE

是否使用INSERT语句代替UPDATE语句。取值：

• true：是。

• false（默认值）：否。

/*+ OTS-INSERT-AS-UPDATE=true*/

查询并导入Tablestore数据

MaxCompute外表

ODPS_SPLIT_LIMIT

通过Tunnel读取数据时，最多切分Split的数量。默认值为1000，取值范围为1~1000。

/*+ ODPS_SPLIT_LIMIT=1000*/

通过外表导入至湖仓版

IGNORE_PARTITION_CACHE

执行带有分区条件的查询时，不使用缓存的分区元数据信息，而是从MaxCompute表中直接查询分区元数据。

• true：是。

• false（默认值）：否。

/*+ IGNORE_PARTITION_CACHE=true*/

ROWS_PER_SPLIT

通过Tunnel读取数据时，单个Split的最大读取的数据行数。默认值为500000，取值范围为10000~500000。

/*+ ROWS_PER_SPLIT=500000*/

STORAGE_API_ENABLED

是否使用MaxCompute Storage API读取MaxCompute数据。MaxCompute Storage API相比传统的Tunnel读取性能有很大提升。

取值：

• true：是。

• false（默认值）：否。

/*+ STORAGE_API_ENABLED=true*/

APLIT_BYTE_SIZE

通过MaxCompute Storage API读取数据时，单个Split的最大值。默认值为256，单位：MB。

/*+ APLIT_BYTE_SIZE=256*/

MAX_BATCH_ROW_COUNT

通过MaxCompute Storage API读取数据时，单个Split的最大行数。默认值为1024。

/*+ MAX_BATCH_ROW_COUNT=1024*/

PAGE_BATCH_SIZE

通过MaxCompute Storage API读取数据时，每个Page所包含的最大行数。默认值为1024。

/*+ PAGE_BATCH_SIZE=1024*/

MAX_ALLOCATION_PER_SPLIT

通过MaxCompute Storage API读取数据时，Split级别分配的最大峰值内存。默认值为300 MB，单位：MB。

/*+ MAX_ALLOCATION_PER_SPLIT=300*/

ASYNC_GET_SPLIT

MaxCompute生成执行计划时，是否通过优化Split加载性能，将任务异步提交到队列中执行。取值：

• true：是。

• false（默认值）：否。

/*+ ASYNC_GET_SPLIT=true*/

扫描并发控制

SPLIT_FLOW_CONTROL_ENABLED

AnalyticDB for MySQL支持配置扫描并发额度，避免因查询的扫描并发过大、占用过多资源，导致节点不稳定的情况。取值如下：

• true（默认值）：开启扫描并发控制功能。

• false：关闭扫描并发控制功能。

/*+ SPLIT_FLOW_CONTROL_ENABLED=true*/ SELECT * FROM table;

扫描并发控制

MIN_RUNNING_SPLITS_LIMIT_PER_TASK

Task扫描并发额度的最小值。默认值为1，取值范围为[1,TARGET_RUNNING_SPLITS_LIMIT_PER_TASK]。

/*+ MIN_RUNNING_SPLITS_LIMIT_PER_TASK=10*/SELECT * FROM orders;

TARGET_RUNNING_SPLITS_LIMIT_PER_TASK

Task扫描并发额度的中间值，基于该值增加或降低扫描并发额度。默认值为32，取值范围为[MIN_RUNNING_SPLITS_LIMIT_PER_TASK,MAX_RUNNING_SPLITS_LIMIT_PER_TASK]。

/*+ TARGET_RUNNING_SPLITS_LIMIT_PER_TASK=32*/SELECT * FROM adb_test;

MAX_RUNNING_SPLITS_LIMIT_PER_TASK

Task扫描并发额度的最大值。默认值为64，取值范围大于TARGET_RUNNING_SPLITS_LIMIT_PER_TASK值。

/*+ MAX_RUNNING_SPLITS_LIMIT_PER_TASK=100*/SELECT * FROM adb_test;

Paging Cache（深分页性能优化）

PAGING_ID

启用Paging Cache功能，并手动指定paging_id用来标识一组相关的分页查询的缓存（即一组Pattern相同，仅LIMIT和OFFSET参数不同的分页查询）。

/*PAGING_ID=paging123*/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

Paging Cache（深分页性能优化）

PAGING_CACHE_ENABLED

启用Paging Cache功能，并根据SQL Pattern自动生成paging_id来标识一组相关的分页查询的缓存（即一组Pattern相同，仅LIMIT和OFFSET参数不同的分页查询）。取值如下：

• true：开启Paging Cache功能。

• false（默认值）：关闭Paging Cache功能。

/*PAGING_CACHE_ENABLED=true*/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

PAGING_CACHE_VALIDITY_INTERVAL

设置缓存有效时间，超过该时间后缓存将失效。若缓存在失效后一个小时内未被访问，系统将自动删除对应的临时缓存表。取值范围为大于0的整数，单位：秒（s）。此参数需与paging_cache_enabled配合使用。

/*PAGING_CACHE_ENABLED=true,PAGING_CACHE_VALIDITY_INTERVAL=300*/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

INVALIDATE_PAGING_CACHE

是否清理指定Pattern的分页查询缓存。取值如下：

• true：是。

• false（默认值）：否。

此参数需与paging_id或paging_cache_enabled配合使用。

/*PAGING_CACHE_ENABLED=true,INVALIDATE_PAGING_CACHE=true*/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

指定表引擎

RC_DDL_ENGINE_REWRITE_XUANWUV2

指定当前SQL所创建的表的引擎。取值：

• true（默认值）：存量表的表引擎不变，仅当前SQL所创建的表引擎默认为XUANWU_V2。即使在新建该表时显式指定ENGINE=XUANWU，也会自动将其改写为XUANWU_V2。

• false：存量表的表引擎不变，当前SQL所创建的表引擎默认为XUANWU。

/*+ RC_DDL_ENGINE_REWRITE_XUANWUV2=true */

指定表引擎

其他

RESOURCE_GROUP

指定查询所使⽤的资源组。若不指定资源组，默认使用数据库账号绑定的资源组。数据库账号未绑定资源组时，则使用默认资源组。

/*+ RESOURCE_GROUP=my_group_name*/

无

DML_EXCEPTION_TO_NULL_ENABLED

INSERT SELECT语句写入的数据出现非法值，是否抛出异常。取值：

• true：不抛出异常，写入NULL值。

• false（默认值）：抛出异常。

/*+ DML_EXCEPTION_TO_NULL_ENABLED=true*/

DISPLAY_HINT

⽤于标记相应的查询，例如来自于不同的业务方，便于识别。

/*+ DISPLAY_HINT=from_user_123*/