mariadb Командная строка

mariadb — это простая оболочка SQL (с возможностями GNU readline).

Описание командной строки mariadb

mariadb поддерживает интерактивное и неинтерактивное использование. При интерактивном использовании результаты запросов представляются в формате ASCII-таблицы. При неинтерактивном использовании (например, в качестве фильтра) результат представляется в формате, разделенном табуляцией. Формат вывода можно изменить с помощью командных опций.

Если у вас проблемы из-за недостаточной памяти для больших наборов результатов, используйте опцию --quick. Это заставляет mariadb извлекать результаты с сервера по строкам, а не извлекать весь набор результатов и буферизовать его в памяти перед отображением. Это делается путем возвращения набора результатов с помощью функции mysql_use_result() API C в библиотеке клиент/сервер, а не mysql_store_result().

Использование mariadb очень просто. Вызовите его из командной строки следующим образом:

mariadb db_name

Или:

mariadb --user=user_name --password=your_password db_name

Затем введите оператор SQL, завершите его “;”, \g или \G и нажмите Enter.

Нажатие клавиш Control-C заставляет mariadb попытаться прервать текущее оператор. Если это невозможно сделать, или нажатие Control-C повторено до завершения прерывания оператора, mariadb завершит работу.

Вы можете выполнить операторы SQL в файле скрипта (файле пакетных заданий) так:

mariadb db_name < script.sql > output.tab

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

Команда для использования mariadb и общий синтаксис:

mariadb <options>

Опции

mariadb поддерживает следующие опции:

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

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

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

mariadb связан с MariaDB Connector/C. Однако MariaDB Connector/C пока не поддерживает разбор файлов параметров для этого клиента. Это всё ещё выполняется кодом разбора файлов параметров сервера. Дополнительная информация в MDEV-19035.

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

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

Как указать используемый протокол при подключении к серверу

Вы можете принудительно указать используемый протокол для подключения к серверу mariadbd , задав параметру protocol одно из следующих значений: tcp, socket, pipe или memory.

Если protocol не указан, до MariaDB 10.6.1, параметры подключения командной строки, которые не принуждают протокол, игнорируются.

Начиная с MariaDB 10.6.1, параметр подключения, указанный в командной строке (например, --port=3306), будет принудительно устанавливать свой тип. Используется протокол, соответствующий параметру подключения, например, при указании --port создаётся TCP/IP-соединение.

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

Linux/Unix

• Если hostname не указан или hostname имеет значение localhost, используются Unix-сокеты.
• В других случаях (если задан hostname и он не равен localhost) используется TCP/IP-соединение через параметр port.

Обратите внимание, что localhost — специальное значение. Использование 127.0.0.1 не эквивалентно этому. Последнее подключится к серверу mariadbd через TCP/IP.

Windows

• Если shared-memory-base-name указан, и hostname не указан или hostname имеет значение localhost, подключение произойдёт через общую память.
• Если shared-memory-base-name не указан и hostname не указан или hostname имеет значение localhost, подключение произойдёт через именованные каналы Windows.
• Именованные каналы также будут использоваться, если библиотека клиента libmysql / libmariadb обнаружит, что клиент не поддерживает TCP/IP.
• В остальных случаях используется TCP/IP-соединение через параметр port.

Как проверить используемый протокол

Команда status отображает информацию об используемом протоколе:

shell> mariadb test

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 10
Server version: 10.2.2-MariaDB-valgrind-max-debug Source distribution

Copyright (c) 2000, 2016, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [test]> status;
--------------
mysql  Ver 15.1 Distrib 10.0.25-MariaDB, for Linux (x86_64) using readline 5.2

Connection id:          10
Current database:       test
Current user:           monty@localhost
...
Connection:             Localhost via UNIX socket
...
UNIX socket:            /tmp/mysql-dbug.sock

Команды mariadb

Также существует ряд команд, которые можно выполнить внутри клиента. Обратите внимание, что все текстовые команды должны стоять в начале строки и заканчиваться ";"

Файл mysql_history

В Unix, клиент mariadb записывает историю выполненных команд в файл истории. По умолчанию, этот файл называется .mysql_history и создаётся в вашем домашнем каталоге. Чтобы указать другой файл, установите значение переменной среды MYSQL_HISTFILE.

Файл .mysql_history должен быть защищён с ограниченным режимом доступа, поскольку в него может быть записана чувствительная информация, например, текст SQL-команд, содержащих пароли.

Если вы не хотите сохранять историю, сначала удалите .mysql_history, если он существует, а затем используйте один из следующих способов:

