更新时间:2026-06-11 GMT+08:00
分享

修改GeminiDB Cassandra实例参数

为确保GeminiDB Cassandra发挥出最优性能,用户可根据业务需求对用户创建的参数模板里边的参数进行调整。

使用须知

  • 您可以修改用户创建的数据库参数模板中的参数值,但不能更改默认数据库参数模板中的参数值。
  • 系统提供的默认参数模板不允许修改,只可单击参数模板名进行查看。
  • 当用户参数设置不合理导致数据库无法启动时,可参考默认参数模板重新配置。

您在修改参数相关参数值时,请谨慎,避免因设置参数值不当造成实例或业务异常。

操作步骤

  1. 登录云数据库GeminiDB控制台
  2. 在左侧导航树,单击“参数模板管理”
  3. 在“参数模板管理”页面的“自定义”页签,选择目标参数模板,单击参数模板名称。
  4. “参数”页面,根据需要修改相关参数值。

    图1 编辑参数模板
    • 单击“保存”,在弹出框中单击“确认”,保存修改。
    • 单击“取消”,放弃本次设置。
    • 单击“预览”,可对比参数修改前和修改后的值。
      图2 预览修改参数

  5. 参数修改完成后,您可在“参数修改历史”页面,查看参数的修改详情。

    查看参数修改详情的具体操作请参见查看GeminiDB Cassandra参数修改历史

    • 参数模板修改后,不会立即应用到当前使用的实例,您需要进行应用操作才可生效,具体操作请参见应用GeminiDB Cassandra参数模板
    • 参数修改历史页面仅显示7天之内的参数修改历史。

  1. 登录云数据库GeminiDB控制台
  2. 在左侧导航栏选择“实例管理”,单击指定实例名称,进入基本信息页面。
  3. 单击左侧导航栏中的“参数修改”,在“参数”页签下根据需要修改相关参数值,具体参数详解参见表1

    图3 修改当前实例的参数

    • 单击“保存”,在弹出框中单击“确认”,保存修改。
    • 单击“取消”,放弃本次设置。
    • 单击“预览”,可对比参数修改前和修改后的值。
    表1 表1 GeminiDB Cassandra实例参数

    参数名称

    是否需要重启

    允许值

    描述

    ConcGCThreads

    default

    1~30

    并发GC阶段使用的线程数。如果设定值为default,表示该参数随CPU规格变化。

    ParallelGCThreads

    default

    1~30

    STW阶段执行并行GC时使用的线程数。如果设定值为default,表示该参数随CPU规格变化。

    alter_schema_request_timeout_in_ms

    default

    10,000~120,000

    库表级别元数据更改语句执行时,元数据同步到其他节点的超时时

    authenticator

    PasswordAuthenticator

    PasswordAuthenticator, AllowAllAuthenticator

    后端用户名认证。

    authorizer

    CassandraAuthorizer

    AllowAllAuthorizer, CassandraAuthorizer

    后端用户授权认证。

    batch_size_fail_threshold_in_kb

    5,000

    1~10,000

    批处理请求大小超过该阈值时,请求处理失败。

    batch_size_warn_threshold_in_kb

    5

    1~1,000

    批处理请求大小超过该阈值时,打印WARN级别日志。

    cas_contention_timeout_in_ms

    1,000

    100~30,000

    协调节点等待cas操作完成的超时时间。

    concurrent_alter_schema_forwards

    8

    4~512

    并发执行alter语句线程数。

    concurrent_counter_writes

    32

    4~512

    计数器并发写线程数。

    concurrent_materialized_view_writes

    32

    4~512

    物化视图并发写线程数。

    concurrent_reads

    default

    4~512

    并发读线程数。如果设定值为default,表示该参数随CPU规格变化

    concurrent_writes

    default

    4~512

    并发写线程数。如果设定值为default,表示该参数随CPU规格变化。

    counter_write_request_timeout_in_ms

    5,000

    100~30,000

    协调节点等待counter写操作完成的超时时间。

    enforce_permission_check

    false

    true, false

    DynamoDB接口API鉴权开关,取值{true|false},默认为false关闭状态

    range_request_timeout_in_ms

    10,000

    100~30,000

    协调节点等待range操作完成的超时时间。

    read_request_timeout_in_ms

    5,000

    100~30,000

    协调节点等待读操作完成的超时时间。

    request_timeout_in_ms

    10,000

    100~30,000

    协调节点等待非读、写、range、counter写、cas、以及truncate以外的其他操作完成的超时时间。

    role_manager

    CassandraRoleManager

    CassandraRoleManager

    角色间授权管理。

    slow_query_log_timeout_in_ms

    500

    1~60,000

    慢查询时间阈值,单位为毫秒。

    tombstone_failure_threshold

    100,000

    10~10,000,000

    单次查询结果的墓碑数量超过该阈值时,导致查询失败。

    tombstone_warn_threshold

    1,000

    10~100,000

    单次查询结果的墓碑数量超过该阈值时,打印WARN级别日志。

    truncate_request_timeout_in_ms

    60,000

    100~100,000

    协调节点等待truncate操作完成的超时时间。

    unlogged_batch_across_partitions_warn_threshold

    10

    1~10,000

    批处理请求操作的分区数量超过该阈值时,打印WARN级别日志。

    write_request_timeout_in_ms

    2,000

    100~30,000

    协调节点等待写操作完成的超时时间。

  4. 参数修改完成后,您可在“参数修改历史”页面,查看参数的修改详情。

    查看参数修改详情的具体操作请参见查看GeminiDB Cassandra参数修改历史

    参数模板修改后,根据参数列表中“是否需要重启”提示,进行相应操作:
    • 是:在实例列表中,查看“运行状态”,如果显示参数模板变更,等待重启,则需重启实例使之生效。
    • 否:无需重启,立即生效。

相关文档