CREATE FILE

Вы можете выполнить оператор CREATE FILE для создания файла. После создания файл загружается и сохраняется в Selena. В базе данных только администратор может создавать и удалять файлы, а все пользователи, имеющие разрешение на доступ к базе данных, могут использовать файлы, принадлежащие этой базе данных.

подсказка

Эта операция требует привилегию FILE уровня SYSTEM. Вы можете следовать инструкциям в GRANT для предоставления этой привилегии.

Основные понятия

File: относится к файлу, который создается и сохраняется в Selena. После создания и сохранения файла в Selena, система присваивает файлу уникальный ID. Вы можете найти файл по имени базы данных, catalog и имени файла.

Синтаксис

CREATE FILE "file_name" [IN database]
[properties]

Параметры

Параметр	Обязательный	Описание
file_name	Да	Имя файла.
database	Нет	База данных, к которой принадлежит файл. Если вы не указываете этот параметр, он по умолчанию принимает имя базы данных, к которой вы обращаетесь в текущей сессии.
properties	Да	Свойства файла. В следующей таблице описаны элементы конфигурации properties.

Элементы конфигурации properties

Элемент конфигурации	Обязательный	Описание
url	Да	URL, с которого можно скачать файл. Поддерживается только HTTP URL без аутентификации. После сохранения файла в Selena URL больше не нужен.
catalog	Да	Категория, к которой принадлежит файл. Вы можете указать catalog в соответствии с вашими бизнес-требованиями. Однако в некоторых ситуациях необходимо установить этот параметр в определенный catalog. Например, если вы загружаете данные из Kafka, Selena ищет файлы в catalog из источника данных Kafka.
MD5	Нет	Алгоритм дайджеста сообщений, используемый для проверки файла. Если вы указываете этот параметр, Selena проверяет файл после его загрузки.

Примеры

• Создать файл с именем test.pem в категории kafka.

CREATE FILE "test.pem"
PROPERTIES
(
    "url" = "https://starrocks-public.oss-cn-xxxx.aliyuncs.com/key/test.pem",
    "catalog" = "kafka"
);

• Создать файл с именем client.key в категории my_catalog.

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