Tous les produits
Search
Centre de documentation

Hologres:PSQL client

Dernière mise à jour :Aug 11, 2026

Hologres est compatible avec l'écosystème PostgreSQL. Vous pouvez ainsi vous connecter à Hologres avec la plupart des outils de développement ou de business intelligence (BI) prenant en charge PostgreSQL. Utilisez vos outils préférés pour créer rapidement un entrepôt de données en temps réel de niveau entreprise. Cette rubrique explique comment se connecter à une instance Hologres à l'aide d'un client PostgreSQL et utiliser des instructions SQL standard pour le développement de données.

Installer le client PSQL

Téléchargez et installez le client PostgreSQL depuis le site officiel avant de l'utiliser. Si le client est déjà installé, ignorez cette section.

  1. Télécharger le client PostgreSQL

    Accédez au site officiel de PostgreSQL pour télécharger le programme d'installation de PostgreSQL version 11 ou ultérieure correspondant à votre système d'exploitation. Suivez ensuite les instructions à l'écran pour terminer l'installation.

  2. Configurer les variables d'environnement

    • Sous Windows :

      1. Dans la fenêtre System Properties > Advanced, cliquez sur Environment Variables.

      2. Ajoutez le chemin d'accès au répertoire bin de PostgreSQL à la variable Path. Dans la section System variables, recherchez et sélectionnez la variable Path, puis cliquez sur Edit....

      3. Cliquez sur OK.

    • Sous macOS, il n'est généralement pas nécessaire de configurer les variables d'environnement. Si nécessaire, consultez la documentation Set Up Environment Variables.

Se connecter à Hologres et développer des données

Une fois le client PostgreSQL installé, connectez-vous à votre instance Hologres et commencez le développement de données.

  1. Se connecter à l'instance Hologres

    Ouvrez l'interface de ligne de commande du client PostgreSQL et saisissez les informations de connexion. La syntaxe est identique à celle d'une connexion à une base de données PostgreSQL standard.

    • Sous Linux, exécutez la commande suivante.

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

      Lorsque vous y êtes invité, saisissez votre 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=>
    • Sous macOS, exécutez la commande suivante.

      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=#
    • Sous Windows, le client vous demande interactivement les détails de la connexion.

      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=#

    Parameter

    Description

    AccessKey ID

    • Compte Alibaba Cloud : AccessKey ID de votre compte Alibaba Cloud. Vous pouvez obtenir l'AccessKey ID sur la page AccessKey Management.

    • Compte personnalisé : nom d'utilisateur du compte personnalisé. Exemple : BASIC$abc.

    AccessKey Secret

    • Compte Alibaba Cloud : AccessKey Secret de votre compte Alibaba Cloud.

    • Compte personnalisé : mot de passe du compte personnalisé.

    Port

    Port du réseau public ou du VPC (Virtual Private Cloud) de l'instance Hologres.

    Exemple : 80.

    Remarque

    Pour plus d'informations sur le point de terminaison public, consultez les Instance Details.

    Endpoint

    Point de terminaison du réseau public ou du VPC (Virtual Private Cloud) de l'instance Hologres.

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

    Remarque

    Pour plus d'informations sur le point de terminaison public, consultez les Instance Details.

    Database

    Nom de la base de données Hologres.

    Après la création d'une instance Hologres, une base de données nommée postgres est automatiquement créée.

    Vous pouvez utiliser la base de données postgres pour vous connecter à Hologres. Toutefois, ses ressources sont limitées. Pour les charges de travail de production, nous vous recommandons de créer une nouvelle base de données. Pour plus d'informations, consultez la section Créer une base de données.

    Exemple : mydb.

    Exemples

    • Connexion avec un compte 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=#
    • Connexion avec un compte personnalisé :

      • Si le nom d'utilisateur personnalisé est abc, créez-le dans HoloWeb. Dans la barre de navigation supérieure, choisissez security center. Dans le volet de navigation de gauche, cliquez sur user management. Après avoir sélectionné l'instance cible, affichez la liste des utilisateurs. Cette liste inclut les membres, les comptes cloud, les types de compte et les types de rôle. Dans le coin supérieur droit, cliquez sur Create Custom User pour ajouter un compte BASIC. Le nom du compte doit respecter le format BASIC$<user_name> et le type de rôle est défini par défaut sur SuperUser après la création.

      • Exécutez la commande suivante pour vous connecter :

        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=#
    Remarque

    Vous pouvez également utiliser d'autres outils de développement familiers pour vous connecter à Hologres, tels que DataWorks ou HoloWeb. Pour plus d'informations, consultez les rubriques Prise en main de DataWorks ou Se connecter à HoloWeb et exécuter des requêtes.

  2. (Facultatif) Créer une base de données

    Après la création d'une instance Hologres, une base de données nommée postgres est automatiquement créée. Ses ressources sont limitées et elle est destinée uniquement aux tâches opérationnelles et de gestion. Pour les charges de travail de développement et de production, nous vous recommandons de créer une nouvelle base de données.

    Remarque

    Si vous avez déjà créé une base de données pour votre activité, ignorez cette étape.

    • Syntaxe :

      CREATE Database <DatabaseName>;

      DatabaseName correspond au nom de la base de données à créer.

    • Exemple :

      -- Create a database named test.
      CREATE Database test; 
  3. Développer des données

    Utilisez des instructions SQL PostgreSQL standard dans le client PostgreSQL pour le développement de données.

    L'exemple suivant montre comment créer une table dans la base de données et y insérer des données :

    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;

    Développez des jobs en fonction de votre cas d'utilisation. Voici quelques exemples :