--- title: "修改表级冷热存储策略 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 修改表级冷热存储策略 本文将向您介绍如何使用 SQL 语句修改表级冷热存储策略（ STORAGE_CACHE_POLICY ）： 修改普通表的冷热存储策略。 修改索引表的冷热存储策略。 注意事项 在共享存储模式下，才可以修改表/索引的冷热存储策略。 修改普通表的冷热存储策略 表创建成功后，可以使用 ALTER TAB… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 修改表级冷热存储策略 更新时间：2026-07-15 15:16:39 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/660.ob-shared-storage/400.customize-hotspot-cache-of-mysql-mode/400.modify-table-level-storage-cache-policy-of-mysql-mode.md) 本文将向您介绍如何使用 SQL 语句修改表级冷热存储策略（`STORAGE_CACHE_POLICY`）： - 修改普通表的冷热存储策略。 - 修改索引表的冷热存储策略。 ## 注意事项 在共享存储模式下，才可以修改表/索引的冷热存储策略。 ## 修改普通表的冷热存储策略 表创建成功后，可以使用 `ALTER TABLE` 语句修改表的冷热存储策略（`STORAGE_CACHE_POLICY`），语法格式如下： ```sql 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`。详细使用宏块冷热策略的介绍，参见 [创建宏块级冷热存储策略](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681923)。 ### 示例 - 修改表 `tbl1` 的热点缓存由系统自动识别。 ```shell obclient> ALTER TABLE tbl1 SET STORAGE_CACHE_POLICY (GLOBAL = "auto"); ``` - 修改表 `tbl2_date` 中通过 `col3` 判断热数据维持 2 个月后，直接变为冷数据。 ```shell obclient> ALTER TABLE tbl2_date SET STORAGE_CACHE_POLICY ( BOUNDARY_COLUMN = col3, HOT_RETENTION = 2 MONTH, MIXED_RETENTION = 0 HOUR); ``` - 修改表 `tbl2_int` 时间轴策略，为 3 年以后热数据转为 `AUTO`。 ```shell obclient> ALTER TABLE tbl2_int STORAGE_CACHE_POLICY ( BOUNDARY_COLUMN = col3, BOUNDARY_COLUMN_UNIT = 'ms', HOT_RETENTION = 3 YEAR); ``` ## 修改索引表的冷热存储策略 可以使用 `ALTER TABLE` 语句修改已有索引的冷热存储策略（`STORAGE_CACHE_POLICY`），语法格式如下： ```sql 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"} ``` ### 相关参数说明 - `GLOBAL = {"hot" | "auto" | "cold" | "none"}`：用于指定索引的数据的冷热存储策略，取值如下： - `hot`：表示指定索引为热存储，在缓存盘空间足够的情况下，索引表下所有数据将会缓存到本地缓存盘。 - `auto`：表示指定索引表热数据为系统自动识别。 - `cold`：表示指定索引表数据为冷数据，不会缓存到本地缓存盘，对于已经持久化到缓存的数据会主动触发缓存淘汰，后续访问的表数据可以存储在宏块内存缓存，不会持久化到宏块缓存和微块缓存。 - `none`：默认值，表示该索引的策略跟随主表 `STORAGE_CACHE_POLICY` 取值。 - `timeline_strategy_list`：表示时间轴策略参数列表，各参数间使用英文逗号分隔。时间轴策略支持通过时间来判断分区/宏块数据冷热存储的机制，系统根据配置的策略，自动调整本地缓存盘上的数据。 - 当分区列为 `INT` 类型时，`BOUNDARY_COLUMN_UNIT` 取值只能为 `s`。 - 当分区列为 `BIGINT` 类型时，`BOUNDARY_COLUMN_UNIT` 取值可以是 `s` 或者 `ms`。 - `HOT_RETENTION = intnum retention_time_unit`：用于配置热数据的时间范围。 ### 示例 修改索引 `idx2` 的热数据为系统自动识别。 ```sql ALTER TABLE test_tbl2 ALTER INDEX idx2 STORAGE_CACHE_POLICY (GLOBAL = "auto"); ``` ## 相关文档 - [自定义冷热存储策略概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681922) - [创建表级冷热存储策略](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681925) - [创建分区级冷热存储策略](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681919) - [修改分区级冷热存储策略](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681921) - [ALTER TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686147) - [自定义冷热存储策略运维指南](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681920) 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线