Apache Doris 存储策略管理：SHOW STORAGE POLICY 详解

存储策略概述

在 Apache Doris 分布式数据库系统中，存储策略(Storage Policy)是一项重要的资源管理功能。它允许管理员根据数据访问频率和重要性，将数据分配到不同的存储介质上，实现冷热数据分离存储，从而优化存储成本和提高查询性能。

SHOW STORAGE POLICY 命令功能

SHOW STORAGE POLICY 是 Apache Doris 提供的一个管理命令，主要用于查看系统中存储策略的使用情况和详细配置。通过该命令，管理员可以：

1. 查看所有已配置的存储策略及其属性
2. 查询特定存储策略关联的数据库对象
3. 监控存储策略在系统中的实际应用情况

命令语法详解

基本语法

SHOW STORAGE POLICY [ USING [ FOR <storage_policy_name> ] ]

参数说明

• <storage_policy_name>：可选参数，指定要查询的存储策略名称。当不指定时，返回所有存储策略的配置信息。

权限要求

执行此命令需要具备 ADMIN_PRIV 权限，这是 Apache Doris 中的集群管理权限，包含除 NODE_PRIV 外的所有管理权限。

使用场景示例

场景一：查看所有存储策略配置

SHOW STORAGE POLICY;

执行结果示例：

+-------------+----------+---------+---------+-----------------+------------------+-------------+
| PolicyName  | Id       | Version | Type    | StorageResource | CooldownDatetime | CooldownTtl |
+-------------+----------+---------+---------+-----------------+------------------+-------------+
| test_policy | 14589252 | 0       | STORAGE | remote_s3       | -1               | 300         |
| dev_policy  | 14589521 | 0       | STORAGE | remote_s3       | -1               | 3000        |
+-------------+----------+---------+---------+-----------------+------------------+-------------+

字段解释：

• PolicyName：策略名称
• Id：策略唯一标识
• Version：策略版本
• Type：策略类型（通常为 STORAGE）
• StorageResource：关联的存储资源
• CooldownDatetime：数据冷却时间点（-1 表示未设置）
• CooldownTtl：数据冷却时间（秒）

场景二：查看所有应用存储策略的对象

SHOW STORAGE POLICY USING;

执行结果示例：

+-----------------------+-----------------------------------------+----------------------------------------+------------+
| PolicyName            | Database                                | Table                                  | Partitions |
+-----------------------+-----------------------------------------+----------------------------------------+------------+
| test_storage_policy   | regression_test_cold_heat_separation_p2 | table_with_storage_policy_1            | ALL        |
| test_storage_policy   | regression_test_cold_heat_separation_p2 | partition_with_multiple_storage_policy | p201701    |
+-----------------------+-----------------------------------------+----------------------------------------+------------+

字段解释：

• PolicyName：应用的存储策略名称
• Database：应用策略的数据库
• Table：应用策略的表
• Partitions：应用策略的分区（ALL 表示整表应用）

场景三：查看特定存储策略的应用情况

SHOW STORAGE POLICY USING FOR test_storage_policy;

执行结果示例：

+---------------------+-----------+---------------------------------+------------+
| PolicyName          | Database  | Table                           | Partitions |
+---------------------+-----------+---------------------------------+------------+
| test_storage_policy | db_1      | partition_with_storage_policy_1 | p201701    |
| test_storage_policy | db_1      | table_with_storage_policy_1     | ALL        |
+---------------------+-----------+---------------------------------+------------+

最佳实践建议

1. 定期检查：建议定期执行 SHOW STORAGE POLICY 命令，监控存储策略的使用情况，确保策略按预期应用。

2. 命名规范：为存储策略制定清晰的命名规范，便于管理和识别。

3. 权限控制：严格控制 ADMIN_PRIV 权限的分配，避免未经授权的策略查看和修改。

4. 策略评估：通过查看策略应用情况，评估存储策略的实际效果，必要时进行调整优化。

5. 文档记录：将存储策略配置和使用情况记录在系统文档中，便于团队协作和问题排查。

常见问题解答

Q：为什么执行 SHOW STORAGE POLICY 命令没有返回结果？

A：可能原因包括：

1. 系统中尚未配置任何存储策略
2. 当前用户没有足够的权限查看存储策略
3. 命令语法错误

Q：Partitions 列显示 ALL 和具体分区名有什么区别？

A：ALL 表示该存储策略应用于整张表的所有分区，而具体分区名表示策略仅应用于指定的分区。

Q：如何判断存储策略是否生效？

A：可以通过 SHOW STORAGE POLICY USING 查看策略是否已关联到预期的表和分区，同时结合系统监控数据观察存储分布变化。