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

Статья создана

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

Managed Service for ClickHouse позволяет управлять базами данных кластера двумя способами:

С помощью стандартных интерфейсов Yandex Cloud (CLI, API, консоль управления). Способ подходит, если вы хотите создавать и удалять базы данных кластера, используя возможности сервиса Yandex Managed Service for ClickHouse.
С помощью SQL-запросов к кластеру. Способ подходит, если вы хотите использовать уже существующее у вас решение для создания и управления базами данных или если вам требуется поддержка MySQL баз данных в Managed Service for ClickHouse.

Управление базами данных через SQL

Чтобы включить управление, выберите опции Управление пользователями через SQL и Управление базами данных через SQL при создании или изменении настроек кластера.

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

Управление базами данных и пользователями через стандартные интерфейсы Yandex Cloud (CLI, API, консоль управления) недоступно.
Невозможно включить управление пользователями и базами данных с помощью стандартных интерфейсов Yandex Cloud.
Существующие пользователи, настройки пользователей и базы данных, созданные с помощью стандартных интерфейсов Yandex Cloud, будут сохранены.
Управление осуществляется с помощью учетной записи admin. Пароль для нее задается при выборе опций Управление пользователями через SQL и Управление базами данных через SQL.

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

Консоль управления

CLI

API

SQL

В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера, затем выберите вкладку Базы данных.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

yc managed-clickhouse database list
  --cluster-name=<имя кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

Получить список баз данных кластера можно с помощью метода list.

Подключитесь к кластеру, используя учетную запись admin.
Получите список баз данных:
```
SHOW DATABASES;
```

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

Количество баз данных в кластере неограниченно.

Консоль управления

CLI

Terraform

API

SQL

В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера.
Выберите вкладку Базы данных.
Нажмите кнопку Добавить.
Введите имя для базы данных и нажмите кнопку Добавить.

Примечание

Имя базы может содержать латинские буквы, цифры и нижнее подчеркивание. Максимальная длина имени 63 символа. Запрещено создание базы данных с именем default.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

Выполните команду создания БД, задав имя новой базы:

yc managed-clickhouse database create <имя базы данных> \
  --cluster-name <имя кластера>

Managed Service for ClickHouse запустит операцию создания базы данных.

Примечание

Имя кластера можно запросить со списком кластеров в каталоге.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.
Добавьте к описанию кластера Managed Service for ClickHouse блок описания базы данных database:
```
resource "yandex_mdb_clickhouse_cluster" "<имя кластера>" {
  ...
  database {
    name = "<имя базы данных>"
  }
}
```
Примечание

Имя базы может содержать латинские буквы, цифры и нижнее подчеркивание. Максимальная длина имени 63 символа. Запрещено создание базы данных с именем default.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

Создать новую базу данных в кластере можно с помощью метода create.

Подключитесь к кластеру, используя учетную запись admin.
Создайте базу данных:
```
CREATE DATABASE <имя базы данных>;
```
Примечание

Имя базы может содержать латинские буквы, цифры и нижнее подчеркивание. Максимальная длина имени 63 символа. Запрещено создание базы данных с именем default.

Подробнее о создании баз данных см. в документации ClickHouse.

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

Консоль управления

CLI

Terraform

API

SQL

В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера и выберите вкладку Базы данных.
Нажмите значок в строке нужной БД и выберите пункт Удалить.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

Чтобы удалить базу данных, выполните команду:

yc managed-clickhouse database delete <имя базы данных>
  --cluster-name=<имя кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.
Удалите из описания кластера Managed Service for ClickHouse блок database с описанием базы данных.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

Удалить базу данных можно с помощью метода delete.

Подключитесь к кластеру, используя учетную запись admin.

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

DROP DATABASE <имя базы данных>;

Подробнее об удалении объектов см. в документации ClickHouse.

Важно

Прежде чем создать новую базу с тем же именем, дождитесь завершения операции удаления, иначе будет восстановлена удаляемая база. Статус операции можно получить вместе со списком операций в кластере.

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

Управление базами данных через SQL

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

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

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

Была ли статья полезна?