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

Это важно

Azure Cosmos DB для PostgreSQL больше не поддерживается для новых проектов. Не используйте эту службу для новых проектов. Вместо этого используйте одну из этих двух служб:

• Используйте Azure Cosmos DB для NoSQL как распределенное решение базы данных, предназначенное для крупномасштабных сценариев с соглашением об уровне доступности (SLA) 99.999%, мгновенным автомасштабированием и автоматическим переключением в случае отказа в нескольких регионах.

• Используйте функцию эластичных кластеров Базы данных Azure для PostgreSQL для сегментированного PostgreSQL с помощью расширения Citus с открытым кодом.

В этом кратком руководстве показано, как использовать строку подключения 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)
   

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

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

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