描述

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

语法

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

必选参数

1. <file_name>

自定义文件名。

2. <key>

文件的属性名。

• url：必须。指定一个文件的下载路径。当前仅支持无认证的 http 下载路径。命令执行成功后，文件将被保存在 PALO 中，该 url

1将不再需要。

• catalog：必须。对文件的分类名，可以自定义。但在某些命令中，会查找指定 catalog 中的文件。比如例行导入中的，数据源为 kafka

1时，会查找 catalog 名为 kafka 下的文件。

• md5: 可选。文件的 md5。如果指定，会在下载文件后进行校验。

2. <value>

文件的属性值。

可选参数

1. <database_name>

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

权限控制

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

注意事项

• 文件的访问规则

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

• 文件大小和数量限制

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

示例

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

  SQL 复制

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

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

  SQL 复制

  1CREATE FILE "client.key"
  2IN my_database
  3PROPERTIES
  4(
  5   "url" = "https://test.bj.bcebos.com/kafka-key/client.key",
  6   "catalog" = "my_catalog",
  7   "md5" = "b5bb901bf10f99205b39a46ac3557dd9"
  8);

• 创建文件 client_1.key，分类为 my_catalog

  SQL 复制

  1CREATE FILE "client_1.key"
  2FROM my_database
  3PROPERTIES
  4(
  5   "url" = "https://test.bj.bcebos.com/kafka-key/client.key",
  6   "catalog" = "my_catalog",
  7   "md5" = "b5bb901bf10f99205b39a46ac3557dd9"
  8);