Spec-Zone.ru › Ansible

lowlydba.sqlserver.availability_group модуль — Настраивает группу(ы) доступности

Примечание

Этот модуль входит в коллекцию lowlydba.sqlserver (версия 2.3.4).

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

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

Для использования в playbook укажите: lowlydba.sqlserver.availability_group.

Новая функция в lowlydba.sqlserver 0.4.0

  • Обзор
  • Требования
  • Параметры
  • Атрибуты
  • Примеры
  • Значения возврата

Обзор

  • Настраивает группы доступности SQL Server с максимум одной репликой.

Требования

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

  • Модуль PowerShell dbatools

Параметры

Параметр

Комментарии

ag_name

string / required

Имя группы доступности.

all_ags

boolean

Применить изменения ко всем группам доступности на экземпляре. Используется только для настройки существующих групп доступности.

Варианты:

  • false
  • true

allow_null_backup

boolean

Разрешить создание полной резервной копии в NULL если таковой не существует и seeding_mode=Automatic.

Варианты:

  • false
  • true

automated_backup_preference

string

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

Варианты:

  • "None"
  • "Primary"
  • "Secondary" ← (default)
  • "SecondaryOnly"

availability_mode

string

Должна ли реплика быть асинхронной или синхронной.

Используется только при создании новой группы доступности.

Варианты:

  • "AsynchronousCommit"
  • "SynchronousCommit" ← (default)

basic_availability_group

boolean

Указывает, является ли группа доступности базовой группой доступности.

Варианты:

  • false
  • true

cluster_type

string

Тип кластера группы доступности. Поддерживается только в SQL Server 2017 и выше.

Варианты:

  • "Wsfc" ← (default)
  • "External"
  • "None"

database

aliases: database_name

string

Имя базы данных, для которой нужно создать группу доступности.

database_health_trigger

boolean

Указывает, активирует ли группа доступности состояние базы данных.

Варианты:

  • false
  • true

dtc_support_enabled

boolean

Включает поддержку Dtc.

Варианты:

  • false
  • true

failover_mode

string

Есть ли у реплики автоматический или ручной отказ.

Варианты:

  • "Automatic" ← (default)
  • "Manual"

failure_condition_level

string

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

Варианты:

  • "OnAnyQualifiedFailureCondition"
  • "OnCriticalServerErrors"
  • "OnModerateServerErrors"
  • "OnServerDown"
  • "OnServerUnresponsive"

force

boolean

Удалить и пересоздать базу данных на удаленных серверах, используя свежую резервную копию.

Варианты:

  • false
  • true

healthcheck_timeout

integer

Этот параметр используется для указания длительности времени в миллисекундах, в течение которого DLL ресурса SQL Server должен ожидать информации, возвращаемой хранимой процедурой sp_server_diagnostics, прежде чем сообщать о том, что экземпляр кластера отказоустойчивости Always On (FCI) не отвечает.

Изменения, внесенные в параметры времени ожидания, вступают в силу немедленно и не требуют перезапуска ресурса SQL Server.

is_distributed_ag

boolean

Указывает, является ли группа доступности распределенной.

Варианты:

  • false
  • true

seeding_mode

string

Режим начальной загрузки по умолчанию для реплики. Должен оставаться по умолчанию, иначе может потребоваться ручная настройка.

Варианты:

  • "Automatic"
  • "Manual" ← (default)

shared_path

string

Сетевой ресурс, где будут создаваться резервные копии и восстанавливаться из них.

sql_instance

string / required

Экземпляр SQL Server для изменения.

sql_instance_secondary

string

Вторичный экземпляр SQL Server для новой группы доступности.

sql_password

string

Пароль для аутентификации SQL.

sql_password_secondary

string

Пароль для аутентификации SQL для вторичной реплики.

sql_username

string

Имя пользователя для аутентификации SQL.

sql_username_secondary

string

Имя пользователя для аутентификации SQL для вторичной реплики.

state

string

Определяет, должен ли объект быть present или absent.

Выберите:

  • "present" ← (по умолчанию)
  • "absent"

use_last_backup

boolean

Использовать последний полный и журнальный бэкапы базы данных. Журнальный бэкап должен быть последним.

Выберите:

  • false
  • true

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз изменённого состояния без модификации цели.

platform

Платформы: все

Целевые ОС/семейства, к которым можно применить действия.

Примеры

- name: Create Availability Group
  lowlydba.sqlserver.availability_group:
    sql_instance: sql-01.myco.io
    ag_name: AG_MyDatabase

Возвращаемые значения

Общие возвращаемые значения описаны в этом разделе, следующие поля уникальны для данного модуля:

Ключ

Описание

data

словарь

Вывод от функции New-DbaAvailabilityGroup или Set-DbaAvailabilityGroup.

Возвращается: успешно, но не в режиме check_mode.

Авторы

  • John McCall (@lowlydba)

Ссылки на сборку

  • Система отслеживания ошибок
  • Репозиторий (источники)

© 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/lowlydba/sqlserver/availability_group_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API