Подключение к кластеру с помощью 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. Откройте Azure Cloud Shell, выбрав значок Cloud Shell в верхней строке меню.

   

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

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

4. В строке подключения замените {your_password} на ваш пароль кластера или токен Microsoft Entra ID, а затем нажмите клавишу Enter.

   

   Когда 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)
   

Следующие шаги

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

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