mariadb-install-db

mariadb-install-db инициализирует каталог данных MariaDB и создаёт системные таблицы в базе данных mysql, если они не существуют. MariaDB использует эти таблицы для управления привилегиями, ролями и плагинами. Также они используются для предоставления данных для команды help в клиенте mariadb.

mariadb-install-db работает, запуская процесс mysqld сервера MariaDB в режиме --bootstrap и отправляя команды для создания системных таблиц и их содержимого.

Использование mariadb-install-db

Для вызова mariadb-install-db используйте следующий синтаксис:

$ mariadb-install-db [options]

Поскольку сервер MariaDB, mysqld, позже должен получить доступ к каталогу данных, вам следует запустить mariadb-install-db от того же пользователя, который будет использоваться для запуска mysqld, или запустить его как root и использовать опцию --user для указания имени пользователя, от которого будет работать mysqld. Возможно, потребуется указать другие опции, такие как --basedir или --datadir, если mariadb-install-db не использует правильные расположения для каталога установки или каталога данных. Например:

$ scripts/mariadb-install-db --user=mysql \
   --basedir=/opt/mysql/mysql \
   --datadir=/opt/mysql/mysql/data

Параметры

mariadb-install-db поддерживает следующие параметры:

Файлы параметров

В дополнение к чтению параметров из командной строки, mariadb-install-db также может читать параметры из файлов параметров. Если в файле параметров будет предоставлен неизвестный параметр для mariadb-install-db, он будет проигнорирован.

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

Группы параметров

mariadb-install-db читает параметры из следующих групп параметров из файлов параметров:

mariadb-install-db также считывает параметры из следующих групп параметров сервера из файлов параметров:

Установка системных таблиц

Установка системных таблиц из исходного дерева

Если вы только что скомпилировали MariaDB из исходного кода и хотите использовать mariadb-install-db из вашего исходного дерева, это можно сделать, не устанавливая сам MariaDB. Это очень полезно, если вы хотите протестировать свои изменения в MariaDB, не затрагивая существующие установки.

Для этого необходимо указать параметр --srcdir. Например:

./scripts/mariadb-install-db --srcdir=. --datadir=path-to-temporary-data-dir

Установка системных таблиц из двоичного архива

Если вы установили пакет двоичного архива в нестандартном пути, например, в домашнем каталоге, и у вас уже установлен пакет MariaDB / MySQL, могут возникнуть конфликты с параметрами по умолчанию /etc/my.cnf. Это часто приводит к ошибкам прав доступа.

Возможным решением является использование параметра --no-defaults, чтобы не считывать файлы конфигурации

./scripts/mariadb-install-db --no-defaults --basedir=. --datadir=data

./scripts/mariadb-install-db --no-defaults --basedir=. --datadir=data

Другим возможным решением является использование параметра defaults-file, чтобы указать свой собственный файл конфигурации

./scripts/mariadb-install-db --defaults-file=~/.my.cnf

Пользовательские учётные записи, созданные по умолчанию

CREATE USER 'root'@'localhost' IDENTIFIED VIA unix_socket 
  OR mysql_native_password USING 'invalid';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
GRANT PROXY ON ''@'%' TO 'root'@'localhost' WITH GRANT OPTION;

CREATE USER 'mysql'@'localhost' IDENTIFIED VIA unix_socket 
  OR mysql_native_password USING 'invalid';
GRANT ALL PRIVILEGES ON *.* TO 'mysql'@'localhost' WITH GRANT OPTION;

$ sudo yum install MariaDB-server
$ sudo systemctl start mariadb
$ sudo mariadb
...
MariaDB> SET PASSWORD = PASSWORD('XH4VmT3_jt');

CREATE USER 'root'@'localhost';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
GRANT PROXY ON ''@'%' TO 'root'@'localhost' WITH GRANT OPTION;

