更新时间:2025-08-29 GMT+08:00
分享

修改GeminiDB Redis实例参数

为确保GeminiDB Redis发挥出更优性能,用户可根据业务需求对实例参数进行修改调整。

使用须知

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

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

修改当前实例的参数

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

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

      参数名称

      是否需要重启

      允许值

      描述

      例外场景

      AuthFailLockTime

      5

      0~10,000

      防暴力破解相关参数。单位为秒(s)。该参数表示可疑IP被锁定禁止访问的时长,超过该时长后自动解锁。

      Cluster集群版实例不支持该参数。

      BigkeysQuantityLimitation

      100

      1~10,000

      string/hash/list/zset/set/exhash/stream类型的大key查询数量的限制,默认每种类型最多查询100个。

      Cluster集群版实例不支持该参数。

      CompatibleMode

      3

      0, 1, 2, 3

      针对StackExchange.Redis客户端的适配开关。 当StackExchange.Redis客户端报错"Multiple databases are not supported on this server"时,请将该参数修改为"0"。

      Cluster集群版实例不支持该参数。

      EnableAclDbDirect

      no

      yes, no

      是否开启DB直达功能。默认为no。

      Cluster集群版实例不支持该参数。

      MaxAuthFailTimes

      5

      0~10,000

      防暴力破解相关参数。 当密码错误次数累计达到该阈值后,实例会短时内禁止该可疑IP访问。 备注:配置为0表示关闭防暴力破解功能。

      Cluster集群版实例不支持该参数。

      ProxyTimeout

      0

      0~100,000

      Proxy层的空闲连接超时。单位为秒(s)。 当连接空闲时长达到该阈值时,proxy层主动关闭连接。 备注:配置为0表示proxy层不会主动断开客户端连接。

      Cluster集群版实例不支持该参数。

      enable-acl-direct

      no

      yes, no

      是否开启DB直达功能。默认为no。

      Proxy集群版、主备版实例不支持该参数

      bigkeys-composite-threshold

      1024

      1~2,147,483,647

      元素数大于该值的hash/list/zset/set/stream类型key,会被判断为大key,单位为个。默认为1024。

      -

      bigkeys-string-threshold

      102400

      1~2,147,483,647

      value大于该值的string类型key,会被判断为大key,单位为byte。默认为102400。

      -

      databases

      1000

      1~1,000

      允许支持的DB数量限制。

      -

      key-scan-batch

      5000

      1~2,147,483,647

      每次 key scan 扫描的 key 数量。

      -

      maxmemory-policy

      noeviction

      noeviction

      存储空间被写满后的Key丢弃策略。 GaussDB(for Redis)支持秒级无感扩容,写满后进入只读保护,不丢弃业务数据。 备注:后续会开放自动扩容策略。

      -

      notify-keyspace-events

      -

      取值为A,K,E,g,$,l,s,h,z,x,e,t的组合。

      需要监听的事件类型。默认值为空,表示该参数不生效。取值为A,K,E,g,$,l,s,h,z,x,e,t的组合。

      -

      slowlog-threshold

      300000

      80,000~100,000,000

      控制台[慢日志]会记录执行时间大于该阈值的请求。单位为微秒(us)。 备注:该参数配置过小可能影响实例性能,建议保持默认值。

      -

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

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

    参数修改后,会立即应用到当前实例。

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

修改自定义参数模板并应用到实例

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

    图2 编辑参数模板

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

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

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

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

相关文档