大网数据广告活动
数据库部署与 SQL 参考

管理 Storage Vault:创建、配置与权限管理

· 52CE 我爱测

Storage Vault 是 Doris 在存算分离模式中使用的远程共享存储抽象。可以配置一个或多个 Storage Vault,并将不同的表存储在不同的 Storage Vault 上,实现灵活的存储管理。

Storage Vault 是 Doris 在存算分离模式中使用的远程共享存储抽象。可以配置一个或多个 Storage Vault,并将不同的表存储在不同的 Storage Vault 上,实现灵活的存储管理。

创建 Storage Vault

语法

CREATE STORAGE VAULT [IF NOT EXISTS] <vault_name>
PROPERTIES
("key" = "value", ...)

<vault_name> 是用户自定义的 Storage Vault 名称,作为后续操作的唯一标识。

创建 HDFS Storage Vault

创建基于 HDFS 的 Storage Vault 前,需确保所有节点(包括 FE、BE 节点及 Meta Service)均可访问目标 HDFS,包括完成 Kerberos 授权配置和连通性检查(可在各节点上使用 Hadoop Client 测试)。

CREATE STORAGE VAULT IF NOT EXISTS hdfs_vault_demo
PROPERTIES (
    "type"                          = "hdfs",                      -- required
    "fs.defaultFS"                  = "hdfs://127.0.0.1:8020",     -- required
    "path_prefix"                   = "big/data",                  -- optional,一般按业务名称填写
    "hadoop.username"               = "user",                      -- optional
    "hadoop.security.authentication" = "kerberos",                 -- optional
    "hadoop.kerberos.principal"     = "hadoop/127.0.0.1@XXX",     -- optional
    "hadoop.kerberos.keytab"        = "/etc/emr.keytab"            -- optional
);

创建 S3 Storage Vault

CREATE STORAGE VAULT IF NOT EXISTS s3_vault_demo
PROPERTIES (
    "type"           = "S3",                                -- required
    "s3.endpoint"    = "oss-cn-beijing.aliyuncs.com",       -- required
    "s3.region"      = "cn-beijing",                        -- required
    "s3.bucket"      = "bucket",                            -- required
    "s3.root.path"   = "big/data/prefix",                   -- required
    "s3.access_key"  = "ak",                                -- required
    "s3.secret_key"  = "sk",                                -- required
    "provider"       = "OSS",                               -- required
    "use_path_style" = "false"                              -- optional
);

对象存储路径必须具备以下访问权限:head、get、list、put、multipartUpload、delete。

更多云厂商示例及参数说明,请参阅 CREATE-STORAGE-VAULT。

查看 Storage Vault

语法

SHOW STORAGE VAULTS

返回结果包含 4 列:

列名 说明
Storage Vault 名称 用户定义的 Vault 标识名
Storage Vault ID 系统分配的唯一 ID
属性 Vault 的配置属性
是否为默认 是否为默认 Storage Vault

设置默认 Storage Vault

语法

SET <vault_name> AS DEFAULT STORAGE VAULT

设置后,建表时若未显式指定 Storage Vault,将自动使用该默认 Vault。

建表时指定 Storage Vault

在 CREATE TABLE 的 PROPERTIES 中指定 storage_vault_name,表数据将存储到对应的 Storage Vault。

建表成功后,不允许修改该表的 storage_vault,即不支持更换 Storage Vault。

示例

CREATE TABLE IF NOT EXISTS supplier (
    s_suppkey int(11)      NOT NULL COMMENT "",
    s_name    varchar(26)  NOT NULL COMMENT "",
    s_address varchar(26)  NOT NULL COMMENT "",
    s_city    varchar(11)  NOT NULL COMMENT "",
    s_nation  varchar(16)  NOT NULL COMMENT "",
    s_region  varchar(13)  NOT NULL COMMENT "",
    s_phone   varchar(16)  NOT NULL COMMENT ""
)
UNIQUE KEY (s_suppkey)
DISTRIBUTED BY HASH(s_suppkey) BUCKETS 1
PROPERTIES (
    "replication_num"    = "1",
    "storage_vault_name" = "hdfs_demo_vault"
);

创建数据库时指定 Storage Vault

在 CREATE DATABASE 的 PROPERTIES 中指定 storage_vault_name。数据库下的新建表若未单独指定 Storage Vault,将继承数据库的 Storage Vault 配置。

示例

CREATE DATABASE IF NOT EXISTS `db_test`
PROPERTIES (
    "storage_vault_name" = "hdfs_demo_vault"
);

