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

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

Предпосылки

  • Учетная запись Azure с активной подпиской. Если у вас ее нет, получите бесплатную пробную версию.
  • Установите последнюю версию Azure CLI.
  • Войдите в систему с помощью команды az login в Azure CLI.
  • (необязательно) Включите экспериментальный параметр сохраняемости с помощью 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>

Example:

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

Example:

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>

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

Используйте az postgres flexible-server execute для выполнения отдельных запросов к базе данных Postgres.

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

Example:

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-файла

Используйте команду az postgres flexible-server execute с аргументом --file-path , -fчтобы выполнить SQL-файл.

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

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

  • Last updated on