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

Настройка 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.

После установки ИНТЕРФЕЙСА командной строки откройте командную строку и войдите в учетную запись Azure с помощью следующей команды.

az login

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

Служба миграции предоставляет следующие команды, которые помогут перенести экземпляры PostgreSQL в База данных Azure для 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 приблизиться к 0, а затем начать переключение.
      • Операция переключение применяет все ожидающие изменения из источника к целевому объекту и завершает миграцию. Если вы активируете "Cutover" даже с ненулевой Latency, репликация останавливается до этого момента времени. Все данные в источнике до тех пор, пока точка переключа не будет применена к целевому объекту. Предположим, что задержка составила 15 минут в точке перехода, поэтому все измененные данные за последние 15 минут применяются к целевому объекту.
  • Отмена миграции. При необходимости этот параметр позволяет остановить процесс миграции.
  • Настройте логическую репликацию в источнике: это полезно, если исходный сервер является База данных Azure для PostgreSQL - один сервер, так как он подготавливает сервер для репликации данных на гибкий сервер.

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

Итоги

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

Параметр Соответствующие команды Description
subscription create, list, show, update Идентификатор подписки гибкого сервера PostgreSQL
resource-group create, list, show, update Группа ресурсов гибкого сервера PostgreSQL
name create, list, show Имя гибкого сервера PostgreSQL
migration-name создание, отображение, обновление Уникальный идентификатор попытки миграции в Гибкий сервер. Это поле принимает только буквенно-цифровые символы и не принимает специальные символы, кроме дефиса (-). Имя не может начинаться с -, и нет двух миграций в гибкий целевой объект сервера может иметь то же имя.
filter список Для фильтрации миграций поддерживаются два значения: "Активный" и "Все"
help create, list, show, update Предоставляет сведения о каждой команде.
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 Укажите список баз данных, которые требуется перенести в Гибкий сервер. Одновременно можно включить не более восьми имен баз данных. Предоставление списка DOB-объектов в формате массива.
overwriteDBsInTarget Если задано значение true (по умолчанию), если целевой сервер имеет существующую базу данных с тем же именем, что и при попытке перенести, служба миграции автоматически перезаписывает базу данных.
migrationRuntimeResourceId Требуется, если сервер среды выполнения должен использоваться для миграции. Формат — /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Обязательный параметр. Значения могут быть : локальные, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Режимы SSL для миграции. Режим SSL для PostgreSQLSingleServer — VerifyFull и Prefer/Require для других типов источников.

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