Управление базой данных

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

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

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

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

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

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

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

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

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

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

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

1
SELECT * FROM system.databases WHERE name = '<имя базы данных>';

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

Создать базу данных

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

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

Подключитесь к кластеру.
Выполните запрос:
sql
```
1
CREATE DATABASE IF NOT EXISTS <имя базы данных>
2
ENGINE = <движок>
3
COMMENT '<комментарий>';
```
Условия в запросе:
- IF NOT EXISTS — предотвращает ошибку, если база данных с таким именем уже существует.
- ENGINE — задает тип движка базы данных. По умолчанию выбирается движок Atomic.
- COMMENT — комментарий.

Удалить базу данных

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

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

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

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