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

Примечание

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

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

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

Для использования в книге задач укажите: lowlydba.sqlserver.ag_replica.

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

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

Обзор

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

Требования

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

Модуль PowerShell dbatools

Параметры

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

END_OF_DOCUMENT_MARKER

состояние

строка

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

Выбор:

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

Атрибуты

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

Примеры

- 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'

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

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

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