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

ОБЛАСТЬ ПРИМЕНЕНИЯ: База данных Azure для PostgreSQL — гибкий сервер

В этом кратком руководстве показано, как подключиться к База данных Azure для PostgreSQL гибкому экземпляру сервера с помощью Azure CLI и az postgres flexible-server connect выполнить один запрос или sql-файл с az postgres flexible-server execute помощью команды. С помощью этой команды можно проверить подключение к серверу базы данных и выполнить запросы. Вы также можете выполнить несколько запросов в интерактивном режиме.

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

• Учетная запись Azure с активной подпиской. Если у вас ее нет, получите бесплатную пробную версию.
• Установите последнюю версию Azure CLI .
• Войдите с помощью Azure CLI с az login помощью команды.
• (необязательно) Включите экспериментальный параметр сохраняемости с az config param-persist onпомощью . Сохраняемость параметров помогает использовать локальный контекст без необходимости повторять многочисленные аргументы, такие как группа ресурсов или расположение.

Создание гибкого экземпляра сервера База данных Azure для PostgreSQL

Первое, что нужно создать, — это управляемый База данных Azure для PostgreSQL гибкий экземпляр сервера. В Azure Cloud Shell выполните следующий сценарий и запишите имя сервера, **имя пользователя и пароль , созданный из этой команды.

az postgres flexible-server create --public-access <your-ip-address>

Вы можете указать дополнительные аргументы для этой команды, чтобы настроить ее. Ознакомьтесь со всеми аргументами для команды az postgres flexible-server create.

Просмотр всех аргументов

Вы можете просмотреть все аргументы для этой команды с помощью аргумента --help.

az postgres flexible-server connect --help

Проверка подключения к серверу базы данных

Вы можете проверить и проверить подключение к базе данных из среды разработки с помощью команды az postgres flexible-server connect .

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename>

Пример:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres

Вы увидите аналогичные выходные данные, если подключение выполнено успешно.

Successfully connected to server372060240.

Если подключение завершилось сбоем, проверьте следующие моменты:

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

Выполнение нескольких запросов в интерактивном режиме

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

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    --interactive

Пример:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive

Вы увидите интерфейс оболочки psql , как показано здесь:

Password for starchylapwing9:
Server: PostgreSQL 13.14
Version: 4.0.1
Home: http://pgcli.com
postgres> SELECT 1;
+----------+
| ?column? |
|----------|
| 1        |
+----------+
SELECT 1
Time: 0.167s
postgres>

Выполнение отдельных запросов

Вы можете выполнять отдельные запросы к базе данных Postgres с помощью az postgres flexible-server execute.

az postgres flexible-server execute \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    -q <querytext> --output table

Пример:

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -q "SELECT 1" --output table

Вы увидите выходные данные, как показано здесь:

Successfully connected to server372060240.
Ran Database Query: 'SELECT 1'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to server372060240
?column?
----------
1

Выполнение файла SQL

Вы можете выполнить sql-файл с помощью команды az postgres flexible-server execute с помощью --file-path аргумента. -f

az postgres flexible-server execute \
    -n <server-name> -u <username> -p "<password>" -d <database-name> \
    --file-path "<file-path>"

Пример. Подготовка test.sql файла. С простыми SELECT запросами можно использовать следующий тестовый скрипт:

SELECT 1;
SELECT 2;
SELECT 3;

Сохраните содержимое test.sql в текущем каталоге и выполните следующую команду.

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -f "test.sql"

Вы увидите выходные данные, как показано здесь:

Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240

Next Steps

Управление сервером