Todos os produtos
Search
Central de documentação

Hologres:Cliente PSQL

Última atualização: Jun 28, 2026

O Hologres é compatível com o ecossistema PostgreSQL, permitindo a conexão por meio da maioria das ferramentas de desenvolvimento ou business intelligence (BI) que suportam esse banco de dados. Utilize suas ferramentas preferidas para construir rapidamente um data warehouse em tempo real de nível empresarial. Este tópico descreve como se conectar a uma instância do Hologres com um cliente PostgreSQL e usar instruções padrão para desenvolver dados.

Instale o cliente PSQL

Antes de usar um cliente PostgreSQL, baixe-o e instale-o no site oficial. Se o cliente já estiver instalado, ignore esta seção.

  1. Baixe o cliente PostgreSQL

    Acesse o site oficial do PostgreSQL para baixar o instalador da versão 11 ou superior do PostgreSQL correspondente ao seu sistema operacional. Em seguida, siga as instruções na tela para concluir a instalação.

  2. Defina as variáveis de ambiente

    • No Windows:

      1. Na janela System Properties > Advanced, clique em Environment Variables.

      2. Adicione o caminho do diretório bin do PostgreSQL à variável Path. Na seção System variables, localize e selecione a variável Path e clique em Edit....

      3. Clique em OK.

    • No macOS, geralmente não é necessário definir variáveis de ambiente. Se precisar, consulte Set Up Environment Variables.

Conectar ao Hologres e desenvolver dados

Após instalar o cliente PostgreSQL, conecte-se à sua instância do Hologres e inicie o desenvolvimento de dados.

  1. Conecte-se à instância do Hologres

    Abra a interface de linha de comando do cliente PostgreSQL e insira as informações de conexão. A sintaxe é idêntica à usada para conectar-se a um banco de dados PostgreSQL padrão.

    • No Linux, execute o seguinte comando:

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

      Quando solicitado, insira seu 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=>
    • No macOS, execute o seguinte 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=#
    • No Windows, o cliente solicita os detalhes de conexão interativamente:

      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

    Descrição

    AccessKey ID

    • Conta Alibaba Cloud: AccessKey ID da sua conta Alibaba Cloud. Obtenha o AccessKey ID na página AccessKey Management.

    • Conta personalizada: nome de usuário da conta personalizada. Exemplo: BASIC$abc.

    AccessKey Secret

    • Conta Alibaba Cloud: AccessKey Secret da sua conta Alibaba Cloud.

    • Conta personalizada: senha da conta personalizada.

    Port

    Porta de rede pública ou de Virtual Private Cloud (VPC) da instância do Hologres.

    Exemplo: 80.

    Nota

    Para mais informações sobre o endpoint público, consulte Instance Details.

    Endpoint

    Endpoint de rede pública ou de Virtual Private Cloud (VPC) da instância do Hologres.

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

    Nota

    Para mais informações sobre o endpoint público, consulte Instance Details.

    Database

    Nome do banco de dados do Hologres.

    Ao criar uma instância do Hologres, o sistema cria automaticamente um banco de dados chamado postgres.

    Use o banco de dados postgres para se conectar ao Hologres. No entanto, como esse banco possui recursos limitados, recomendamos criar um novo banco de dados para cargas de trabalho de produção. Para mais informações, consulte Criar um banco de dados.

    Exemplo: mydb.

    Exemplos:

    • Login com conta 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=#
    • Login com conta personalizada:

      • Se o nome de usuário personalizado for abc, crie-o no HoloWeb. Na barra de navegação superior, escolha security center. No painel de navegação à esquerda, clique em user management. Após selecionar a instância desejada, visualize a lista de usuários, que inclui membros, contas na nuvem, tipos de conta e tipos de função. No canto superior direito, clique em Create Custom User para adicionar uma conta BASIC. O nome da conta deve seguir o formato BASIC$<user_name>, e o tipo de função será definido como SuperUser por padrão após a criação.

      • Execute o seguinte comando para fazer login:

        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

    Você também pode usar outras ferramentas de desenvolvimento de sua preferência para se conectar ao Hologres, como DataWorks ou HoloWeb. Para mais informações, consulte Introdução ao DataWorks ou Conectar ao HoloWeb e executar consultas.

  2. (Opcional) Crie um banco de dados

    Ao criar uma instância do Hologres, o sistema gera automaticamente um banco de dados chamado postgres. Esse banco possui recursos limitados e destina-se apenas a tarefas operacionais e de gerenciamento. Para cargas de trabalho de desenvolvimento e produção, recomendamos criar um novo banco de dados.

    Nota

    Se você já criou um banco de dados para seus negócios, pule esta etapa.

    • Sintaxe:

      CREATE Database <DatabaseName>;

      DatabaseName é o nome do banco de dados a ser criado.

    • Exemplo:

      -- Create a database named test.
      CREATE Database test; 
  3. Desenvolva dados

    Use instruções padrão do PostgreSQL no cliente PostgreSQL para desenvolver dados.

    O exemplo a seguir mostra como criar uma tabela no banco de dados e inserir dados nela:

    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;

    Desenvolva jobs conforme o seu caso de uso. Exemplos: