Подключение к кластеру в Azure Cosmos DB для PostgreSQL

Применяется к: ✅ PostgreSQL

Это важно

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

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

Выберите один из следующих клиентов базы данных, чтобы узнать, как настроить его для подключения к кластеру Azure Cosmos DB для PostgreSQL.

pgAdmin.
psql

pgAdmin — это популярная и многофункциональная платформа администрирования и разработки с открытым кодом для PostgreSQL.

Скачайте и установите pgAdmin.
Откройте приложение pgAdmin на клиентском компьютере. На панели мониторинга выберите Добавить новый сервер.
Выберите Имя на вкладке "Общие". Можно указать любое имя.
Введите сведения о подключении на вкладке "Подключение".

Настройте следующие поля:
- Имя узла или адрес: Получите это значение на странице обзора кластера в портале Azure. Оно указано там как Имя координатора. Будет иметь форму c-<clustername>.12345678901234.postgres.cosmos.azure.com.
- База данных обслуживания — используйте значение citus.
- Имя пользователя — используйте значение citus.
- Пароль: пароль подключения или маркер идентификатора Microsoft Entra. Дополнительные сведения см. в разделе "Параметры проверки подлинности".
- Сохранить пароль — включите при необходимости.
На вкладке SSL задайте для параметра Режим SSL значение Обязательно.
Нажмите Сохранить, чтобы сохранить настройки и подключиться к базе данных.

Служебная программа psql — это интерфейс на основе терминала для PostgreSQL. Он позволяет интерактивно вводить запросы, отправлять их к PostgreSQL и просматривать их результаты.

Установите psql. Эта программа входит в состав установки PostgreSQL или доступна отдельно в диспетчерах пакетов для нескольких операционных систем.
В портале Azure на странице кластера выберите пункт меню «Строки подключения», а затем скопируйте строку подключения psql.

Строка psql имеет форму psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Обратите внимание, что имя узла начинается с c-примера c-demo.12345678901234.postgres.cosmos.azure.com. Этот префикс указывает узел координатора кластера. Значение по умолчанию dbname и usernamecitus не может быть изменено.
В скопированной строке подключения замените <your_password> на пароль подключения или маркер идентификатора Microsoft Entra. Дополнительные сведения см. в разделе "Параметры проверки подлинности".
В командной строке локального терминала вставьте psql строку подключения и нажмите клавишу ВВОД.

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-10-30

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

Подключение к кластеру в Azure Cosmos DB для PostgreSQL

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

Обратная связь

Дополнительные ресурсы