OPTIONS

该部分的语法主要是设置，修改或者展示 AIR的一些配置项。相关配置项请参考：引擎配置参数。

SHOW OPTIONS

• 语法说明

SHOW <level> VARIABLES 
(
    LIKE 'keyword'
  |
    WHERE  <key> = 'value' [(AND | OR) ...]
)

• 参数说明

关键字	类型	说明
level	SQL标识符，选填	level 默认为 session 级别支持的级别为：GLOBAL、CLUSTER、SESSION

• 使用示例

-- 显示GLOBAL级别的所有配置项；
SHOW GLOBAL VARIABLES; 

--  查找GLOBAL级别的所有time结尾的配置项；
SHOW GLOBAL VARIABLES like '%time'


-- 显示GLOBAL级别的变量名为“wait_timeout”的配置项
show GLOBAL variables where variable_name = 'wait_timeout' 

-- 显示SESSION级别的变量名为“enable.query.rewrite.by.view”的配置项值
show session variables where variable_name = "enable.query.rewrite.by.view"; 

• 返回结果

      Variable Name       | Value | Scope  
--------------------------+-------+--------
 rp.system.case_sensitive | false | GLOBAL 

### SET OPTIONS

设置AIR引擎的配置项

• 语法说明

SET <level> "key" = value 

• 参数说明

关键字	类型	说明
level	SQL标识符，选填	level 默认为 session 级别支持的级别为：GLOBAL、CLUSTER、SESSION
value	变量的值	当变量值为数值类型，则直接写数值；如"rp.failures.threshold" = 3当变量为字符串类型时，则需用单引号包含值，如："enable.query.rewrite.by.view"='false'

• 例子

set "rp.failures.threshold" = 3  #默认设置SESSION级别配置项
set GLOBAL "rp.failures.threshold" = 3  #设置GLOBAL级别配置项
set SESSION "rp.failures.threshold" = 3 #设置SESSION级别配置项
set CLUSTER("default") "rp.failures.threshold"=3 -- 设置指定的cluster范围的配置项
set CLUSTER "enable.query.rewrite.by.view"='false' -- 设置当前默认cluster范围的配置项

设置单条SQL执行生效的配置项

 /*+ options ("rp.failures.threshold" = 3, "dialect.query.jdbc.pushdown" = false) */ 
explain select * from zs_mysql_test.tpcds.call_center;

[警告]注意：引擎层任何参数的修改都需要特别谨慎，不恰当的参数修改有可能导致整个引擎宕机，极端情况会导致引擎无法启动，进而无法恢复到修改前的状态。修改前请跟技术支持同学确认参数的配置和参数值的正确性。