操作场景

您可以通过为只读实例开启DuckDB引擎的方式，使关系型数据库MySQL版实例提供高效的分析查询能力。使用方法如下：

1. 为只读实例开启DuckDB引擎。

2. 在待执行的查询语句中，添加/*+SET_VAR(quantum_force_use_custom_scan=1)*/字段，即可使用DuckDB引擎执行该查询语句。

   示例如下：

   SELECT /*+SET_VAR(quantum_force_use_custom_scan=1)*/
          value_type,
          AVG(measurement_value)
      FROM quantum_data
      WHERE value_type IN ('energy', 'state')
      GROUP BY value_type
      ORDER BY AVG(measurement_value) DESC;

约束限制

• 仅只读实例支持该功能，且只读实例规格必须为8C16G及以上。

  说明

  如果当前只读实例规格偏低，请先升级只读实例规格，再开启DuckDB引擎，以免影响查询性能或稳定性。

• 仅8.0版本实例支持该功能。

• 仅内核小版本为8.0.58-262或更高版本的实例支持该功能。

  说明

  建议将只读实例内核小版本升级到最新版本， 具体操作，请参见升级数据库内核小版本。

注意事项

• 如果只读实例开启了DuckDB引擎，则将该只读实例转为单机实例时，因单机实例不支持DuckDB引擎，会自动关闭DuckDB引擎。

• 实例恢复时，如果目标实例上存在已开启DuckDB引擎的只读实例，则该只读实例上的数据将被覆盖，因此，恢复后您需要重新为该只读实例开启DuckDB引擎。

开启DuckDB引擎

1. 在天翼云官网首页的顶部菜单栏，选择产品 > 数据库 > 关系型数据库 > 关系数据库MySQL版，进入关系数据库MySQL产品页面。然后单击管理控制台，进入概览页面。

2. 在左侧导航栏，选择MySQL > 实例管理，进入实例列表页面。然后在顶部菜单栏，选择区域和项目。

3. 选择实例列表中处于运行中状态的只读实例，单击实例名称，进入实例基本信息页面。

4. 单击DuckDB引擎页签，并在弹框中勾选我已阅读并同意《天翼云关系型数据库服务协议》。

5. 单击确认。

   DuckDB引擎开启后，您可以根据实际情况，修改DuckDB引擎相关参数或关闭DuckDB引擎。

修改DuckDB引擎参数

1. 在天翼云官网首页的顶部菜单栏，选择产品 > 数据库 > 关系型数据库 > 关系数据库MySQL版，进入关系数据库MySQL产品页面。然后单击管理控制台，进入概览页面。

2. 在左侧导航栏，选择MySQL > 实例管理，进入实例列表页面。然后在顶部菜单栏，选择区域和项目。

3. 选择实例列表中处于运行中状态的只读实例，单击实例名称，进入实例基本信息页面。

4. 单击DuckDB引擎页签，进入DuckDB引擎管理页面。

5. 在参数列表中，查看并修改目标参数的当前值。

   参数名	是否需要重启	允许值	描述
   loose_quantum_duckdb_io_threads	否	4-128	DuckDB扫描IO线程
   loose_quantum_duckdb_max_memory	否	8192-16384	DuckDB内存限制。 注意 建议DuckDB引擎内存不高于当前实例内存的50%。
   loose_quantum_duckdb_threads	否	4-1024	DuckDB计算线程池大小

6. 单击参数列表上方的保存。

   说明

   您也可以单击参数列表上方的修改预览，查看修改后的参数配置。

关闭DuckDB引擎

1. 在天翼云官网首页的顶部菜单栏，选择产品 > 数据库 > 关系型数据库 > 关系数据库MySQL版，进入关系数据库MySQL产品页面。然后单击管理控制台，进入概览页面。

2. 在左侧导航栏，选择MySQL > 实例管理，进入实例列表页面。然后在顶部菜单栏，选择区域和项目。

3. 选择实例列表中处于运行中状态的只读实例，单击实例名称，进入实例基本信息页面。

4. 单击DuckDB引擎页签，进入DuckDB引擎管理页面。

5. 单击参数列表上方的关闭DuckDB引擎。