Управление таблицами

В Managed ClickHouse управлять таблицами можно с помощью SQL-запросов. С полным списком SQL-операторов ClickHouse вы можете ознакомиться в официальной документации ClickHouse.

Получить список таблиц в базе данных

Запросите список таблиц из системной таблицы system.tables, которая содержит метаданные обо всех таблицах. Для этого используйте оператор SELECT и виртуальный движок clusterAllReplicas, который выполняет запрос к указанной таблице на всех узлах всех шардов заданного кластера.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Выполните запрос:

1
SELECT name AS таблица
2
FROM system.tables
3
WHERE database = '<имя базы данных>'
4
ORDER BY таблица;

В результате будет выведен список таблиц, которые содержатся в указанной базе данных.

Получить информацию о конкретной таблице

Запросите данные о таблице из системной таблицы system.tables по ее имени. Для этого используйте оператор SELECT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SELECT name AS таблица
2
FROM system.tables
3
WHERE database = '<имя базы данных>'
4
ORDER BY таблица;

Выполните запрос:

1
SELECT *
2
FROM system.tables
3
WHERE database = '<имя базы данных>'
4
  AND name = '<имя таблицы>';

В результате будут выведены метаданные и технические параметры таблицы.

Создать таблицу

Для создания таблицы используйте оператор CREATE.

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

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Выполните запрос:

1
CREATE TABLE [IF NOT EXISTS] <имя базы данных>.<имя таблицы>
2
(
3
    <имя столбца 1> <тип столбца 1> [COMMENT '<комментарий>'],
4
    <имя столбца 2> <тип столбца 2>,
5
    ...
6
)
7
ENGINE = <движок>
8
ORDER BY <столбец сортировки>
9
[COMMENT '<комментарий к таблице>']
10
[SETTINGS storage_policy = 'default'];  -- если используется гибридное хранилище

Условия в запросе:

IF NOT EXISTS — предотвращает ошибку, если таблица с таким именем уже существует.
ENGINE — задает тип движка.
ORDER BY — определяет столбец сортировки. Обязателен для движков семейства MergeTree.
COMMENT — комментарий.

Пример запроса:

1
CREATE TABLE IF NOT EXISTS my_database.my_table
2
(
3
    id UInt64 COMMENT 'Уникальный идентификатор',
4
    name String,
5
    created_at DateTime
6
)
7
ENGINE = MergeTree
8
ORDER BY id
9
COMMENT 'Таблица событий пользователей'
10
SETTINGS storage_policy = 'default';

Подключитесь к кластеру.
Узнайте имя базы данных:
sql
```
1
SELECT hostName() AS узел, name AS база_данных
2
FROM clusterAllReplicas('{cluster}', system.databases);
```
В запросе:
- Функция hostName() возвращает имена узлов. Имена узлов и баз данных будут записаны в столбцы с псевдонимами узел и база_данных.
- Имя кластера автоматически определяется макросом {cluster}, заданным в конфигурации.

Выполните запрос:

1
CREATE TABLE [IF NOT EXISTS] <имя базы данных>.<имя таблицы>
2
[ON CLUSTER '{cluster}']
3
(
4
    <имя столбца 1> <тип столбца 1> [COMMENT '<комментарий к столбцу>'],
5
    <имя столбца 2> <тип столбца 2>,
6
    ...
7
)
8
ENGINE = <движок>
9
ORDER BY <столбец сортировки>
10
[COMMENT '<комментарий к таблице>']
11
[SETTINGS storage_policy = 'default'];  -- если используется гибридное хранилище

Условия в запросе:

IF NOT EXISTS — предотвращает ошибку, если таблица с таким именем уже существует.
ON CLUSTER — создает таблицы на всех узлах заданного кластера.
ENGINE — задает тип движка.
ORDER BY — определяет столбец сортировки. Обязателен для движков семейства MergeTree.
COMMENT — комментарий.

Пример запроса:

1
CREATE TABLE IF NOT EXISTS my_database.my_table
2
ON CLUSTER '{cluster}'
3
(
4
    id UInt64 COMMENT 'Уникальный идентификатор',
5
    name String,
6
    created_at DateTime
7
)
8
ENGINE = MergeTree
9
ORDER BY id
10
COMMENT 'Таблица событий пользователей';

В ClickHouse доступны другие способы создания таблиц. Вы можете ознакомиться с ними в официальной документации ClickHouse.

Просмотреть структуру таблицы

Для просмотра используйте оператор DESCRIBE.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:

1
DESCRIBE TABLE <имя базы данных>.<имя таблицы>;

В результате будет выведен список столбцов таблицы с их типами.

Просмотреть все столбцы таблицы

Для просмотра используйте оператор SELECT.

Запросите данные о столбцах из системной таблицы system.columns по именам базы данных и таблицы.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:

1
SELECT name, type, default_expression
2
FROM system.columns
3
WHERE database = '<имя базы данных>' AND table = '<имя таблицы>';

В результате будет выведена подробная информация о столбцах таблицы: имя, тип и значение по умолчанию.

Просмотреть первые строки таблицы

Для просмотра используйте оператор SELECT.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Узнайте структуру таблицы:

1
DESCRIBE TABLE <имя базы данных>.<имя таблицы>;

Выполните запрос:
sql
```
1
SELECT <столбец 1>, <столбец 2>, ... FROM <имя базы данных>.<имя таблицы> LIMIT <число строк>;
```
Здесь условие LIMIT возвращает не более заданного количества найденных записей из таблицы.

