Подключиться
Yandex Managed Service for ClickHouse

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

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

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

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

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

  • Управление пользователями через SQL.
  • Управление базами данных через SQL.

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

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

Внимание

Настройки Управление пользователями через SQL и Управление базами данных через SQL невозможно изменить после создания кластера!

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

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

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

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

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

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

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

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

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

  2. Получите список баз данных:

    SHOW DATABASES;

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

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

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

Примечание

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

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

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

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

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

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

Примечание

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

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

Чтобы создать базу данных в кластере:

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

    О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.

  2. Добавьте к описанию кластера Managed Service for ClickHouse блок описания базы данных database:

    resource "yandex_mdb_clickhouse_cluster" "<имя кластера>" {
  ...
  database {
    name = "<имя базы данных>"
  }
}

    Примечание

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

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором вы создали конфигурационный файл.

    2. Выполните проверку с помощью команды:

      terraform plan

    Если конфигурация описана верно, в терминале отобразится список изменяемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет. Это проверочный этап: ресурсы не будут изменены.

  4. Подтвердите изменение ресурсов.

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

    2. Подтвердите изменение ресурсов.

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

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

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

  2. Создайте базу данных:

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

    Примечание

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

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

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

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

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

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

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

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

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

Чтобы удалить базу данных из кластера:

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

    О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.

  2. Удалите из описания кластера Managed Service for ClickHouse блок database с описанием базы данных.

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором вы создали конфигурационный файл.

    2. Выполните проверку с помощью команды:

      terraform plan

    Если конфигурация описана верно, в терминале отобразится список изменяемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет. Это проверочный этап: ресурсы не будут изменены.

  4. Подтвердите изменение ресурсов.

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

    2. Подтвердите изменение ресурсов.

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

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

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

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

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

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

Важно

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

В этой статье: