CREATE FILE

description

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

4. 该命令只用 admin 权限用户可以执行。
5. 某个文件都归属与某一个的 database。对 database 拥有访问权限的用户都可以使用该文件。

7. 单个文件大小限制为 1MB。
8. 一个 Doris 集群最多上传 100 个文件。

10. 语法：

12. CREATE FILE "file_name" [IN database]
13. [properties]

15. 说明：
16. file_name:  自定义文件名。
17. database: 文件归属于某一个 db，如果没有指定，则使用当前 session 的 db。
18. properties 支持以下参数:

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

example

1. 1. 创建文件 ca.pem ，分类为 kafka

3. CREATE FILE "ca.pem"
4. PROPERTIES
5. (
6. "url" = "https://test.bj.bcebos.com/kafka-key/ca.pem",
7. "catalog" = "kafka"
8. );

10. 2. 创建文件 client.key，分类为 my_catalog

12. CREATE FILE "client.key"
13. IN my_database
14. PROPERTIES
15. (
16. "url" = "https://test.bj.bcebos.com/kafka-key/client.key",
17. "catalog" = "my_catalog",
18. "md5" = "b5bb901bf10f99205b39a46ac3557dd9"
19. );

keyword

1. CREATE,FILE