mysql_db – Добавление или удаление баз данных MySQL на удалённом хосте.
Описание
- Добавление или удаление баз данных MySQL на удалённом хосте.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- MySQLdb (Python 2.x)
- PyMySQL (Python 2.7 и Python 3.X), или
- mysql (бинарный файл командной строки)
- mysqldump (бинарный файл командной строки)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| collation - | Режим сортировки (collation). Это относится только к новым таблицам/базам данных и не обновляет существующие, это ограничение MySQL. | |
| config_file - добавлено в 2.0 | По умолчанию: "~/.my.cnf" | Укажите конфигурационный файл, из которого следует читать пользователя и пароль. |
| connect_timeout - добавлено в 2.1 | По умолчанию: 30 | Таймаут соединения при подключении к серверу MySQL. |
| encoding - | Режим кодировки для использования, примеры включают utf8 или latin1_swedish_ci
| |
| ignore_tables - добавлено в 2.7 | По умолчанию: [] | Список имён таблиц, которые будут пропущены при дампе в формате имя_базы_данных.имя_таблицы |
| login_host - | По умолчанию: "localhost" | Хост, на котором работает база данных. |
| login_password - | Пароль, используемый для аутентификации. | |
| login_port - | По умолчанию: 3306 | Порт сервера MySQL. Требуется, чтобы login_host был определён как другой, чем localhost, если используется login_port. |
| login_unix_socket - | Путь к сокету Unix-домена для локальных подключений. | |
| login_user - | Имя пользователя, используемое для аутентификации. | |
| name - / обязательно | Имя базы данных для добавления или удаления name=all Может быть указан только если state равен dump или import. если name=all Работает как опция --all-databases для mysqldump (Добавлена в 2.0) псевдонимы: db | |
| quick boolean добавлено в 2.1 |
| Опция, используемая для дампов больших таблиц |
| single_transaction boolean добавлено в 2.1 |
| Выполнение дампа в одной транзакции |
| ssl_ca - добавлено в 2.0 | Путь к сертификату Удостоверяющего центра (CA). Если используется, этот параметр должен указывать тот же сертификат, что и на сервере. | |
| ssl_cert - добавлено в 2.0 | Путь к клиенту сертификату открытого ключа. | |
| ssl_key - добавлено в 2.0 | Путь к закрытому ключу клиента. | |
| state - |
| Состояние базы данных |
| target - | Расположение на удалённом хосте файла дампа для чтения или записи. Поддерживаются несжатые файлы SQL ( .sql) а также сжатые файлы bzip2 (.bz2), gzip (.gz) и xz (Добавлено в 2.0). |
Примечания
Примечание
- Требуется пакет PyMySQL (Python 2.7 и Python 3.X) или MySQL-python (Python 2.X) на удалённом хосте, а также бинарные файлы mysql и mysqldump.
- Этот модуль не является идемпотентным, когда state равен
import, и будет импортировать файл дампа каждый раз при запуске более одного раза. - Требуется пакет PyMySQL (Python 2.7 и Python 3.X) или MySQL-python (Python 2.X) Python на удалённом хосте. Для Ubuntu это так же просто, как apt-get install python-pymysql. (См. apt.) Для CentOS/Fedora, это так же просто, как yum install python2-PyMySQL. (См. yum.)
- И
login_passwordиlogin_userтребуются при передаче учётных данных. Если они отсутствуют, модуль попытается прочитать учётные данные из~/.my.cnf, и в конечном счёте вернётся к использованию стандартного входа в MySQL ‘root’ без пароля.
Примеры
- name: Create a new database with name 'bobdata'
mysql_db:
name: bobdata
state: present
# Copy database dump file to remote host and restore it to database 'my_db'
- name: Copy database dump file
copy:
src: dump.sql.bz2
dest: /tmp
- name: Restore database
mysql_db:
name: my_db
state: import
target: /tmp/dump.sql.bz2
- name: Dump all databases to hostname.sql
mysql_db:
state: dump
name: all
target: /tmp/{{ inventory_hostname }}.sql
- name: Import file.sql similar to mysql -u <username> -p <password> < hostname.sql
mysql_db:
state: import
name: all
target: /tmp/{{ inventory_hostname }}.sql
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [предварительный просмотр]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Команда Ansible Core
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/mysql_db_module.html
