Подключение к кластеру с помощью psql — Azure Cosmos DB для PostgreSQL

ПРИМЕНИМО К: Azure Cosmos DB для PostgreSQL (на базе расширения базы данных Citus для PostgreSQL)

В этом кратком руководстве показано, как использовать строку подключения psql в Azure Cloud Shell для подключения к кластеру Azure Cosmos DB для PostgreSQL.

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

• Учетная запись Azure с активной подпиской. Если у вас ее нет, создайте учетную запись бесплатно.
• Кластер Azure Cosmos DB для PostgreSQL. Сведения о создании кластера см. в статье Создание кластера в портал Azure.

Подключение

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

1. На странице кластера портал Azure выберите пункт меню Строки подключения и скопируйте строку подключения psql.

   

   Строка psql имеет вид psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". Обратите внимание, что имя узла начинается с c., например c-mycluster.12345678901234.postgres.cosmos.azure.com. Этот префикс указывает узел-координатор кластера. Значение по умолчанию dbname — citus и может быть изменено только во время подготовки кластера. Может user быть любой допустимой ролью Postgres в кластере.

2. Откройте Cloud Shell Azure, щелкнув значок Cloud Shell в верхней строке меню.

   

   При появлении запроса выберите подписку Azure, в которой будут храниться данные Cloud Shell.

3. Вставьте строку подключения psql в оболочку.

4. В строке подключения замените {your_password} паролем кластера и нажмите клавишу ВВОД.

   

   После успешного подключения psql к базе данных отображается новый citus=> (или пользовательское имя базы данных) запрос:

   psql (14.2, server 14.5)
   SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
   Type "help" for help.
   
   citus=>
   

5. Выполните тестовый запрос. Вставьте следующую команду в строку psql и нажмите клавишу ВВОД.

   SHOW server_version;
   

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

    server_version
   ----------------
    14.5
   (1 row)
   

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

Теперь, когда вы подключились к кластеру, необходимо создать таблицы и сегментировать их для горизонтального масштабирования.

Создание и распределение таблиц >