CREATE CATALOG#

Синтаксис#

CREATE CATALOG
catalog_name
USING connector_name
[ WITH ( property_name = expression [, ...] ) ]

Описание#

Создает новый каталог с использованием указанного коннектора.

Необязательное предложение WITH используется для задания свойств вновь созданного каталога. Имена свойств можно заключать в двойные кавычки; это обязательно, если они содержат специальные символы, например -. Список всех доступных свойств см. в документации коннекторов. Все значения свойств должны быть строками varchar в одинарных кавычках, включая числа и булевы значения.

Запрос завершается ошибкой в следующих случаях:

  • Отсутствует обязательное свойство.

  • Задано недопустимое свойство, например в имени свойства есть опечатка или использовано имя свойства от другого коннектора.

  • Значение свойства недопустимо, например числовое значение выходит за допустимый диапазон или строковое значение не соответствует требуемому шаблону.

  • Значение ссылается на переменную среды, которая не задана на узле coordinator.

Warning

Полный запрос CREATE CATALOG записывается в журнал и отображается в Web UI. Это включает любые чувствительные свойства, такие как пароли и другие учетные данные. См. Секреты.

Note

Для этой команды тип управления каталогами должен быть установлен в dynamic.

Примеры#

Создать новый каталог с именем tpch, используя TPC-H connector:

CREATE CATALOG tpch USING tpch;

Создать новый каталог с именем brain, используя Коннектор Memory:

CREATE CATALOG brain USING memory
WITH ("memory.max-data-per-node" = '128MB');

Обратите внимание, что свойство коннектора содержит дефисы (-) и должно быть заключено в двойные кавычки ("). Значение 128MB заключено в одинарные кавычки, поскольку это строковый литерал.

Создать новый каталог с именем example, используя Коннектор PostgreSQL:

CREATE CATALOG example USING postgresql
WITH (
  "connection-url" = 'jdbc:pg:localhost:5432',
  "connection-user" = '${ENV:POSTGRES_USER}',
  "connection-password" = '${ENV:POSTGRES_PASSWORD}',
  "case-insensitive-name-matching" = 'true'
);

В этом примере предполагается, что переменные среды POSTGRES_USER и POSTGRES_PASSWORD заданы как secrets на всех узлах кластера.

См. также#