Todos los productos
Search
Centro de documentos

Hologres:PSQL client

Última actualización: Sep 05, 2026

Hologres es compatible con el ecosistema de PostgreSQL. Esto le permite conectarse a Hologres con la mayoría de las herramientas de desarrollo o de inteligencia empresarial (BI) que admiten PostgreSQL. Puede usar sus herramientas preferidas para construir rápidamente un almacén de datos en tiempo real de nivel empresarial. En este tema se describe cómo conectarse a una instancia de Hologres mediante un cliente de PostgreSQL y utilizar comandos estándar de PostgreSQL para desarrollar datos.

Instalar el cliente PSQL

Antes de usar un cliente de PostgreSQL, debe descargarlo e instalarlo desde el sitio web oficial. Si ya instaló el cliente, omita esta sección.

  1. Descargue el cliente de PostgreSQL

    Vaya al sitio web oficial de PostgreSQL para descargar el instalador de PostgreSQL versión 11 o posterior que corresponda a su sistema operativo. Después, siga las instrucciones en pantalla para completar la instalación.

  2. Establezca las variables de entorno

    • Para Windows:

      1. En la ventana System Properties > Advanced, haga clic en Environment Variables.

      2. Agregue la ruta del directorio bin de PostgreSQL a la variable Path. En la sección System variables, busque y seleccione la variable Path y, después, haga clic en Edit....

      3. Haga clic en OK.

    • En macOS, por lo general no es necesario establecer variables de entorno. Si lo requiere, consulte Set Up Environment Variables.

Conectarse a Hologres y desarrollar datos

