Обновление кластеров больших данных SQL Server

Область применения: SQL Server 2019 (15.x)

Important

Кластеры больших данных Microsoft SQL Server 2019 прекращены. Поддержка кластеров больших данных SQL Server 2019 закончилась с 28 февраля 2025 г. Дополнительные сведения см. в записи блога объявлений и параметрах больших данных на платформе Microsoft SQL Server.

Путь обновления зависит от текущей версии кластера больших данных SQL Server. Чтобы обновить поддерживаемый выпуск, включая общий выпуск дистрибутива (GDR), накопительное обновление (CU) или обновление для быстрого исправления (QFE), можно обновить на месте. Обновление на месте с предварительной версии технологии сообщества (CTP) или версия кандидата на выпуск BDC не поддерживается. Необходимо удалить и повторно создать кластер. В следующих разделах описаны шаги для каждого сценария:

Обновление с поддерживаемого выпуска
Обновление развертывания BDC из CTP или кандидата на выпуск

Note

Самый старый поддерживаемый в настоящее время выпуск кластеров больших данных — SQL Server 2019 CU8.

Заметки о выпуске обновления

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

Warning

Параметр imagePullPolicy должен быть задан как "Always" в файле control.json профиля развертывания при первоначальном развертывании кластера. Этот параметр нельзя изменить после развертывания. В случае, если он установлен с другим значением, непредвиденные результаты могут произойти во время процесса обновления, а повторное развертывание кластера потребуется.

Обновление с поддерживаемого выпуска

В этом разделе объясняется, как обновить BDC SQL Server с поддерживаемого выпуска (начиная с SQL Server 2019 GDR1) до более нового поддерживаемого выпуска.

Проверьте отсутствие активных сеансов Livy.

Убедитесь, что активные сеансы Livy или пакетные задания не выполняются в Azure Data Studio. Простой способ подтвердить это — использовать команду curl или браузер для запроса этих URL-адресов.
- <your-gateway-endpoint>/gateway/default/livy/v1/sessions
- <your-gateway-endpoint>/gateway/default/livy/v1/batches
Резервное копирование главного экземпляра SQL Server.

Создание резервной копии HDFS.

azdata bdc hdfs cp --from-path <path> --to-path <path>

For example:

azdata bdc hdfs cp --from-path hdfs://user/hive/warehouse/%%D --to-path ./%%D

Обновление Azure Data CLI (azdata).

Следуйте инструкциям по установке Azure Data CLI (azdata).
Note

Если Azure Data CLI (azdata) был установлен с помощью pip, его нужно удалить вручную, прежде чем устанавливать с помощью установщика Windows или диспетчера пакетов Linux.
Обновите кластер больших данных.
```
azdata bdc upgrade -n <clusterName> -t <imageTag> -r <containerRegistry>/<containerRepository>
```
Например, следующий скрипт использует 2019-CU19-ubuntu-20.04 тег изображения:
```
azdata bdc upgrade -n bdc -t 2019-CU19-ubuntu-20.04 -r mcr.microsoft.com/mssql/bdc
```

Note

Последние теги для изображений доступны в примечаниях к выпуску кластеров больших данных SQL Server 2019.

Important

Если вы используете частный репозиторий для предварительного извлечения образов для развертывания или обновления BDC, убедитесь, что текущие образы сборки, а также >целевые образы сборки находятся в частном репозитории. При необходимости это обеспечивает успешный откат. Кроме того, если вы изменили >учетные данные частного репозитория с момента первоначального развертывания, обновите соответствующие переменные среды DOCKER_PASSWORD и >DOCKER_USERNAME. Обновление с использованием различных частных репозиториев для текущих и целевых сборок не поддерживается.

Увеличение времени ожидания обновления

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

>azdata.EXE bdc upgrade --name <mssql-cluster>
Upgrading cluster to version 15.0.4003

NOTE: Cluster upgrade can take a significant amount of time depending on
configuration, network speed, and the number of nodes in the cluster.

Upgrading Control Plane.
Control plane upgrade failed. Failed to upgrade controller.

Чтобы увеличить время ожидания обновления, используйте параметры времени ожидания --controller-timeout и --component-timeout , чтобы указать более высокие значения при выполнении обновления. Этот параметр доступен только с выпуска SQL Server 2019 CU2. For example:

