Поделиться через

Настройка Azure CLI для службы миграции в гибком сервере Базы данных Azure для PostgreSQL

Azure CLI — это набор команд, используемых в службах Azure для создания ресурсов и управления ими. Он предоставляет те же возможности, что и портал Azure, но оптимизирован для пользователей, которые предпочитают работать в среде командной строки. Чтобы начать миграцию с помощью Azure CLI, необходимо установить Azure CLI на локальном компьютере.

Необходимые компоненты

  • Установите Azure CLI. В зависимости от операционной системы скачайте и установите Azure CLI. Она доступна для Windows, macOS и Linux.

  • Руководство по установке Azure CLI. Следуйте инструкциям, приведенным в официальной документации По Azure, чтобы установить Azure CLI. Как установить Azure CLI.

  • Проверьте версию Azure CLI: убедитесь, что версия Azure CLI не менее 2.56.0 или выше, так как это необходимо для службы миграции. Используйте команду az --version , чтобы проверить текущую версию.

  • Войдите в Azure: после установки выполните проверку az login подлинности. Откроется браузер по умолчанию для завершения процесса входа с учетными данными Azure.

Эти действия подготовят среду к использованию Azure CLI для эффективного управления службой миграции в База данных Azure для PostgreSQL. Всегда обратитесь к последней документации По Azure для любых обновлений или изменений процесса установки.

Настройка команд CLI для службы миграции

Все команды CLI начинаются с az postgres flexible-server migration. Существуют также инструкции справки, которые помогут вам понять различные параметры и создать правильный синтаксис для команд CLI.

Действия по настройке команд CLI

  1. Установите Azure CLI: Следуйте инструкциям, приведённым в официальной документации по Azure, чтобы установить Azure CLI — как установить Azure CLI.

  2. Проверьте версию Azure CLI. Убедитесь, что версия Azure CLI не менее 2.56.0 или выше. Используйте команду az --version , чтобы проверить текущую версию.

  3. Войдите в Azure: после установки выполните проверку az login подлинности. Откроется браузер по умолчанию для завершения процесса входа с учетными данными Azure.

После установки CLI откройте командную строку и выполните вход в учетную запись Azure с помощью следующей команды.

az login

Миграция команд

Служба миграции предоставляет следующие команды, которые помогут перенести экземпляры PostgreSQL в Azure Database for PostgreSQL (гибкий сервер).

Команда help

Команда --help в Azure CLI — это ценный вариант, предоставляющий подробную документацию по командам и их подкомандам, включая необходимые команды для операций. Команда –-helpотображает необходимые команды и связанные с ними действия для службы миграции в База данных Azure для PostgreSQL.

az postgres flexible-server migration –-help

Выходные данные помогут вам выполнить необходимые действия и параметры, необходимые для эффективного управления миграцией базы данных с помощью Azure CLI.

Команда create

Команда az postgres flexible-server migration create в Azure CLI используется для запуска нового рабочего процесса миграции. Это упрощает миграцию баз данных из исходного экземпляра PostgreSQL в целевой экземпляр гибкого сервера Базы данных Azure для PostgreSQL. Эта команда настраивает необходимые параметры и конфигурации для обеспечения плавного и эффективного процесса миграции.

Дополнительные сведения см. в статье az postgres flexible-server migration create

Команда list

Команда az postgres flexible-server migration list используется для перечисления всех попыток миграции в целевой объект База данных Azure для PostgreSQL. Эта команда содержит обзор инициированных миграций, что позволяет отслеживать состояние и сведения о каждой попытке миграции.

Дополнительные сведения см. в статье az postgres flexible-server migration list

Показать команду

Эта az postgres flexible-server migration show команда помогает отслеживать текущие миграции и предоставляет текущее состояние и подсостояние миграции. К этим сведениям относится информация о текущем состоянии и подсостоянии миграции.

Дополнительные сведения см. в статье az postgres flexible-server migration show

Некоторые возможные состояния миграции:

Состояния миграции

State Description
InProgress Выполняется настройка инфраструктуры миграции или выполняется фактическая миграция данных.
Отменено Миграция отменена или удалена.
Неудачно Сбой миграции.
Сбой проверки Сбой проверки.
Успешно Миграция прошла успешно и завершена.
WaitingForUserAction Применимо только для миграции через Интернет. Ожидание действия пользователя для выполнения переключение.

Подсостояния миграции

Подсостояние Description
PerformingPreRequisiteSteps Настройка инфраструктуры выполняется для миграции данных.
Проверка в процессе выполнения Проверка выполняется.
MigratingData Выполняется миграция данных.
CompletingMigration Миграция находится на заключительных этапах завершения.
Завершено Миграция завершена.
Неудачно Сбой миграции.

Подстатки проверки

Подсостояние Description
Неудачно Валидация завершилась неудачно.
Успешно Проверка выполнена успешно.
Предупреждения Проверка отображается в предупреждении.

Команда обновления

