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

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

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

Вы можете добавлять и удалять базы данных, просматривать информацию о них, а также управлять некоторыми настройками баз данных с помощью интерфейсов Managed Service for MySQL.

Важно

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

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

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

CLI

API

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

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

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

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

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

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

Воспользуйтесь методом API list и передайте идентификатор кластера в параметре clusterId запроса.

Идентификатор кластера можно получить со списком кластеров в каталоге.

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

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

Примечание

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

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

CLI

Terraform

API

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

Примечание

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

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

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

Посмотрите описание команды CLI для создания БД:
```
$ yc managed-mysql database create --help
```
Выполните команду создания БД:
```
$ yc managed-mysql database create <имя базы данных> --cluster-name=<имя кластера>
```
Примечание

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

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

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

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

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

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

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

Воспользуйтесь методом API create и передайте в запросе:

Идентификатор кластера, в котором вы хотите создать базу данных, в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
Имя базы данных в параметре databaseSpec.name.

Примечание

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

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

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

CLI

Terraform

API

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

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

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

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

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

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

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

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

Воспользуйтесь методом API delete и передайте в запросе:

Идентификатор кластера, в котором находится база данных, в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
Имя базы данных в параметре databaseName. Чтобы узнать имя базы данных, получите список баз данных в кластере.

Важно

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

Установить режим SQL

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

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

CLI

Terraform

API

Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.
Выберите кластер и нажмите кнопку Изменить кластер на панели сверху.
В блоке Настройки СУБД нажмите кнопку Настроить.
В списке настроек найдите параметр Sql mode.
Задайте набор режимов SQL с помощью выпадающего списка. Чтобы вернуть настройки по умолчанию, нажмите кнопку Сбросить.
Нажмите кнопку Сохранить в диалоговом окне настроек СУБД.
Нажмите кнопку Сохранить изменения.

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

Задайте нужные режимы SQL в значении параметра --set, например:

$ yc managed-mysql cluster update-config
     --name <имя кластера>
     --set '"sql_mode=NO_KEY_OPTIONS,NO_TABLE_OPTIONS"'

Обратите внимание на кавычки: значением параметра должна стать вся строка, включая часть sql_mode=.

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

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

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

Задайте нужные режимы SQL в значении параметра sql_mode блока mysql_config, например:

resource "yandex_mdb_mysql_cluster" "<имя кластера>" {
  ...
  mysql_config = {
    sql_mode = "<список режимов SQL>"
    ...
  }
}

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

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

Воспользуйтесь методом API update и передайте в запросе:

Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
Массив с новой конфигурацией MySQL в параметре:
- configSpec.mysqlConfig_5_7.sqlMode для MySQL версии 5.7.
- configSpec.mysqlConfig_8_0.sqlMode для MySQL версии 8.0.

Важно

Этот метод API сбросит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

Изменить набор символов и правила их сравнения

Чтобы установить настройки символов (CHARACTER SET, COLLATE) для базы данных:

Подключитесь к базе данных с помощью учетной записи ее владельца или пользователя с привилегией ALTER для этой базы данных.

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

ALTER DATABASE <имя БД> CHARACTER SET = 'utf8mb4' COLLATE = 'utf8mb4_unicode_ci';

Чтобы настройки изменились не только для самой базы данных, но и для таблиц в ней, сконвертируйте таблицы с теми же настройками:
```
ALTER TABLE <имя БД>.<имя таблицы> CONVERT TO CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_unicode_ci';
```

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

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

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

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

Установить режим SQL

Изменить набор символов и правила их сравнения

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