Модуль community.general.mssql_db – Добавление или удаление баз данных MSSQL на удалённом хосте

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для её установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.

Для использования в книге задач укажите: community.general.mssql_db.

Описание
Требования
Параметры
Атрибуты
Примечания
Примеры

Описание

Добавление или удаление баз данных MSSQL на удалённом хосте.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

pymssql

Параметры

Параметр	Комментарии
autocommit boolean	Автоматически подтверждает изменение только в случае успешного импорта. Иногда необходимо использовать autocommit=true, так как некоторые данные не могут быть изменены в рамках транзакции. Варианты: `false` ← (по умолчанию) `true`
login_host string / обязательно	Хост, на котором работает база данных
login_password string	Пароль для аутентификации По умолчанию: `""`
login_port string	Порт сервера MSSQL. Требуется, если login_host отличается от localhost По умолчанию: `"1433"`
login_user string	Имя пользователя для аутентификации По умолчанию: `""`
name aliases: db string / обязательно	Имя базы данных для добавления или удаления
state string	Состояние базы данных Варианты: `"present"` ← (по умолчанию) `"absent"` `"import"`
target string	Расположение файла дампов на удалённом хосте для чтения или записи. Поддерживаются не сжатые SQL файлы (`.sql`).

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может работать в `check_mode` режиме и возвращать прогноз о внесённых изменениях без модификации целевого объекта.
diff_mode	Поддержка: нет	Вернёт подробности о том, что изменилось (или, возможно, нужно изменить в `check_mode`), в режиме сравнения.

Примечания

Примечание

Требуется пакет pymssql Python на удалённом хосте. Для Ubuntu это просто pip install pymssql (см. ansible.builtin.pip.)

Примеры

- name: Create a new database with name 'jackdata'
  community.general.mssql_db:
    name: jackdata
    state: present

# Copy database dump file to remote host and restore it to database 'my_db'
- name: Copy database dump file to remote host
  ansible.builtin.copy:
    src: dump.sql
    dest: /tmp

- name: Restore the dump file to database 'my_db'
  community.general.mssql_db:
    name: my_db
    state: import
    target: /tmp/dump.sql

Авторы

Vedit Firat Arig (@vedit)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/mssql_db_module.html