Эта az postgres flexible-server migration update команда используется для управления процессом миграции на гибкий сервер Базы данных Azure для PostgreSQL. В частности, его можно использовать для:

  • Выполните переключение. Это завершает процесс миграции, переключив трафик базы данных с исходного сервера на целевой гибкий сервер.

    • После завершения миграции базовых данных задача миграции переходит в подстатическую статистику WaitingForCutoverTrigger . В этом состоянии пользователи могут активировать переход с портала, выбрав имя миграции в сетке миграции или через CLI.
    • Прежде чем инициировать переключение, важно убедиться в том, что:
      • Записи в источник остановлены
      • latency Значение уменьшается до 0 или близко к 0
      • latency значение указывает, когда целевой объект последний раз синхронизирован с источником. На этом этапе записи в источник можно остановить и начать переключение. Если на источнике интенсивный трафик, сначала следует остановить операции записи, чтобы Latency достигло нулевого значения, а затем инициировать переход.
      • Операция переключение применяет все ожидающие изменения из источника к целевому объекту и завершает миграцию. Если вы активируете "Cutover" даже с ненулевой Latency, репликация останавливается до этого момента времени. Все данные в источнике до тех пор, пока точка переключа не будет применена к целевому объекту. Предположим, что задержка составила 15 минут в точке перехода, поэтому все измененные данные за последние 15 минут применяются к целевому объекту.

  • Отмена миграции. При необходимости этот параметр позволяет остановить процесс миграции.

  • Настройка логической репликации в источнике. Это полезно, если исходный сервер является базой данных Azure для PostgreSQL — отдельный сервер, так как он подготавливает сервер к репликации данных на гибкий сервер.

Дополнительные сведения см. в статье az postgres flexible-server migration update

Итоги

В следующей таблице перечислены параметры, используемые командами миграции:

Параметр Соответствующие команды Description
subscription создать, перечислить, показать, обновить Идентификатор подписки гибкого сервера PostgreSQL
resource-group создать, список, показать, обновить Группа ресурсов гибкого сервера PostgreSQL
name создать, перечислить, показать Имя гибкого сервера PostgreSQL
migration-name создание, отображение, обновление Уникальный идентификатор миграций, выполняемых на гибком сервере. Это поле принимает только буквенно-цифровые символы и не принимает специальные символы, кроме дефиса (-). Имя не может начинаться с -, и ни одна из двух миграций на гибкий целевой сервер не может иметь одинаковое имя.
filter список Для фильтрации миграций поддерживаются два значения: "Активный" и "Все"
help создать, перечислить, показать, обновить Предоставляет сведения о каждой команде.
migration-mode create Этот параметр является необязательным. Допустимые значения: автономные, в сети. Значение по умолчанию: автономное.
migration-option create Позволяет выполнять проверки перед активацией миграции. Значение по умолчанию — ValidateAndMigrate. Допустимые значения: "Миграция", "Проверка", "ValidateAndMigrate".
properties create Абсолютный путь к JSON-файлу с информацией об исходном, целевом сервере, базах данных для миграции, режимах SSL, определении типов источников

Сведения о JSON-файле

Для az postgres flexible-server migration create выполнения команды требуется путь к файлу JSON в составе --properties параметра, который содержит сведения о конфигурации для миграции, такие как идентификатор ресурса сервера исходной базы данных, учетные данные администратора, базы данных для миграции и другие важные параметры. Ниже приведены различные свойства:

Имя свойства Description
sourceDbServerResourceId Сведения о исходном сервере в формате для локальных виртуальных машин ( виртуальных машин), облачной службы PostgreSQL — <<hostname or IP address>>:<<port>>@<<username>>. Если исходный сервер База данных Azure для PostgreSQL — отдельный сервер, идентификатор ресурса находится в формате —/subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Этот параметр содержит пароли для пользователей администратора для исходного сервера и целевого гибкого сервера PostgreSQL. Эти пароли помогают выполнять проверку подлинности для исходного и целевого серверов. Она включает в себя две вложенные подписки и sourceServerPasswordtargetServerPassword
targetServerUserName Значением по умолчанию является пользователь администратора, созданный во время создания гибкого сервера PostgreSQL, а пароль используется для проверки подлинности для этого пользователя.
dbsToMigrate Укажите список баз данных, которые требуется перенести на гибкий сервер. Одновременно можно включить не более восьми имен баз данных. Предоставление списка баз данных в формате массива.
overwriteDBsInTarget Если задано значение true (по умолчанию), если целевой сервер имеет существующую базу данных с тем же именем, что и при попытке перенести, служба миграции автоматически перезаписывает базу данных.
migrationRuntimeResourceId Требуется, если сервер среды выполнения должен использоваться для миграции. Формат — /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName Требуется только в том случае, если источник является одиночным сервером и находится за пользовательским DNS-сервером, пользовательскими пространствами имен DNS, пользовательским полным доменным именем или должен быть доступен по IP-адресу.
targetDBServerFullyQualifiedDomainName Требуется только в том случае, если целевой объект находится за пользовательским DNS-сервером, пользовательскими пространствами имен DNS, пользовательским полным доменным именем или должен быть доступен через IP-адрес.
sourceType Обязательный параметр. Значения могут быть : локальные, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Режимы SSL для миграции. Режим SSL для PostgreSQLSingleServer — VerifyFull и Prefer/Require для других типов источников.

Связанный контент