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

Apache Doris 中文参考:CREATE FILE

· 52CE 我爱测

该语句用于创建并上传一个文件到 Doris 集群。 该功能通常用于管理一些其他命令中需要使用到的文件,如证书、公钥私钥等等。

描述

该语句用于创建并上传一个文件到 Doris 集群。 该功能通常用于管理一些其他命令中需要使用到的文件,如证书、公钥私钥等等。

语法

CREATE FILE <file_name>
        [ { FROM | IN } <database_name>] PROPERTIES ("<key>"="<value>" [ , ... ]);

必选参数

1. <file_name>

自定义文件名。

2. <key>

文件的属性名。

  • url:必须。指定一个文件的下载路径。当前仅支持无认证的 http 下载路径。命令执行成功后,文件将被保存在 doris 中,该 url 将不再需要。
  • catalog:必须。对文件的分类名,可以自定义。但在某些命令中,会查找指定 catalog 中的文件。比如例行导入中的,数据源为 kafka 时,会查找 catalog 名为 kafka 下的文件。
  • md5: 可选。文件的 md5。如果指定,会在下载文件后进行校验。

2. <value>

文件的属性值。

可选参数

1. <database_name>

文件归属于某一个 database,如果没有指定,则使用当前 session 的 database。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限(Privilege) 对象(Object) 说明(Notes)
ADMIN_PRIV 用户(User)或 角色(Role) 用户或者角色拥有 ADMIN_PRIV 权限才能执行

注意事项

  • 文件的访问规则

某个文件都归属于某一个特定的 database,对 database 拥有访问权限的用户都可以使用该文件。

  • 文件大小和数量限制

这个功能主要用于管理一些证书等小文件。因此单个文件大小限制为 1MB。一个 Doris 集群最多上传 100 个文件。

示例

  • 创建文件 ca.pem,分类为 kafka

    CREATE FILE "ca.pem"
    PROPERTIES
    (
       "url" = "https://test.bj.bcebos.com/kafka-key/ca.pem",
       "catalog" = "kafka"
    );
    
  • 创建文件 client.key,分类为 my_catalog

    CREATE FILE "client.key"
    IN my_database
    PROPERTIES
    (
       "url" = "https://test.bj.bcebos.com/kafka-key/client.key",
       "catalog" = "my_catalog",
       "md5" = "b5bb901bf10f99205b39a46ac3557dd9"
    );
    
  • 创建文件 client_1.key,分类为 my_catalog

    CREATE FILE "client_1.key"
    FROM my_database
    PROPERTIES
    (
       "url" = "https://test.bj.bcebos.com/kafka-key/client.key",
       "catalog" = "my_catalog",
       "md5" = "b5bb901bf10f99205b39a46ac3557dd9"
    );
    

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

资料来源与适用范围

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

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

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