• Установите переменную MYSQL_HISTFILE в /dev/null. Чтобы это значение применялось каждый раз при входе в систему, поместите его в один из файлов запуска вашей оболочки.
• Создайте .mysql_history как символическую ссылку на /dev/null:

shell> ln -s /dev/null $HOME/.mysql_history

Это нужно сделать только один раз.

Команда prompt

Команда prompt переконфигурирует стандартный prompt \N [\d]>. Строка для определения prompt может содержать следующие специальные последовательности.

Советы по работе с mariadb

В этом разделе описаны некоторые приёмы, которые помогут вам эффективнее использовать mariadb.

Отображение результатов запроса вертикально

Результаты некоторых запросов намного удобнее читать в вертикальном формате, вместо обычной горизонтальной таблицы. Запросы можно отобразить вертикально, завершив их символом \G вместо точки с запятой. Например, значения длинных текстов, содержащие новые строки, часто намного легче читать с вертикальным выводом:

mariadb> SELECT * FROM mails WHERE LENGTH(txt) < 300 LIMIT 300,1\G
*************************** 1. row ***************************
  msg_nro: 3068
    date: 2000-03-01 23:29:50
time_zone: +0200
mail_from: Monty
    reply: monty@no.spam.com
  mail_to: "Thimble Smith" <tim@no.spam.com>
      sbj: UTF-8
      txt: >>>>> "Thimble" == Thimble Smith writes:
Thimble> Hi.  I think this is a good idea.  Is anyone familiar
Thimble> with UTF-8 or Unicode? Otherwise, I´ll put this on my
Thimble> TODO list and see what happens.
Yes, please do that.
Regards,
Monty
    file: inbox-jani-1
    hash: 190402944
1 row in set (0.09 sec)

Использование параметра --safe-updates

Для начинающих полезным параметром запуска является --safe-updates (или --i-am-a-dummy, что дает тот же эффект). Он полезен в ситуациях, когда вы, возможно, выполнили оператор DELETE FROM tbl_name , но забыли WHERE оператор. Обычно такой оператор удаляет все строки из таблицы. С помощью --safe-updates, вы можете удалять строки только, указывая значения ключей, которые их идентифицируют. Это помогает предотвратить ошибки.

При использовании опции --safe-updates, mariadb выполняет следующий оператор при подключении к серверу MariaDB:

SET sql_safe_updates=1, sql_select_limit=1000, sql_max_join_size=1000000;

Оператор SET имеет следующие эффекты:

• Вам запрещено выполнять оператор UPDATE или DELETE, если вы не укажете ограничение ключа в условии WHERE или не предоставите условие LIMIT (или оба). Например:

UPDATE tbl_name SET not_key_column=val WHERE key_column=val;
UPDATE tbl_name SET not_key_column=val LIMIT 1;

• Сервер ограничивает все большиеSELECT результаты 1000 строками, если оператор не содержит LIMIT условия.
• Сервер прерывает операторы с несколькими таблицами SELECT , которые, вероятно, должны просмотреть более 1 000 000 комбинаций строк.

Для задания пределов, отличных от 1000 и 1 000 000, вы можете переопределить значения по умолчанию, используя опции --select_limit и --max_join_size.

mariadb --safe-updates --select_limit=500 --max_join_size=10000

Отключение автоматического переподключения mariadb

Если клиент mariadb теряет подключение к серверу во время отправки оператора, он немедленно и автоматически пытается подключиться к серверу один раз и снова отправить оператор. Однако даже если mariadb успешно переподключится, ваше первое подключение завершено, и все ваши предыдущие объекты сеанса и настройки потеряны: временные таблицы, режим автозавершения и пользовательские и сеансовые переменные. Также любые текущие транзакции отменяются. Это поведение может быть опасным, как показано в следующем примере, где сервер был выключен и перезапущен между первым и вторым операторами без вашего ведома:

mariadb> SET @a=1;
Query OK, 0 rows affected (0.05 sec)
mariadb> INSERT INTO t VALUES(@a);
ERROR 2006: MySQL server has gone away
No connection. Trying to reconnect...
Connection id:    1
Current database: test
Query OK, 1 row affected (1.30 sec)
mariadb> SELECT * FROM t;
+------+
| a    |
+------+
| NULL |
+------+

Переменная пользователя @a была потеряна вместе с подключением, и после переподключения она не определена. Если важно, чтобы mariadb завершился с ошибкой, если подключение было потеряно, вы можете запустить клиент mariadb с опцией --skip-reconnect.

См. также

• Устранение неполадок при подключении
• Команды и настройка readline