Подключение к MariaDB

В этой статье рассматривается подключение к MariaDB и основные параметры подключения. Если вы новичок в MariaDB, сначала ознакомьтесь со статьей A MariaDB Primer.

Для подключения к серверу MariaDB программное обеспечение клиента должно предоставить правильные параметры подключения. Программное обеспечение клиента чаще всего будет клиентом mariadb, используемым для ввода инструкций из командной строки, но те же концепции применимы к любому клиенту, такому как графический клиент, клиент для выполнения резервных копий, например mariadb-dump, и т. д. В остальной части этой статьи предполагается, что используется командная строка mariadb.

Если параметр подключения не указан, он вернётся к значению по умолчанию.

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

mariadb

В этом случае применяются следующие значения по умолчанию:

• Имя хоста — localhost.
• Имя пользователя — либо ваше имя пользователя Unix, либо ODBC в Windows.
• Пароль не отправляется.
• Клиент подключится к серверу с использованием сокета по умолчанию, но не к какому-либо определённому база данных на сервере.

Эти значения по умолчанию можно переопределить, указав конкретный параметр. Например:

mariadb -h 166.78.144.191 -u username -ppassword database_name

В этом случае:

• -h указывает хост. Вместо использования localhost, используется IP 166.78.144.191.
• -u указывает имя пользователя, в данном случае username
• -p указывает пароль, password. Обратите внимание, что для паролей, в отличие от других параметров, не должно быть пробела между опцией (-p) и значением (password). Также небезопасно использовать пароль таким образом, так как другие пользователи системы могут увидеть его в составе выполненной команды. Если вы включите опцию -p, но опустите пароль, вас попросят его ввести, что более безопасно.
• Имя базы данных предоставляется в качестве первого аргумента после всех опций, в данном случае database_name.
• Подключение будет установлено через порт tcp_ip по умолчанию, 3306

Параметры подключения

host

--host=name
-h name

Подключение к серверу MariaDB на заданном хосте. Хост по умолчанию — localhost. По умолчанию MariaDB не разрешает удалённые подключения — см. Настройка MariaDB для удалённого доступа клиентов.

password

--password[=passwd]
-p[passwd]

Пароль учётной записи MariaDB. В целом, вводить пароль в командной строке небезопасно, так как другие пользователи системы могут увидеть его в составе выполненной команды. Если вы включите опцию -p или --password, но опустите пароль, вас попросят его ввести, что более безопасно.

pipe

--pipe
-W

На системах Windows, запущенных с опцией --enable-named-pipe, используйте эту опцию для подключения к серверу через именованную трубу.

port

--port=num
-P num

Номер порта TCP/IP для подключения. По умолчанию — 3306.

protocol

--protocol=name

Указывает протокол, используемый для подключения. Может быть одним из TCP, SOCKET, PIPE или MEMORY (регистр не учитывается). Обычно изменять это значение из значения по умолчанию не следует. Например, в Unix файловый сокет Unix (SOCKET) — это протокол по умолчанию и, как правило, обеспечивает самое быстрое подключение.

• TCP: TCP/IP-соединение с сервером (локальным или удалённым). Доступно на всех операционных системах.
• SOCKET: Соединение через файловый сокет Unix, доступное для локального сервера только на системах Unix. Если сокет не указан с помощью --socket, в файле конфигурации или с переменной среды MYSQL_UNIX_PORT, будет использоваться значение по умолчанию /tmp/mysql.sock.
• PIPE. Соединение через именованную трубу (локальное или удалённое). Доступно только в Windows.
• MEMORY. Соединение через общую память с локальным сервером только на системах Windows.

shared-memory-base-name

--shared-memory-base-name=name

Доступно только на системах Windows, на которых сервер запущен с опцией --shared-memory, это указывает имя общей памяти для подключения к локальному серверу. Значение чувствительно к регистру и по умолчанию равно MARIADB.

socket

--socket=name
-S name

Для подключений к localhost это указывает либо используемый файловый сокет Unix (по умолчанию /tmp/mysql.sock), либо, в Windows, где сервер запущен с опцией --enable-named-pipe, имя (регистронезависимое) именованной трубы для использования (по умолчанию MARIADB).

Параметры TLS

Ниже приведён краткий список. Подробную информацию см. в Обзоре безопасных подключений и Переменных системы TLS.

ssl

--ssl

Включить TLS для подключения (автоматически включено с другими флагами TLS). Выключить с помощью '--skip-ssl'

ssl-ca

--ssl-ca=name

Файл CA в формате PEM (см. документацию OpenSSL, подразумевает --ssl).

ssl-capath

--ssl-capath=name

ssl-cert

--ssl-cert=name

Сертификат X509 в формате PEM (подразумевает --ssl).

ssl-cipher

--ssl-cipher=name

Используемый шифр TLS (подразумевает --ssl).

ssl-key

--ssl-key=name

Ключ X509 в формате PEM (подразумевает --ssl).

ssl-crl

--ssl-crl=name

Список отозванных сертификатов (подразумевает --ssl).

ssl-crlpath

--ssl-crlpath=name

Путь к списку отозванных сертификатов (подразумевает --ssl).

ssl-verify-server-cert

--ssl-verify-server-cert

Проверка «общего имени» сертификата сервера относительно имени хоста, используемого при подключении. Эта опция отключена по умолчанию.

user

--user=name
-u name

Имя пользователя MariaDB, используемое при подключении к серверу. По умолчанию — либо ваше имя пользователя Unix, либо ODBC в Windows. Подробности о создании учётных записей пользователей MariaDB см. в команде GRANT.

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

Также можно использовать файлы параметров (или файлы конфигурации) для задания этих параметров. Большинство клиентов читают файлы параметров. Обычно при запуске клиента с опцией --help отображаются файлы, которые он ищет, а также группы параметров, которые он распознаёт.

См. также

• A MariaDB Primer
• клиент mariadb
• Клиенты и утилиты
• Настройка MariaDB для удалённого доступа клиентов
• --skip-grant-tables позволяет запустить MariaDB без GRANT. Это полезно, если вы потеряли пароль root.