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

Примечание

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

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

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

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

Добавлено в lowlydba.sqlserver 0.5.0

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

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

Настраивает реплику группы доступности.

Требования

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

dbatools — модуль PowerShell

Параметры

Параметр	Комментарии
ag_name string / обязательный	Имя группы доступности, в которую будет добавлена новая реплика.
availability_mode string	Определяет, будет ли реплика асинхронной или синхронной. Варианты: `"AsynchronousCommit"` ← (по умолчанию) `"SynchronousCommit"`
backup_priority integer	Задает приоритет резервного копирования реплики группы доступности. По умолчанию: `50`
cluster_type string	Тип кластера группы доступности. Поддерживается только в SQL Server 2017 и более поздних версиях. Варианты: `"Wsfc"` ← (по умолчанию) `"External"` `"None"`
configure_xe_session boolean	Настраивает автоматический запуск сеанса расширенных событий AlwaysOn_health, как это делает мастер SSMS. Варианты: `false` ← (по умолчанию) `true`
connection_mode_in_primary_role string	Какие подключения разрешены к базе данных, когда она выполняет основную роль. Варианты: `"AllowReadIntentConnectionsOnly"` `"AllowAllConnections"` ← (по умолчанию)
connection_mode_in_secondary_role string	Какие подключения разрешены к базе данных, когда она выполняет вторичную роль. Варианты: `"AllowNoConnections"` ← (по умолчанию) `"AllowReadIntentConnectionsOnly"` `"AllowAllConnections"`
endpoint string	По умолчанию команда пытается найти конечную точку DatabaseMirror. Если такой точки нет, она будет создана. По умолчанию: `"hadr_endpoint"`
endpoint_url string	По умолчанию в качестве endpoint_url используется свойство `Fqdn` объекта `Get-DbaEndpoint`. Укажите endpoint_url, если из-за особой конфигурации сети требуется другой URL.
failover_mode string	Определяет, будет ли переключение на резервную реплику автоматическим или ручным. Варианты: `"Automatic"` `"Manual"` ← (по умолчанию)
read_only_routing_connection_url string	Задает URL подключения для маршрутизации подключений только для чтения к реплике группы доступности.
read_only_routing_list string	Задает упорядоченный список имен серверов-реплик для маршрутизации подключений только для чтения через эту реплику группы доступности.
seeding_mode string	Режим заполнения реплики данными по умолчанию. Рекомендуется оставить значение по умолчанию, иначе может потребоваться ручная настройка. Варианты: `"Automatic"` ← (по умолчанию) `"Manual"`
session_timeout integer	Количество секунд, в течение которых реплика группы доступности ожидает ответа на проверочный запрос от подключенной реплики, прежде чем считать, что соединение разорвано.
sql_instance string / обязательный	Экземпляр SQL Server, который нужно изменить.
sql_instance_replica string / обязательный	Экземпляр SQL Server, на котором находится настраиваемая реплика.
sql_password string	Пароль для аутентификации SQL.
sql_password_replica string	Пароль для аутентификации SQL на вторичной реплике.
sql_username string	Имя пользователя для аутентификации SQL.
sql_username_replica string	Имя пользователя для аутентификации SQL на вторичной реплике.
state string	Определяет, должен ли объект быть `present` или `absent`. Варианты: `"present"` ← (по умолчанию) `"absent"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект.
platform	Платформы: все	Целевые ОС и семейства ОС, с которыми можно работать.

Примеры

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

- name: Add a DR replica
  lowlydba.sqlserver.ag_replica:
    ag_name: 'AG_MyDatabase'
    sql_instance_primary: sql-01.myco.io
    sql_instance_replica: sql-02.myco.io
    failover_mode: 'Manual'
    availability_mode: 'Asynchronous'
    seeding_mode: 'Automatic'
    connection_mode_in_primary_role: 'AllowAllConnections'
    connection_mode_in_secondary_role: 'AllowNoConnections'

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

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

Ключ	Описание
data dictionary	Результат функции `Add-DbaAgReplica` или `Set-DbaAgReplica`. Возвращается: при успешном выполнении, но не в режиме 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/ag_replica_module.html