可通过 ALTER-DATABASE 更改数据库的 storage_vault_name,更改仅对新建表生效,不影响已有表。

  • 从 3.0.5 版本起支持在建库时指定 Storage Vault。
  • 建表时 Storage Vault 的优先级(从高到低):表 → 数据库 → 默认 Storage Vault。
  • 若 Storage Vault 的 VAULT_NAME 被修改,可能导致数据库配置的 Vault 失效并报错,需为数据库重新配置有效的 storage_vault_name。

修改 Storage Vault

ALTER STORAGE VAULT 用于更新 Storage Vault 的可修改属性。

可修改属性

S3 Storage Vault 支持修改的属性:

属性 说明
VAULT_NAME Vault 名称(重命名)
s3.access_key 访问密钥 ID
s3.secret_key 访问密钥 Secret
use_path_style 是否使用路径样式访问

HDFS Storage Vault 禁止修改的属性:

属性 原因
path_prefix 修改会导致历史数据路径不一致
fs.defaultFS 修改会导致无法访问已写入数据

更多属性说明,请参阅 CREATE-STORAGE-VAULT。

示例

修改 S3 Storage Vault:

ALTER STORAGE VAULT old_s3_vault
PROPERTIES (
    "type"           = "S3",
    "VAULT_NAME"     = "new_s3_vault",
    "s3.access_key"  = "new_ak",
    "s3.secret_key"  = "new_sk"
);

修改 HDFS Storage Vault:

ALTER STORAGE VAULT old_hdfs_vault
PROPERTIES (
    "type"             = "hdfs",
    "VAULT_NAME"       = "new_hdfs_vault",
    "hadoop.username"  = "hdfs"
);

删除 Storage Vault

暂不支持删除 Storage Vault。

Storage Vault 权限管理

Admin 用户可向指定 MySQL 用户或角色授予 Storage Vault 的使用权限,控制哪些用户可以在建表时引用该 Vault 或查看其信息。

拥有某个 Storage Vault USAGE_PRIV 权限的用户/角色,可执行以下操作:

  • 通过 SHOW STORAGE VAULTS 查看该 Storage Vault 的信息
  • 建表时在 PROPERTIES 中指定使用该 Storage Vault

授予权限

语法

GRANT
    USAGE_PRIV
    ON STORAGE VAULT <vault_name>
    TO { ROLE | USER } {<role> | <user>}

示例

GRANT USAGE_PRIV ON STORAGE VAULT my_storage_vault TO USER user1;

撤销权限

语法

REVOKE
    USAGE_PRIV
    ON STORAGE VAULT <vault_name>
    FROM { ROLE | USER } {<role> | <user>}

示例

REVOKE USAGE_PRIV ON STORAGE VAULT my_storage_vault FROM USER user1;

常见问题

Q1:如何查询某个 Storage Vault 被哪些表引用?

步骤一:通过 SHOW STORAGE VAULTS 查看目标 Storage Vault 对应的 storage_vault_id。

步骤二:执行以下 SQL 查询引用该 Vault 的表,将 PROPERTY_VALUE=3 替换为实际的 storage_vault_id 值:

SELECT *
FROM information_schema.table_properties
WHERE PROPERTY_NAME = "storage_vault_id"
  AND PROPERTY_VALUE = 3;

查询结果示例:

+---------------+---------------------------------+-------------------------------------+------------------+----------------+
| TABLE_CATALOG | TABLE_SCHEMA                    | TABLE_NAME                          | PROPERTY_NAME    | PROPERTY_VALUE |
+---------------+---------------------------------+-------------------------------------+------------------+----------------+
| internal      | regression_test_vault_p0_create | s3_92ba28c209154d968e680e58dd54d0cc | storage_vault_id | 3              |
+---------------+---------------------------------+-------------------------------------+------------------+----------------+
1 row in set (0.04 sec)

Q2:建表后能否更换 Storage Vault?

不支持。建表成功后,该表的 storage_vault 属性不可修改。如需使用不同的 Storage Vault,需要重新建表并导入数据。

Q3:修改 Storage Vault 名称后,原来引用该 Vault 的数据库会受影响吗?

会受影响。若 Storage Vault 的 VAULT_NAME 被修改,数据库级别的 storage_vault_name 配置可能失效,导致在该数据库下新建表时报错。需要通过 ALTER-DATABASE 重新为数据库指定有效的 storage_vault_name。

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。