Una vez instalado el cliente de PostgreSQL, puede conectarse a su instancia de Hologres y comenzar a desarrollar datos.

  1. Conéctese a la instancia de Hologres

    Abra la interfaz de línea de comandos del cliente de PostgreSQL e introduzca la información de conexión. La sintaxis es la misma que se usa para conectarse a una base de datos estándar de PostgreSQL.

    • En Linux, ejecute el siguiente comando.

      psql -h <Endpoint> -p <Port> -U <AccessKey ID> -d <Database>

      Cuando el sistema lo solicite, introduzca su AccessKey Secret.

      [postgres@iZj6cclqj7ttfq2f8stlgpZ ~]$
      [postgres@iZj6cclqj7ttfq2f8stlgpZ ~]$
      [postgres@iZj6cclqj7ttfq2f8stlgpZ ~]$ psql -h xxx-xxx-xxx-xxx.hologres.aliyuncs.com -p 80 -U LTAIxxx-xxx -d testdb
      Password for user xxx:
      psql (12.3, server 11.3)
      Type "help" for help.
      testdb=>
      testdb=>
      testdb=>
      testdb=>
      testdb=>
    • En macOS, ejecute el siguiente comando.

      PGUSER=<AccessKey ID> PGPASSWORD=<AccessKey Secret> psql -p <Port> -h <Endpoint> -d <Database>
      PGUSER=xxx PGPASSWORD=xxx psql -p 80 -h xxx.hologres.aliyuncs.com -d mydb
      psql (11.4, server 11.3)
      Type "help" for help.
      mydb=#
    • En Windows, el cliente le solicita los detalles de conexión de forma interactiva.

      Server [localhost]: Endpoint
      Database [postgres]: Database
      Port [5432]: Port
      Username [postgres]: <AccessKey ID>
      Password for user <AccessKey ID>: <AccessKey Secret>
      Server [localhost]: Endpoint
      Database [postgres]: Database
      Port [5432]: 80
      Username [postgres]: <AccessKey ID>
      Password for user <AccessKey ID>:
      psql (11.8, server 11.3)
      Type "help" for help.
      postgres=#

    Parámetro

    Descripción

    AccessKey ID

    • Cuenta de Alibaba Cloud: el AccessKey ID de su cuenta de Alibaba Cloud. Puede obtener el AccessKey ID en la página AccessKey Management.

    • Cuenta personalizada: el nombre de usuario de la cuenta personalizada. Ejemplo: BASIC$abc.

    AccessKey Secret

    • Cuenta de Alibaba Cloud: el AccessKey Secret de su cuenta de Alibaba Cloud.

    • Cuenta personalizada: la contraseña de la cuenta personalizada.

    Port

    El puerto de red pública o de virtual private cloud (VPC) de la instancia de Hologres.

    Ejemplo: 80.

    Nota

    Para más información sobre el endpoint público, consulte Instance Details.

    Endpoint

    El endpoint de red pública o de virtual private cloud (VPC) de la instancia de Hologres.

    Ejemplo: xxx-cn-hangzhou.hologres.aliyuncs.com.

    Nota

    Para más información sobre el endpoint público, consulte Instance Details.

    Database

    El nombre de la base de datos de Hologres.

    Después de crear una instancia de Hologres, se crea automáticamente una base de datos llamada postgres.

    Puede usar la base de datos postgres para conectarse a Hologres. Sin embargo, esta base de datos tiene recursos limitados. Para cargas de trabajo de producción, se recomienda crear una base de datos nueva. Para más información, consulte Create a database.

    Ejemplo: mydb.

    Ejemplos

    • Inicie sesión con una cuenta de Alibaba Cloud:

      PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo
      PGUSER="LTAIxxx" PGPASSWORD="xT6qxxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo
      psql (14.2, server 11.3)
      Type "help" for help.
      demo=#
    • Inicie sesión con una cuenta personalizada:

      • Si el nombre de usuario personalizado es abc, puede crearlo en HoloWeb. En la barra de navegación superior, elija security center. En el panel de navegación izquierdo, haga clic en user management. Una vez seleccionada la instancia de destino, podrá consultar la lista de usuarios. Esta lista incluye miembros, cuentas en la nube, tipos de cuenta y tipos de rol. En la esquina superior derecha, haga clic en Create Custom User para agregar una cuenta BASIC. El nombre de la cuenta debe tener el formato BASIC$<user_name> y, tras su creación, el tipo de rol será SuperUser de manera predeterminada.

      • Ejecute el siguiente comando para iniciar sesión:

        PGUSER="BASIC\$abc" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo
        PGUSER="BASIC\$abc" PGPASSWORD="1xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo
        psql (14.2, server 11.3)
        Type "help" for help.
        demo=#
    Nota

    También puede usar otras herramientas de desarrollo con las que esté familiarizado para conectarse a Hologres, como DataWorks o HoloWeb. Para más información, consulte Get started with DataWorks o Connect to HoloWeb and run queries.

  2. (Opcional) Cree una base de datos

    Después de crear una instancia de Hologres, se crea automáticamente una base de datos llamada postgres. Esta base de datos tiene recursos limitados y está diseñada únicamente para tareas operativas y de gestión. Para cargas de trabajo de desarrollo y producción, se recomienda crear una base de datos nueva.

    Nota

    Si ya creó una base de datos para su negocio, omita este paso.

    • Sintaxis:

      CREATE Database <DatabaseName>;

      DatabaseName es el nombre de la base de datos que desea crear.

    • Ejemplo:

      -- Create a database named test.
      CREATE Database test; 
  3. Desarrolle datos

    Utilice comandos estándar de PostgreSQL en el cliente de PostgreSQL para desarrollar datos.

    A continuación se muestra un ejemplo de cómo crear una tabla en la base de datos e insertarle datos:

    BEGIN;
    CREATE TABLE nation (
      n_nationkey bigint NOT NULL,
      n_name text NOT NULL,
      n_regionkey bigint NOT NULL,
      n_comment text NOT NULL,
      PRIMARY KEY (n_nationkey)
    );
    CALL SET_TABLE_PROPERTY('nation', 'bitmap_columns', 'n_nationkey,n_name,n_regionkey');
    CALL SET_TABLE_PROPERTY('nation', 'dictionary_encoding_columns', 'n_name,n_comment');
    CALL SET_TABLE_PROPERTY('nation', 'time_to_live_in_seconds', '31536000');
    COMMIT;
    INSERT INTO nation VALUES
    (11,'zRAQ', 4,'nic deposits boost atop the quickly final requests? quickly regula'),
    (22,'RUSSIA', 3  ,'requests against the platelets use never according to the quickly regular pint'),
    (2,'BRAZIL',  1 ,'y alongside of the pending deposits. carefully special packages are about the ironic forges. slyly special '),
    (5,'ETHIOPIA',  0 ,'ven packages wake quickly. regu'),
    (9,'INDONESIA', 2  ,'slyly express asymptotes. regular deposits haggle slyly. carefully ironic hockey players sleep blithely. carefull'),
    (14,'KENYA',  0  ,'pending excuses haggle furiously deposits. pending, express pinto beans wake fluffily past t'),
    (3,'CANADA',  1 ,'eas hang ironic, silent packages. slyly regular packages are furiously over the tithes. fluffily bold'),
    (4,'EGYPT', 4 ,'y above the carefully unusual theodolites. final dugouts are quickly across the furiously regular d'),
    (7,'GERMANY', 3 ,'l platelets. regular accounts x-ray: unusual, regular acco'),
    (20 ,'SAUDI ARABIA',  4 ,'ts. silent requests haggle. closely express packages sleep across the blithely');
    SELECT * FROM nation;

    Puede desarrollar trabajos según su caso de uso. A continuación se presentan algunos ejemplos: