修改表级冷热存储策略

本文将向您介绍如何使用 SQL 语句修改表级冷热存储策略（STORAGE_CACHE_POLICY）：

• 修改普通表的冷热存储策略。
• 修改索引表的冷热存储策略。

注意事项

在共享存储模式下，才可以修改表/索引的冷热存储策略。

修改普通表的冷热存储策略

表创建成功后，可以使用 ALTER TABLE 语句修改表的冷热存储策略（STORAGE_CACHE_POLICY），语法格式如下：

ALTER TABLE table_name SET STORAGE_CACHE_POLICY (storage_cache_policy_option);

storage_cache_policy_option:
    GLOBAL = {"hot" | "auto" | "cold"}
    | timeline_strategy_list

timeline_strategy_list:
    BOUNDARY_COLUMN = column_name
    | BOUNDARY_COLUMN_UNIT = {"s" | "ms"}
    | HOT_RETENTION = intnum retention_time_unit
    | MIXED_RETENTION = intnum retention_time_unit
    | GRANULARITY = {"partition" | "block"}

retention_time_unit:
    YEAR
    | MONTH
    | WEEK
    | DAY
    | HOUR
    | MINUTE

相关参数说明

storage_cache_policy_option 中不同属性以 Key-Value 格式定义。各个属性的语意如下：

• GLOBAL = {"hot" | "auto" | "cold"}：用于指定全表数据的冷热存储策略，取值如下：

  • hot：表示指定表的所有数据都为热数据，在缓存盘空间足够的情况下，表下所有数据将会缓存到本地缓存盘。
  • auto：表示指定表的热数据为系统自动识别。
  • cold：表示指定表数据为冷数据，不会缓存到本地缓存盘，对于已经持久化到缓存的数据会主动触发缓存淘汰，后续访问的表数据可以存储在宏块内存缓存，不会持久化到宏块缓存和微块缓存。

• timeline_strategy_list：表示时间轴策略参数列表，各参数间使用英文逗号分隔。时间轴策略支持通过时间来判断分区/宏块数据冷热存储的机制，系统根据配置的策略，自动调整本地缓存盘上的数据。

  说明

  时间轴：按照 Range 分区定义的分区范围取值进行热数据缓存，当满足一定时间条件时，该分区的数据被判定为热数据。使用时间轴策略时，需要注意以下事项：

  • 仅支持 Range 分区表使用（Range 分区为一级或者二级都可以），因为需要时间来确定是否过期，但不能是双 Range 分区，会因为无法确定以哪个 Range 分区时间为准。
  • 使用时间轴时，分区表达中只能有列名，不支持表达式转换。例如 PARTITION BY RANGE COLUMNS(expr(col3))。
  • BOUNDARY_COLUMN 必须为分区键，如果分区键有多列，BOUNDARY_COLUMN 需为第一列，用来判断分区是否过期。

  • BOUNDARY_COLUMN = column_name：用于判定热数据的列。支持整型（BIGINT 或者 INT 类型，格式为 Unix 时间戳）和时间类型（TIMESTAMP、DATE、DATETIME 或者 YEAR 类型）。

    • 如果 BOUNDARY_COLUMN 类型为整型时，表的分区方式支持 Range/Range Columns 分区类型。
    • 如果 BOUNDARY_COLUMN 类型为时间类型时，表的分区方式只能使用 Range Columns 分区类型。

  • BOUNDARY_COLUMN_UNIT = {"s" | "ms"}：用于指定参数 BOUNDARY_COLUMN 的时间单位。仅支持 BOUNDARY_COLUMN 为整型时设置此参数，整型数值用作时间戳时，需要给定时间戳单位，否则可能会导致错解析出来错误的时间。取值如下：

    • 当分区列为 INT 类型时，BOUNDARY_COLUMN_UNIT 取值只能为 s。

    • 当分区列为 BIGINT 类型时，BOUNDARY_COLUMN_UNIT 取值可以是 s 或者 ms。

      注意

      如果格式非 Unix 时间戳，将不能正确识别 INT 类型表示的时间。

  • HOT_RETENTION = intnum retention_time_unit：用于配置热数据的时间范围。

    • intnum：表示整数。

    • retention_time_unit：表示时间单位，取值如下：

      • YEAR：表示年。
      • MONTH：表示月。
      • WEEK：表示周。
      • DAY：表示天。
      • HOUR：表示小时。
      • MINUTE：表示分钟。

  • MIXED_RETENTION = intnum retention_time_unit：

    • 如果设置 MIXED_RETENTION，则表示距离 HOT_RETENTION + MIXED_RETENTION 的时间范围后的数据都是 cold 数据。
    • 如果不设置 MIXED_RETENTION，则到达 HOT_RETENTION 之后，就一直为 auto 数据。
    • 如果没有设置 HOT_RETENTION, 则表示 [0, MIXED_RETENTION] 的时间范围为 auto 数据，MIXED_RETENTION 之后的为 cold 数据。

  • GRANULARITY = {"partition" | "block"}：可选项，用于指定数据冷热存储的操作粒度，取值如下：

    • partition：表示缓存数据的策略按照分区粒度处理。

    • block：表示缓存数据的策略按照宏块粒度处理。

      说明

      在没有分区表的情况下，需要手动指定一段时间内数据为热点数据时，可以指定 block。详细使用宏块冷热策略的介绍，参见 创建宏块级冷热存储策略。

示例

• 修改表 tbl1 的热点缓存由系统自动识别。

  obclient> ALTER TABLE tbl1 SET STORAGE_CACHE_POLICY (GLOBAL = "auto");
  

• 修改表 tbl2_date 中通过 col3 判断热数据维持 2 个月后，直接变为冷数据。

  obclient> ALTER TABLE tbl2_date SET STORAGE_CACHE_POLICY (
      BOUNDARY_COLUMN = col3,
      HOT_RETENTION = 2 MONTH,
      MIXED_RETENTION = 0 HOUR);
  

• 修改表 tbl2_int 时间轴策略，为 3 年以后热数据转为 AUTO。

  obclient> ALTER TABLE tbl2_int STORAGE_CACHE_POLICY (
      BOUNDARY_COLUMN = col3,
      BOUNDARY_COLUMN_UNIT = 'ms',
      HOT_RETENTION = 3 YEAR);
  

修改索引表的冷热存储策略

可以使用 ALTER TABLE 语句修改已有索引的冷热存储策略（STORAGE_CACHE_POLICY），语法格式如下：

ALTER TABLE table_name ALTER INDEX STORAGE_CACHE_POLICY (storage_cache_policy_option);

storage_cache_policy_option:
    GLOBAL = {"hot" | "auto" | "cold" | "none"}
    | timeline_strategy_list

timeline_strategy_list:
    | BOUNDARY_COLUMN = column_name
    | BOUNDARY_COLUMN_UNIT = {"s" | "ms"}
    | HOT_RETENTION = intnum retention_time_unit
    | MIXED_RETENTION = intnum retention_time_unit
    | GRANULARITY = {"partition" | "block"}

retention_time_unit:
    YEAR
    | MONTH
    | WEEK
    | DAY
    | HOUR
    | MINUTE

相关参数说明

• GLOBAL = {"hot" | "auto" | "cold" | "none"}：用于指定索引的数据的冷热存储策略，取值如下：

  • hot：表示指定索引为热存储，在缓存盘空间足够的情况下，索引表下所有数据将会缓存到本地缓存盘。
  • auto：表示指定索引表热数据为系统自动识别。
  • cold：表示指定索引表数据为冷数据，不会缓存到本地缓存盘，对于已经持久化到缓存的数据会主动触发缓存淘汰，后续访问的表数据可以存储在宏块内存缓存，不会持久化到宏块缓存和微块缓存。
  • none：默认值，表示该索引的策略跟随主表 STORAGE_CACHE_POLICY 取值。