Если нужно вывести данные из всех столбцов, используйте в запросе символ * вместо перечисления их имен.

Пример запроса:
sql
```
1
SELECT id, name, created_at FROM my_database.my_table LIMIT 7;
```

Просмотреть, как создавалась таблица

Для операции просмотра используйте оператор SHOW.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:

1
SHOW CREATE TABLE <имя базы данных>.<имя таблицы>;

В результате будет выведен полный SQL-запрос, которым была создана таблица.

Установить политику хранения default

Операция изменяет политику хранения существующей таблицы на default для использования гибридного хранилища. Чтобы изменить политику, используйте оператор ALTER TABLE … MODIFY SETTING.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:
sql
```
1
ALTER TABLE <имя базы данных>.<имя таблицы>
2
MODIFY SETTING storage_policy = 'default';
```
В запросе:
- MODIFY SETTING изменяет настройки таблицы.
- storage_policy = 'default' устанавливает политику хранения для гибридного хранилища.

В результате политика будет изменена для новых вставок.

Добавить или изменить правило TTL

Чтобы изменить правило автоматического переноса данных по времени, используйте оператор ALTER TABLE … MODIFY TTL. Новое правило будет применяться к существующим и новым частям данных.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:
sql
```
1
ALTER TABLE <имя базы данных>.<имя таблицы>
2
MODIFY TTL <выражение_времени> TO VOLUME 'cold';
```
Пример запроса:
sql
```
1
ALTER TABLE school.events
2
MODIFY TTL event_time + INTERVAL 90 DAY TO VOLUME 'cold';
```
В запросе и примере:
- MODIFY TTL — изменяет настройки TTL.
- event_time + INTERVAL 90 DAY — условие времени, через которое данные станут холодными.
- TO VOLUME 'cold' — указывает, что данные должны быть перемещены в том cold.

Удалить правило TTL

Чтобы удалить правило TTL, используйте оператор ALTER TABLE … REMOVE TTL. Части, уже перемещенные в холодное хранилище, не вернутся обратно автоматически. Их можно будет переместить только вручную.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:

1
ALTER TABLE <имя базы данных>.<имя таблицы> REMOVE TTL;

Принудительно применить правило TTL

По умолчанию TTL обрабатывается в фоновом режиме. Чтобы запустить немедленную обработку TTL для всех существующих данных, используйте оператор ALTER TABLE ... MATERIALIZE TTL.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:

1
ALTER TABLE <имя базы данных>.<имя таблицы> MATERIALIZE TTL;

Переместить данные вручную

Разовые команды MOVE PARTITION и MOVE PART позволяют переместить партицию или отдельную часть между томами hot и cold. Они не создают автоматического правила для будущих данных.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос.

Чтобы переместить партицию из горячего в холодное хранилище:
sql
```
1
ALTER TABLE <имя базы данных>.<имя таблицы>
2
MOVE PARTITION <партиция> TO VOLUME 'cold';
```
Чтобы переместить партицию из холодного в горячее хранилище:
sql
```
1
ALTER TABLE <имя базы данных>.<имя таблицы>
2
MOVE PARTITION <партиция> TO VOLUME 'hot';
```
Чтобы переместить конкретную часть из горячего в холодное хранилище:
sql
```
1
ALTER TABLE <имя базы данных>.<имя таблицы>
2
MOVE PART '<имя_части>' TO VOLUME 'cold';
```
Чтобы переместить конкретную часть из холодного в горячее хранилище:
sql
```
1
ALTER TABLE <имя базы данных>.<имя таблицы>
2
MOVE PART '<имя_части>' TO VOLUME 'hot';
```

В результате указанная партиция или часть будет немедленно перемещена в целевой том.

Проверить размещение данных

Чтобы убедиться, что данные распределены между горячим и холодным хранилищем, используйте системные таблицы system.tables, system.parts, system.disks и system.storage_policies.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос.

Чтобы посмотреть политику хранения таблицы:

1
SELECT database, table, storage_policy
2
FROM system.tables
3
WHERE database = '<имя базы данных>' AND table = '<имя таблицы>';

Чтобы посмотреть, на каких дисках лежат части:

1
SELECT partition, name, disk_name, formatReadableSize(bytes_on_disk) AS size
2
FROM system.parts
3
WHERE database = '<имя базы данных>' AND table = '<имя таблицы>' AND active
4
ORDER BY partition, name;

Чтобы получить все доступные диски и их типы:

1
SELECT name, type, path, formatReadableSize(free_space) AS free_space
2
FROM system.disks;

Чтобы получить информацию о политиках хранения:

1
SELECT policy_name, volume_name, disks, move_factor
2
FROM system.storage_policies;

Удалить таблицу

Для удаления таблицы используйте оператор DROP.

В standalone-кластере
В multi-node-кластере

Подключитесь к кластеру.

Узнайте имя базы данных:

1
SELECT name AS база_данных
2
FROM system.databases;

Узнайте имя таблицы:

1
SHOW TABLES FROM <имя базы данных>;

Выполните запрос:
sql
```
1
DROP TABLE [IF EXISTS] <имя базы данных>.<имя таблицы>;
```
В запросе условие IF EXISTS предотвращает ошибку, если таблица с таким именем не существует в указанной базе данных.

В результате таблица удалится вместе со всеми данными.