$ sudo yum install MariaDB-server
$ sudo systemctl start mariadb
$ mysql -u root
...
MariaDB> SET PASSWORD = PASSWORD('XH4VmT3_jt');

Устранение проблем

Проверка файла журнала ошибок

Если mariadb-install-db завершится неудачно, необходимо проверить файл журнала ошибок error log в каталоге данных, указанном параметром --datadir. Это должно помочь выявить причину ошибки.

Тестирование с mysqld

Также можно проверить, что это не общая ошибка сервера MariaDB, запустив процесс mysqld. Параметр -skip-grant-tables указывает ему пропустить проверку таблиц системных таблиц. Включение журнала запросов поможет определить, какие запросы выполняются на сервере. Например:

mysqld --skip-grant-tables --general-log

В этот момент можно использовать клиент mariadb для подключения к базе данных mysql и просмотра системных таблиц. Например:

$ /usr/local/mysql/bin/mysql -u root mysql
MariaDB [mysql]> show tables

Использование сервера, скомпилированного с --disable-grant-options

Следующее применимо только в том исключительном случае, если вы используете сервер mysqld, настроенный с параметром --disable-grant-options:

mariadb-install-db необходимо вызвать mysqld с параметрами --bootstrap и --skip-grant-tables. MariaDB, скомпилированный с параметром --disable-grant-options, имеет параметры --bootstrap и --skip-grant-tables отключены. Для решения этой проблемы установите переменную среды MYSQLD_BOOTSTRAP в полном пути к серверу mysqld, настроенному без --disable-grant-options. mariadb-install-db будет использовать этот сервер.

Базы данных test и test_%

При вызове скрипта mariadb-install-db в каталоге данных создается новый каталог test. В нём находится единственный файл db.opt, который устанавливает параметры клиента default-character-set и default-collation.

Если запустить mysql как анонимный пользователь mysql -u''@localhost и посмотреть на предоставленные права и доступные базы данных, вы получите следующее:

SELECT current_user;
+--------------+
| current_user |
+--------------+
| @localhost   |
+--------------+

SHOW GRANTS FOR current_user;
+--------------------------------------+
| Grants for @localhost                |
+--------------------------------------+
| GRANT USAGE ON *.* TO ``@`localhost` |
+--------------------------------------+

SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| test               |
+--------------------+

Отображаются information_schema, а также test встроенных баз данных. Но при использовании SHOW GRANTS возникает парадокс: как текущий пользователь может видеть что-то, если у него нет прав?

Давайте пойдем дальше.
Теперь воспользуемся пользователем root/unix, у которого есть все права, чтобы создать новую базу данных с префиксом test_, например:

CREATE DATABASE test_electricity;

После внесения изменения в каталоге данных будет создан новый каталог.
Теперь снова войдите как анонимный пользователь и выполните SHOW DATABASES:

SHOW DATABASES
+--------------------+
| Database           |
+--------------------+
| information_schema |
| test               |
| test_electricity   |
+--------------------+

Мы снова можем видеть вновь созданную базу данных, не имея прав? У нас есть анонимный пользователь без прав, но он всё ещё может видеть базы данных test и test_electricity.
Откуда это?

Войдите как пользователем root/unix, чтобы узнать все права анонимного пользователя:

SELECT * FROM mysql.user WHERE user='' AND host='localhost'\G
*************************** 1. row ***************************
                  Host: localhost
                  User: 
              Password: 
           Select_priv: N
           Insert_priv: N
           Update_priv: N
           Delete_priv: N
           Create_priv: N
             Drop_priv: N
           Reload_priv: N
         Shutdown_priv: N
          Process_priv: N
             File_priv: N
            Grant_priv: N
       References_priv: N
            Index_priv: N
            Alter_priv: N
          Show_db_priv: N
            Super_priv: N
 Create_tmp_table_priv: N
      Lock_tables_priv: N
          Execute_priv: N
       Repl_slave_priv: N
      Repl_client_priv: N
      Create_view_priv: N
        Show_view_priv: N
   Create_routine_priv: N
    Alter_routine_priv: N
      Create_user_priv: N
            Event_priv: N
          Trigger_priv: N