• timeline_strategy_list：表示时间轴策略参数列表，各参数间使用英文逗号分隔。时间轴策略支持通过时间来判断分区/宏块数据冷热存储的机制，系统根据配置的策略，自动调整本地缓存盘上的数据。

  说明

  时间轴：按照 Range 分区定义的分区范围取值进行热数据缓存，当满足一定时间条件时，该分区的数据被判定为热数据。使用时间轴策略时，需要注意以下事项：

  • 仅支持 Range 分区表使用（Range 分区为一级或者二级都可以），因为需要时间来确定是否过期，但不能是双 Range 分区，会因为无法确定以哪个 Range 分区时间为准。
  • 使用时间轴时，分区表达中只能有列名，不支持表达式转换。例如 PARTITION BY RANGE COLUMNS(expr(col3))。
  • BOUNDARY_COLUMN 必须为分区键，如果分区键有多列，BOUNDARY_COLUMN 需为第一列，用来判断分区是否过期。

  • BOUNDARY_COLUMN = column_name：用于判定热数据的列。支持整型（BIGINT 或者 INT 类型，格式为 Unix 时间戳）和时间类型（TIMESTAMP、DATE、DATETIME 或者 YEAR 类型）。

    • 如果 BOUNDARY_COLUMN 类型为整型时，表的分区方式支持 Range/Range Columns 分区类型。
    • 如果 BOUNDARY_COLUMN 类型为时间类型时，表的分区方式只能使用 Range Columns 分区类型。

  • BOUNDARY_COLUMN_UNIT = {"s" | "ms"}：用于指定参数 BOUNDARY_COLUMN 的时间单位。仅支持 BOUNDARY_COLUMN 为整型时设置此参数，整型数值用作时间戳时，需要给定时间戳单位，否则可能会导致错解析出来错误的时间。取值如下：

    • 当分区列为 INT 类型时，BOUNDARY_COLUMN_UNIT 取值只能为 s。
    • 当分区列为 BIGINT 类型时，BOUNDARY_COLUMN_UNIT 取值可以是 s 或者 ms。

  • HOT_RETENTION = intnum retention_time_unit：用于配置热数据的时间范围。

    • intnum：表示整数。

    • retention_time_unit：表示时间单位，取值如下：

      • YEAR：表示年。
      • MONTH：表示月。
      • WEEK：表示周。
      • DAY：表示天。
      • HOUR：表示小时。
      • MINUTE：表示分钟。

  • MIXED_RETENTION = intnum retention_time_unit：

    • 如果设置 MIXED_RETENTION，则表示距离 HOT_RETENTION + MIXED_RETENTION 的时间范围后的数据都是 cold 数据。
    • 如果不设置 MIXED_RETENTION，则到达 HOT_RETENTION 之后，就一直为 auto 数据。
    • 如果没有设置 HOT_RETENTION, 则表示 [0, MIXED_RETENTION] 的时间范围为 auto 数据，MIXED_RETENTION 之后的为 cold 数据。

  • GRANULARITY = {"partition" | "block"}：可选项，用于指定数据冷热存储的操作粒度，取值如下：

    • partition：表示缓存数据的策略按照分区粒度处理。

    • block：表示缓存数据的策略按照宏块粒度处理。

      说明

      在没有分区表的情况下，需要手动指定一段时间内数据为热点数据时，可以指定 block。详细使用宏块冷热策略的介绍，参见 创建宏块级冷热存储策略。

示例

修改索引 idx2 的热数据为系统自动识别。

ALTER TABLE test_tbl2 ALTER INDEX idx2
    STORAGE_CACHE_POLICY (GLOBAL = "auto");

相关文档

• 自定义冷热存储策略概述
• 创建表级冷热存储策略
• 创建分区级冷热存储策略
• 修改分区级冷热存储策略
• ALTER TABLE
• 自定义冷热存储策略运维指南