azdata bdc upgrade -t 2019-CU19-ubuntu-20.04 --controller-timeout=40 --component-timeout=40 --stability-threshold=3

--controller-timeout указывает количество минут, чтобы дождаться завершения обновления контроллера или базы данных контроллера. --component-timeout указывает время завершения каждого последующего этапа обновления.

Чтобы увеличить время ожидания обновления до выпуска SQL Server 2019 CU19, измените карту конфигурации обновления. Чтобы изменить карту конфигурации обновления, выполните следующие действия.

Выполните следующую команду:

kubectl edit configmap controller-upgrade-configmap

Измените следующие поля:

controllerUpgradeTimeoutInMinutes Указывает время ожидания завершения обновления контроллера или базы данных контроллера. Значение по умолчанию — 5. Обновите версию по крайней мере до 20. totalUpgradeTimeoutInMinutes: указывает объединенный объем времени для контроллера и базы данных контроллера, чтобы завершить обновление (контроллер + обновление базы данных контроллера). Значение по умолчанию — 10. Обновите до не менее чем 40. componentUpgradeTimeoutInMinutes: указывает время завершения каждого последующего этапа обновления. Значение по умолчанию — 30. Обновление до 45.

Сохраните и выйдите.

Обновить развертывание BDC из CTP или кандидата на выпуск

Обновление на месте с версии CTP или кандидатской сборки кластеров больших данных SQL Server не поддерживается. В следующем разделе объясняется, как вручную удалить и повторно создать кластер.

Резервное копирование и удаление старого кластера

Для кластеров больших данных, развернутых до выпуска SQL Server 2019 GDR1, нет возможности обновления на месте. Единственным способом обновления до нового выпуска является удаление и повторное создание кластера вручную. Каждый выпуск имеет уникальную версию Azure Data CLI (azdata), несовместимую с предыдущей версией. Кроме того, если новый образ контейнера скачан в кластере, развернутом с другой более старой версией, последний образ может быть несовместим со старыми образами в кластере. Более новый образ загружается, если вы используете тег образа latest в файле конфигурации развертывания для параметров контейнера. По умолчанию каждый выпуск имеет определенный тег образа, соответствующий версии выпуска SQL Server. Чтобы обновить до последнего выпуска, выполните следующие действия.

Перед удалением старого кластера создайте резервную копию данных на главном экземпляре SQL Server и в HDFS. Для главного экземпляра SQL Server можно использовать резервное копирование и восстановление SQL Server. Для HDFS можно скопировать данные с curl помощью.
Удалите старый кластер с azdata delete cluster помощью команды.
```
 azdata bdc delete --name <old-cluster-name>
```
Important

Используйте версию Azure Data CLI (azdata), которая соответствует кластеру. Не удаляйте старый кластер с более новой версией Azure Data CLI (azdata).

Note

При выполнении команды все объекты, созданные в пространстве имен, идентифицированном именем кластера больших данных, будут удалены, но само пространство имен не будет удалено. Пространство имен можно повторно использовать для последующих развертываний, если оно пусто, и в нем не были созданы приложения.

Удалите старую версию Azure Data CLI (azdata).

pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt

Установите последнюю версию Azure Data CLI (azdata). Следующие команды устанавливают Azure Data CLI (azdata) из последнего выпуска:

Windows:
```
pip3 install -r https://aka.ms/azdata
```
Linux:
```
pip3 install -r https://aka.ms/azdata --user
```
Important

Для каждого релиза изменяется путь к n-1 версии Azure Data CLI (azdata). Даже если вы ранее установили Azure Data CLI (azdata), перед созданием нового кластера необходимо переустановить его из последнего пути.

Проверка версии azdata

Перед развертыванием нового кластера больших данных убедитесь, что вы используете последнюю версию Azure Data CLI (azdata) с параметром --version :

azdata --version

Установка нового выпуска

После удаления предыдущего кластера больших данных и установки последней версии Azure Data CLI (azdata) разверните новый кластер больших данных с помощью текущих инструкций по развертыванию. Дополнительные сведения см. в статье "Развертывание кластеров больших данных SQL Server в Kubernetes". Затем восстановите все необходимые базы данных или файлы.

Next steps

Дополнительные сведения о кластерах больших данных см. в разделе "Что такое кластеры больших данных SQL Server".

Last updated on 2023-03-07