CREATE SCHEMA#

Синтаксис#

CREATE SCHEMA [ IF NOT EXISTS ] schema_name
[ AUTHORIZATION ( user | USER user | ROLE role ) ]
[ WITH ( property_name = expression [, ...] ) ]

Описание#

Создает новую пустую схему. Схема - это логический контейнер, содержащий таблицы, представления и другие объекты базы данных.

Необязательное выражение IF NOT EXISTS позволяет завершить выполнение команды без ошибки, если схема уже существует. Существующая схема при этом не будет пересоздана.

Необязательное выражение AUTHORIZATION можно использовать для установки владельца схемы. Владельцем может быть указан пользователь или роль. Поддержка задания владельца схемы зависит от каталога.

Необязательное выражение WITH можно использовать для установки свойств создаваемой схемы. Список доступных свойств зависит от каталога. Чтобы получить список всех доступных свойств схемы для всех каталогов, выполните следующий запрос:

SELECT * FROM system.metadata.schema_properties

Запрос может вернуть пустой результат, если ни один из сконфигурированных каталогов не имеет доступных свойств схемы.

Примеры#

Создает новую схему web в текущем каталоге:

CREATE SCHEMA web;

Создает новую схему sales в каталоге hive:

CREATE SCHEMA hive.sales;

Создает схему traffic, если она еще не существует:

CREATE SCHEMA IF NOT EXISTS traffic;

Создает новую схему web и устанавливает владельцем пользователя alice:

CREATE SCHEMA web AUTHORIZATION alice;

Создает новую схему web, устанавливает для свойства LOCATION значение /hive/data/web и делает владельцем схемы пользователя alice:

CREATE SCHEMA web AUTHORIZATION alice WITH (LOCATION = '/hive/data/web');

Создает новую схему web и устанавливает владельцем роль PUBLIC:

CREATE SCHEMA web AUTHORIZATION ROLE PUBLIC;

Создает новую схему web, устанавливает для свойства LOCATION значение /hive/data/web и устанавливает владельцем роль PUBLIC:

CREATE SCHEMA web AUTHORIZATION ROLE PUBLIC WITH (LOCATION = '/hive/data/web');

См. также#

ALTER SCHEMA, DROP SCHEMA, SHOW SCHEMAS, SHOW CREATE SCHEMA