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

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

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: База данных 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 Database for 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

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