CREATE FILE

描述

该语句用于创建并上传一个文件到 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"
  );