mariadb-import
MariaDB начиная с 10.4.6
С MariaDB 10.4.6, mariadb-import является символической ссылкой на mysqlimport, старое название инструмента для загрузки таблиц из текстовых файлов в различных форматах.
MariaDB начиная с 10.5.2
С MariaDB 10.5.2, mariadb-import — название скрипта, при этом mysqlimport является символической ссылкой.
mariadb-import загружает таблицы из текстовых файлов в различных форматах. Базовое имя текстового файла должно совпадать с именем таблицы, которая должна быть использована. Если для подключения к серверу MariaDB используются сокеты, сервер откроет и прочитает текстовый файл напрямую. В других случаях клиент откроет текстовый файл. Для импорта строк используется команда SQL LOAD DATA INFILE.
Использование mariadb-import
Команда для использования mariadb-import и общий синтаксис:
mariadb-import [OPTIONS] database textfile1 [textfile2 ...]
Параметры
mariadb-import поддерживает следующие параметры:
| Переменная | Описание |
|---|---|
--character-sets-dir=name |
Директория для файлов наборов символов. |
-c cols, --columns=cols
|
Используйте только эти столбцы для импорта данных. Укажите имена столбцов через запятую. Это то же самое, что и указание столбцов для LOAD DATA INFILE. |
-C, --compress
|
Использовать сжатие в протоколе сервер/клиент. |
-# [options] , --debug[=options]
|
Выводить журнал отладки. Часто это d:t:o,filename. По умолчанию d:t:o. |
--debug-check |
Проверять использование памяти и открытых файлов при выходе. |
--debug-info |
Выводить некоторую отладочную информацию при выходе. |
--default-auth=plugin |
Подключаемый модуль аутентификации клиента по умолчанию. |
--default-character-set=name |
Установить набор символов по умолчанию. |
--defaults-extra-file=name |
Читать этот файл после чтения глобальных файлов. Должен быть указан первым. |
--defaults-file=name |
Читать только параметры по умолчанию из указанного файла имени. Должен быть указан первым. |
--defaults-group-suffix=name |
В дополнение к указанным группам также читать группы с этим суффиксом. |
-d, --delete
|
Сначала удалить все строки из таблицы. |
--fields-terminated-by=name |
Поля в входном файле разделяются указанной строкой. |
--fields-enclosed-by=name |
Поля в файле импорта заключены в указанный символ. |
--fields-optionally-enclosed-by=name |
Поля в входном файле необязательно заключены в указанный символ. |
--fields-escaped-by=name |
Поля в входном файле экранируются указанным символом. |
-f, --force
|
Продолжать даже при возникновении ошибки SQL. |
-?, --help
|
Отобразить эту справку и выйти. |
-h name, --host=name
|
Подключиться к хосту. |
-i, --ignore
|
Если найден дублирующий уникальный ключ, сохранить старую строку. |
k, --ignore-foreign-keys
|
Отключить проверки внешних ключей во время импорта данных. С MariaDB 10.3.16, 10.2.25 и 10.1.41. |
--ignore-lines=n |
Пропустить первые n строк данных из файла. |
--lines-terminated-by=name |
Строки в входном файле разделяются указанной строкой. |
-L, --local
|
Читать все файлы через клиента. |
-l, --lock-tables
|
Заблокировать все таблицы для записи (это отключает потоки). |
--low-priority |
Использовать LOW_PRIORITY при обновлении таблицы. |
--no-defaults |
Не читать параметры по умолчанию из файла параметров. Должен быть указан первым. |
-p[passwd], --password[=passwd]
|
Пароль для подключения к серверу. Если пароль не указан, он запрашивается из терминала. Указание пароля в командной строке считается небезопасным. Вы можете использовать файл параметров, чтобы избежать указания пароля в командной строке. |
--pipe, -W
|
В Windows подключиться к серверу через именованную трубу. Этот параметр применяется только если сервер поддерживает соединения через именованные трубы. |
--plugin-dir |
Директория для подключаемых модулей клиента. |
-P num, --port=num
|
Номер порта для подключения или 0 для использования по умолчанию, в порядке приоритета: my.cnf, переменная среды MYSQL_TCP_PORT, /etc/services, встроенное значение по умолчанию (3306). |
--print-defaults |
Вывести список аргументов программы и выйти. Должен быть указан первым. |
--protocol=name |
Протокол для подключения (tcp, socket, pipe, memory). |
-r, --replace
|
Если найден дублирующий уникальный ключ, заменить старую строку. |
--shared-memory-base-name |
Имя общей памяти для соединений Windows, использующих общую память с локальным сервером (запущенным с параметром --shared-memory). Регистрозависимый. |
-s, --silent
|
Беззвучный режим. Выводить выходные данные только при возникновении ошибок. |
-S, --socket=name
|
Для подключений к localhost, файл Unix-соккета или, в Windows, имя именованной трубы. |
--ssl |
Включает TLS. TLS также включается даже без установки этого параметра при определенных значениях других параметров TLS. Начиная с MariaDB 10.2, параметр --ssl по умолчанию не будет включать проверку сертификата сервера. Для проверки сертификата сервера необходимо указать параметр --ssl-verify-server-cert. |
--ssl-ca=name |
Указывает путь к файлу PEM, который должен содержать один или несколько сертификатов X509 для доверенных центров сертификации (ЦС), используемых для TLS. Этот параметр требует использования абсолютного пути, а не относительного. Смотрите Обзор защищенных соединений: Центры сертификации (ЦС) для получения дополнительной информации. Этот параметр подразумевает параметр --ssl. |
--ssl-capath=name |
Указывает путь к каталогу, который содержит один или несколько файлов PEM, каждый из которых должен содержать один сертификат X509 для доверенного центра сертификации (ЦС), используемого для TLS. Этот параметр требует использования абсолютного пути, а не относительного. Каталог, указанный этим параметром, должен быть обработан командой openssl rehash. Смотрите Обзор защищенных соединений: Центры сертификации (ЦС) для получения дополнительной информации. Этот параметр поддерживается только, если клиент был скомпилирован с OpenSSL или yaSSL. Если клиент был скомпилирован с GnuTLS или Schannel, то этот параметр не поддерживается. Смотрите TLS и криптографические библиотеки, используемые MariaDB для получения дополнительной информации о используемых библиотеках на разных платформах. Этот параметр подразумевает параметр --ssl. |
--ssl-cert=name |
Указывает путь к файлу сертификата X509, который используется для TLS. Этот параметр требует использования абсолютного пути, а не относительного. Этот параметр подразумевает параметр --ssl. |
--ssl-cipher=name |
Список разрешенных шифров или наборов шифров для использования в TLS. Этот параметр подразумевает параметр --ssl. |
--ssl-crl=name |
Указывает путь к файлу PEM, который должен содержать один или несколько отозванных сертификатов X509 для использования в TLS. Этот параметр требует использования абсолютного пути, а не относительного. Смотрите Обзор защищенных соединений: списки отозванных сертификатов (CRL) для получения дополнительной информации. Этот параметр поддерживается только, если клиент был скомпилирован с OpenSSL или Schannel. Если клиент был скомпилирован с yaSSL или GnuTLS, то этот параметр не поддерживается. Смотрите TLS и криптографические библиотеки, используемые MariaDB для получения дополнительной информации о используемых библиотеках на разных платформах. |
--ssl-crlpath=name |
Указывает путь к каталогу, содержащему один или несколько файлов PEM, каждый из которых содержит один отозванный сертификат X509, используемый для TLS. Этот параметр требует использования абсолютного пути, а не относительного. Каталог, указанный этим параметром, должен быть обработан командой openssl rehash. Смотрите Обзор защищенных соединений: списки отозванных сертификатов (CRL) для получения дополнительной информации. Этот параметр поддерживается только, если клиент был скомпилирован с OpenSSL. Если клиент был скомпилирован с yaSSL, GnuTLS или Schannel, то этот параметр не поддерживается. Смотрите TLS и криптографические библиотеки, используемые MariaDB для получения дополнительной информации о используемых библиотеках на разных платформах. |
--ssl-key=name |
Указывает путь к файлу закрытого ключа для использования в TLS. Этот параметр требует использования абсолютного пути, а не относительного. Этот параметр подразумевает параметр --ssl. |
--ssl-verify-server-cert |
Включает проверку сертификата сервера. Этот параметр отключён по умолчанию. |
--tls-version=name |
Этот параметр принимает список TLS-версий, разделенных запятыми. Версия TLS будет включена только если она присутствует в этом списке. Все остальные версии TLS не будут разрешены. Смотрите Обзор защищенных соединений: TLS-версии протокола для получения дополнительной информации. Этот параметр был добавлен в MariaDB 10.4.6. |
--use-threads=num |
Загружать файлы параллельно. Аргумент - количество потоков для загрузки данных. |
-u name, --user=name
|
Пользователь для входа, если не текущий пользователь. |
-v, --verbose
|
Выводить информацию о разных этапах. |
-V, --version
|
Вывести информацию о версии и выйти. |
Файлы параметров
Помимо считывания параметров из командной строки, mariadb-import также может считывать параметры из файлов параметров. Если параметр неизвестен mariadb-import, то он игнорируется.
Следующие параметры относятся к тому, как инструменты MariaDB командной строки обрабатывают файлы параметров. Они должны быть указаны в качестве первого аргумента в командной строке:
| Параметр | Описание |
|---|---|
--print-defaults |
Вывести список аргументов программы и завершить работу. |
--no-defaults |
Не читать параметры по умолчанию из файла параметров. |
--defaults-file=# |
Считывать параметры по умолчанию только из заданного файла #. |
--defaults-extra-file=# |
Прочитать этот файл после чтения глобальных файлов. |
В MariaDB 10.2 и более поздних версиях, mariadb-import связан с MariaDB Connector/C. Поэтому может быть полезно ознакомиться с Настройка MariaDB Connector/C с файлами параметров для получения дополнительной информации о том, как MariaDB Connector/C обрабатывает файлы параметров.
Группы параметров
mariadb-import считывает параметры из следующих групп параметров из файлов параметров:
| Группа | Описание |
|---|---|
[mysqlimport] |
Параметры, считываемые mysqlimport, что включает как MariaDB Server, так и MySQL Server. |
[mariadb-import] |
Параметры, считываемые mysqlimport. Доступно начиная с MariaDB 10.4.6. |
[client] |
Параметры, считываемые всеми программами-клиентами MariaDB и MySQL клиентские программы, что включает как MariaDB, так и MySQL клиенты. Например, mysqldump. |
[client-server] |
Параметры, считываемые всеми программами-клиентами MariaDB и MariaDB Server. Это полезно для параметров, таких как сокет и порт, которые общие для сервера и клиентов. |
[client-mariadb] |
Параметры, считываемые всеми программами-клиентами MariaDB. |
Значения по умолчанию
Переменные ({FALSE
|
Значение (после чтения параметров) |
|---|---|
character-sets-dir |
(Значение по умолчанию отсутствует) |
default-character-set |
latin1 |
columns |
(Значение по умолчанию отсутствует) |
compress |
ЛОЖЬ |
debug-check |
ЛОЖЬ |
debug-info |
ЛОЖЬ |
delete |
ЛОЖЬ |
fields-terminated-by |
(Значение по умолчанию отсутствует) |
fields-enclosed-by |
(Значение по умолчанию отсутствует) |
fields-optionally-enclosed-by |
(Значение по умолчанию отсутствует) |
fields-escaped-by |
(Значение по умолчанию отсутствует) |
force |
ЛОЖЬ |
host |
(Значение по умолчанию отсутствует) |
ignore |
ЛОЖЬ |
ignore-lines |
0 |
lines-terminated-by |
(Значение по умолчанию отсутствует) |
local |
ЛОЖЬ |
lock-tables |
ЛОЖЬ |
low-priority |
ЛОЖЬ |
port |
3306 |
replace |
ЛОЖЬ |
silent |
ЛОЖЬ |
socket |
/var/run/mysqld/mysqld.sock |
ssl |
ЛОЖЬ |
ssl-ca |
(Значение по умолчанию отсутствует) |
ssl-capath |
(Значение по умолчанию отсутствует) |
ssl-cert |
(Значение по умолчанию отсутствует) |
ssl-cipher |
(Значение по умолчанию отсутствует) |
ssl-key |
(Значение по умолчанию отсутствует) |
ssl-verify-server-cert |
ЛОЖЬ |
use-threads |
0 |
user |
(Значение по умолчанию отсутствует) |
verbose |
ЛОЖЬ |
Содержимое, воспроизведенное на этом сайте, является собственностью соответствующих владельцев, и это содержимое не проходит предварительной проверки MariaDB. Мнения, информация и мнения, выраженные в этом содержании, не обязательно отражают точку зрения MariaDB или любой другой стороны.
© 2023 MariaDB
Licensed under the Creative Commons Attribution 3.0 Unported License and the GNU Free Documentation License.
https://mariadb.com/kb/en/mariadb-import/
