Conexión a un clúster con psql - 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)

En este inicio rápido se muestra cómo usar la cadena de conexión de psql en Azure Cloud Shell para conectarse a un clúster de Azure Cosmos DB for PostgreSQL.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Si no tiene ninguna cuenta, cree una gratuita.
• Un clúster de Azure Cosmos DB for PostgreSQL. Para crear un clúster, consulte Creación de un clúster en Azure Portal.

Conectar

El clúster tiene una base de datos predeterminada llamada citus. Para conectarse a la base de datos, usará una cadena de conexión y la contraseña de administrador.

1. 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-<cluster>.<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-mycluster.12345678901234.postgres.cosmos.azure.com. Este prefijo indica el nodo de coordinación del clúster. El valor predeterminado dbname es citus y solo se puede cambiar en el momento del aprovisionamiento del clúster. El user puede ser cualquier función Postgres válida en el clúster.

2. Abra Azure Cloud Shell; para ello, seleccione el icono de Cloud Shell en la barra de menús superior.

   

   Si se le solicita, elija una suscripción de Azure en la que almacenar datos de Cloud Shell.

3. Pegue la cadena de conexión de psql en el shell.

4. En la cadena de conexión, reemplace {your_password} por la contraseña del clúster o el token de Microsoft Entra ID y luego pulse Entrar.

   

   Cuando psql se conecta correctamente a la base de datos, aparece un nuevo mensaje citus=> (o el nombre personalizado de la base de datos):

   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. Ejecute una consulta de prueba. Pegue el siguiente comando en el símbolo del sistema de psql y presione Entrar.

   SHOW server_version;
   

   Debería ver un resultado que coincide con la versión de PostgreSQL que seleccionó durante la creación del clúster. Por ejemplo:

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

Pasos siguientes

Ahora que se ha conectado al clúster, el siguiente paso es crear tablas y particionarlas para el escalado horizontal.

Creación y distribución de tablas>