Краткое руководство. Создание базы данных в службе "База данных Azure для PostgreSQL — отдельный сервер" с помощью команды Azure CLI az postgres up (предварительная версия)

Важно!

Команда az postgres up Azure CLI находится в предварительной версии.

База данных Azure для PostgreSQL является управляемой службой, которая позволяет запускать и масштабировать высокодоступные базы данных PostgreSQL, а также управлять ими в облаке. Azure CLI используется для создания ресурсов Azure и управления ими из командной строки или с помощью скриптов. В этом кратком руководстве описывается, как с помощью команды az postgres up создать сервер Базы данных Azure для PostgreSQL, используя Azure CLI. Кроме сервера, команда az postgres up создает пример базы данных, привилегированного пользователя в базе данных, открывает брандмауэр для служб Azure и создает правила брандмауэра по умолчанию для клиентского компьютера. Это позволяет ускорить процесс разработки.

Предварительные требования

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

Для этой статьи требуется запустить локально Azure CLI версии 2.0 или более поздней. Чтобы узнать, какая установлена версия, выполните команду az --version. Если вам необходимо выполнить установку или обновление, см. статью Установка Azure CLI 2.0.

Вам потребуется войти в учетную запись с помощью команды az login. Запишите свойство ID из выходных данных команды для соответствующего имени подписки.

az login

Если вы используете несколько подписок, выберите соответствующую, в которой за ресурс будет взиматься плата. Выберите конкретный идентификатор подписки вашей учетной записи, выполнив команду az account set. Подставьте свойство subscription ID из выходных данных az login для своей подписки в заполнитель для идентификатора подписки.

az account set --subscription <subscription id>

Создание сервера Базы данных Azure для PostgreSQL

Чтобы использовать команды, установите расширение db-up. Если возникает ошибка, убедитесь, что вы установили последнюю версию Azure CLI. Дополнительные сведения см. в статье Установка Azure CLI.

az extension add --name db-up

Чтобы создать сервер Базы данных Azure для PostgreSQL, выполните следующую команду:

az postgres up

Сервер создается с приведенными ниже значениями по умолчанию (если вы вручную их не переопределите).

Параметр Значение по умолчанию Описание
server-name Генерируемое системой Уникальное имя, идентифицирующее базу данных Azure для сервера PostgreSQL.
resource-group Генерируемое системой Новая группа ресурсов Azure.
sku-name GP_Gen5_2 Имя номера SKU. В сокращенной записи соответствует схеме {ценовая категория}_{поколение вычислительных ресурсов}_{число виртуальных ядер}. По умолчанию — это сервер общего назначения 5-го поколения с 2 виртуальными ядрами. Сведения об уровнях можно получить на странице расценок.
backup-retention 7 Время хранения резервной копии. Указывается в днях.
geo-redundant-backup Выключено Позволяет включить или отключить создание геоизбыточных резервных копий для этого сервера.
location westus2 Расположение сервера в Azure.
ssl-enforcement Выключено Позволяет включить или отключить TLS либо SSL для этого сервера.
storage-size 5120 Объем хранилища сервера (в мегабайтах).
version 10 Основной номер версии PostgreSQL.
admin-user Генерируемое системой Имя пользователя администратора.
admin-password Генерируемое системой Пароль администратора.

Примечание

Дополнительные сведения о команде az postgres up и ее дополнительных параметрах см. в документации по Azure CLI.

Сервер создается со следующими параметрами.

  • Создается правило брандмауэра devbox. Azure CLI пытается определить IP-адрес компьютера, с которого выполняется команда az postgres up, и разрешает доступ к этому IP-адресу.
  • Параметру "Разрешить доступ к службам Azure" задано значение "Вкл." Этот параметр настраивает брандмауэр сервера на прием подключений от всех ресурсов Azure, включая ресурсы вне вашей подписки.
  • Создается пустая база данных с именем sampledb.
  • В sampledb создается привилегированный пользователь с именем root.

Примечание

Базы данных Azure для PostgreSQL обменивается данными через порт 5432. При попытках подключения из корпоративной сети может оказаться, что исходящий трафик через порт 5432 запрещен сетевым брандмауэром. Чтобы вы могли подключиться к серверу, ваш ИТ-отдел должен открыть порт 5432.

Получение сведений о подключении

После выполнения команды az postgres up вам возвращается список строк подключения для распространенных языков программирования. Эти строки подключения предварительно настроены с использованием определенных атрибутов созданного сервера Базы данных Azure для PostgreSQL.

Чтобы еще раз перечислить строки подключения, вы можете использовать команду az postgres show-connection-string.

Очистка ресурсов

Очистите все ресурсы, созданные при работе с кратким руководством, с помощью следующей команды. Эта команда удаляет сервер Базы данных Azure для PostgreSQL и группу ресурсов.

az postgres down --delete-group

Если вы хотите удалить созданный сервер, выполните команду az postgres down.

az postgres down

Дальнейшие действия