ALTER VOLUME

修改 Volume 的属性或刷新 Volume 的文件目录元数据。

语法

ALTER VOLUME [schema_name.]<volume_name> REFRESH;

参数说明

参数说明
schema_name
schema_name
所属 schema 名称,省略时使用当前 schema
volume_name
volume_name
要修改的 Volume 名称
REFRESH
REFRESH
重新扫描外部存储路径,更新 Volume 的文件目录元数据

使用示例

  1. 手动刷新 External Volume 的文件元数据:

ALTER VOLUME my_oss_vol REFRESH;

  1. 指定 schema 刷新 Volume:

ALTER VOLUME my_schema.my_oss_vol REFRESH;

注意事项

  • REFRESH
    REFRESH
    操作仅适用于 External Volume(挂载外部存储),Named Volume(内部存储)不需要刷新
  • 当外部对象存储中的文件发生新增、删除或变更时,需执行
    REFRESH
    REFRESH
    使 Lakehouse 感知最新文件列表
  • 如果
    DIRECTORY.auto_refresh = true
    DIRECTORY.auto_refresh = true
    ,系统会自动刷新,无需手动执行

权限要求

权限说明
ALTER VOLUME
ALTER VOLUME
修改 Volume 属性(如执行 REFRESH)

相关文档

联系我们
预约咨询
微信咨询
电话咨询