Spec-Zone.ru › Ansible

Модуль lowlydba.sqlserver.availability_group — настройка групп доступности

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: lowlydba.sqlserver.availability_group.

Новое в lowlydba.sqlserver 0.4.0

  • Краткое описание
  • Требования
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Краткое описание

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

Требования

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

  • Модуль PowerShell dbatools

Параметры

Параметр

Комментарии

ag_name

string / обязательный

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

all_ags

boolean

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

Варианты:

  • false
  • true

allow_null_backup

boolean

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

Варианты:

  • false
  • true

automated_backup_preference

string

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

Варианты:

  • "None"
  • "Primary"
  • "Secondary" ← (по умолчанию)
  • "SecondaryOnly"

availability_mode

string

Определяет, будет ли реплика асинхронной или синхронной.

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

Варианты:

  • "AsynchronousCommit"
  • "SynchronousCommit" ← (по умолчанию)

basic_availability_group

boolean

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

Варианты:

  • false
  • true

cluster_type

string

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

Варианты:

  • "Wsfc" ← (по умолчанию)
  • "External"
  • "None"

contained_availability_group

boolean

добавлено в lowlydba.sqlserver 2.6.0

Указывает, является ли группа доступности автономной. Требуется DBATools >= 2.1.15

Варианты:

  • false
  • true

database

псевдонимы: database_name

string

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

database_health_trigger

boolean

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

Варианты:

  • false
  • true

dtc_support_enabled

boolean

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

Варианты:

  • false
  • true

failover_mode

string

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

Варианты:

  • "Automatic" ← (по умолчанию)
  • "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" ← (по умолчанию)

shared_path

string

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

sql_instance

string / обязательный

Изменяемый экземпляр 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

dictionary

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

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

Авторы

  • John McCall (@lowlydba)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/lowlydba/sqlserver/availability_group_module.html

Spec-Zone.ru

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