Conexión a un clúster en Azure Cosmos DB for PostgreSQL

SE APLICA A: Azure Cosmos DB for PostgreSQL (con tecnología de la extensión de base de datos de Citus en PostgreSQL)

Elija uno de los clientes de base de datos a continuación para ver cómo configurarlo para conectarse a un clúster de Azure Cosmos DB for PostgreSQL.

pgAdmin

pgAdmin es una plataforma de administración y desarrollo de código abierto popular y con numerosas características para PostgreSQL.

1. Descargue e instale pgAdmin.

2. Abra la aplicación pgAdmin en el equipo cliente. En el panel, seleccione Agregar nuevo servidor.

   

3. En la pestaña General, elija un nombre. Cualquier nombre servirá.

   

4. Escriba los detalles de la conexión en la pestaña Conexión.

   

   Personalice estos campos:

   • Nombre de host/dirección: obtenga este valor en la página Información general del clúster en Azure Portal. Ahí aparece como el nombre del coordinador. Tendrá el formato c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Base de datos de mantenimiento: utilice el valor citus.
   • Nombre de usuario: utilice el valor citus.
   • Contraseña: la contraseña de conexión o el token de Microsoft Entra ID. Para obtener más información, consulte opciones de autenticación.
   • Guardar contraseña: habilite esta opción si lo desea.

5. En la pestaña SSL, establezca el modo SSL en Requerir.

   

6. Seleccione Guardar para guardar la conexión y conectarse a la base de datos.

psql

La utilidad psql es un front-end basado en terminal para PostgreSQL. Te permite escribir consultas de forma interactiva, emitirlas a PostgreSQL y ver los resultados de la consulta.

1. Instale psql. Está incluido en una instalación de PostgreSQL, o bien disponible por separado en administradores de paquetes para varios sistemas operativos.

2. En Azure Portal, en la página del clúster, seleccione el elemento de menú Cadenas de conexión y, luego, copie la cadena de conexión de psql.

   

   La cadena psql tiene el formato psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Observe que el nombre de host comienza con c-, por ejemplo, c-demo.12345678901234.postgres.cosmos.azure.com. Este prefijo indica el nodo de coordinación del clúster. El valor predeterminado de dbname y username es citus y no se puede cambiar.

3. En la cadena de conexión que copió, reemplace <your_password> por su contraseña de conexión o el token de Microsoft Entra ID. Para obtener más información, consulte opciones de autenticación.

4. En el símbolo del sistema de un terminal local, pegue la cadena de conexión psql y, a continuación, presione Entrar.

Pasos siguientes

• Solución de problemas de conexión.
• Comprobación de los certificados TLS en las conexiones.
• Ahora que puede conectarse a la base de datos, aprenda a compilar aplicaciones escalables.