# 优化器GUC参数的Hint
#### 功能描述
设置本次查询执行内生效的查询优化相关GUC参数。hint的推荐使用场景可以参考各guc参数的说明，此处不作赘述。
#### 语法格式
```
set(param value)
```
#### 参数说明
- **param：**表示参数名。
- **value**：表示参数的取值。
- 目前支持使用Hint设置生效的参数有：
  - 布尔类： enable_bitmapscan, enable_hashagg, enable_hashjoin, enable_indexscan, enable_indexonlyscan, enable_material, enable_mergejoin, enable_nestloop, enable_index_nestloop, enable_seqscan, enable_sort, enable_tidscan, enable_stream_operator, enable_stream_recursive, enable_broadcast, enable_fast_query_shipping, enable_trigger_shipping, enable_remotejoin, enable_remotegroup, enable_remotelimit, enable_remotesort
    
  
  - 整型类： best_agg_plan, query_dop
    
  
  - 浮点类： cost_weight_index, default_limit_rows, seq_page_cost, random_page_cost, cpu_tuple_cost, cpu_index_tuple_cost, cpu_operator_cost, effective_cache_size
    
  
  - 字符串类： node_name
    通过设置node_name可以指定当前的sql下发到node_name对应的dn上去执行。
    示例：
    ```
    select /*+ set(node_name datanode1) */ from table_name;
    ```
    其中，datanode1是从 pgxc_node 系统表里查询出来的数据节点的名称（不用加引号），table_name 是表名。该查询表示直接去datanode1上执行查询。
    ![](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
    - node_name只支持在select语句里设置，如果在其他语句里设置将会不生效。
    
    - node_name只支持设置data node名字，不支持设置coodninator名字。
    
    - node_name不支持通过SET语句进行修改，只能用在plan hint里。
    
    - node_name不支持通过gs_guc进行修改。
    
    - node_name仅支持简单查询语句，不支持带union，union all, 子查询，多表关联等复杂查询语句。
    
    - 支持普通用户执行。
    
    - 不支持与行级访问控制同时使用，同时使用会报错。
      
   
![](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 设置不在白名单中的参数，参数取值不合法，或hint语法错误时，不会影响查询执行的正确性。使用explain(verbose on)执行可以看到hint解析错误的报错提示。
- GUC参数的hint只在最外层查询生效，子查询内的GUC参数hint不生效。
- 视图定义内的GUC参数hint不生效。
- CREATE TABLE ... AS ... 查询最外层的GUC参数hint可以生效。