Create_tablespace_priv: N
   Delete_history_priv: N
              ssl_type: 
            ssl_cipher: 
           x509_issuer: 
          x509_subject: 
         max_questions: 0
           max_updates: 0
       max_connections: 0
  max_user_connections: 0
                plugin: 
 authentication_string: 
      password_expired: N
               is_role: N
          default_role: 
    max_statement_time: 0.000000

Как видно из таблицы mysql.user, анонимный пользователь не имеет глобальных прав. Тем не менее, анонимный пользователь может видеть базы данных, поэтому должен быть способ, позволяющий анонимному пользователю видеть базы данных test и test_electricity.

Давайте проверим предоставленные права на уровне базы данных. Эта информация находится в таблице mysql.db. В таблице mysql.db уже содержатся 2 строки, созданные при вызове скрипта mariadb-install-db.

Анонимный пользователь имеет права доступа к базе данных (без grant, alter_routine и execute) в базах данных test и test_%:

SELECT * FROM mysql.db\G
*************************** 1. row ***************************
                 Host: %
                   Db: test
                 User: 
          Select_priv: Y
          Insert_priv: Y
          Update_priv: Y
          Delete_priv: Y
          Create_priv: Y
            Drop_priv: Y
           Grant_priv: N
      References_priv: Y
           Index_priv: Y
           Alter_priv: Y
Create_tmp_table_priv: Y
     Lock_tables_priv: Y
     Create_view_priv: Y
       Show_view_priv: Y
  Create_routine_priv: Y
   Alter_routine_priv: N
         Execute_priv: N
           Event_priv: Y
         Trigger_priv: Y
  Delete_history_priv: Y
*************************** 2. row ***************************
                 Host: %
                   Db: test\_%
                 User: 
          Select_priv: Y
          Insert_priv: Y
          Update_priv: Y
          Delete_priv: Y
          Create_priv: Y
            Drop_priv: Y
           Grant_priv: N
      References_priv: Y
           Index_priv: Y
           Alter_priv: Y
Create_tmp_table_priv: Y
     Lock_tables_priv: Y
     Create_view_priv: Y
       Show_view_priv: Y
  Create_routine_priv: Y
   Alter_routine_priv: N
         Execute_priv: N
           Event_priv: Y
         Trigger_priv: Y
  Delete_history_priv: Y

Первая строка зарезервирована для явного использования для базы данных test, которая автоматически создается с помощью mariadb-install-db.

Поскольку база данных test_electricity соответствует шаблону test_%, где test_ является префиксом, мы можем понять, почему пользователь имеет право работать с вновь созданной базой данных.

До тех пор, пока в mysql.db для анонимного пользователя существуют записи, каждый новый созданный пользователь будет иметь права доступа к базам данных test и test_%.

Права доступа к другим базам данных не предоставляются автоматически для нового созданного пользователя. Нам необходимо предоставить права, которые будут видны в таблице mysql.db.

Не создание тестовой базы данных и анонимного пользователя

Если вы запускаете mariadb-install-db с опцией --skip-test-db, база данных test не будет создана, что мы можем видеть следующим образом:

SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
+--------------------+

SELECT * FROM mysql.db;
Empty set (0.001 sec)

Также не создается анонимный пользователь (только пользователи unix/mariadb.sys/root):

SELECT user,host FROM mysql.user;
+-------------+-----------+
| User        | Host      |
+-------------+-----------+
| anel        | localhost |
| mariadb.sys | localhost |
| root        | localhost |
+-------------+-----------+

См. также

• Настройка MariaDB с поддержкой каталогов
• Установка системных таблиц (mariadb-install-db)
• Версия mariadb-install-db для Windows: mysql_install_db.exe