全部产品
Search

搜索本产品

    Hologres：PSQL client

    文档中心

    Hologres：PSQL client

    更新时间：Feb 04, 2026

    Hologres kompatibel dengan ekosistem PostgreSQL. Sebagian besar alat pengembangan dan BI yang mendukung PostgreSQL dapat langsung terhubung ke Hologres. Gunakan alat pilihan Anda untuk membangun gudang data real-time tingkat enterprise secara cepat. Topik ini menjelaskan cara menghubungkan ke Hologres menggunakan PSQL client dan mengembangkan data dengan pernyataan PostgreSQL standar.

    Instal PSQL client

    Sebelum menggunakan PSQL client, unduh dan instal dari situs resmi. Jika PSQL client sudah terinstal, Anda dapat melewati bagian ini. Langkah-langkah instalasinya sebagai berikut.

    1. Unduh PSQL client

      Kunjungi situs resmi Postgres. Unduh paket instalasi client untuk PostgreSQL versi 11 atau lebih baru yang sesuai dengan sistem operasi Anda, lalu ikuti petunjuk instalasinya.

    2. Atur variabel lingkungan

      • Sistem Windows.

        1. Pada halaman System Properties > Advanced system settings, klik Environment Variables.

        2. Tambahkan path ke direktori bin PostgreSQL ke variabel Path.

        3. Klik OK.

      • Untuk macOS, biasanya Anda tidak perlu mengatur variabel lingkungan. Untuk informasi selengkapnya, lihat Set Environment Variables.

    Hubungkan ke Hologres dan kembangkan

    Setelah mengunduh dan menginstal PSQL client, hubungkan ke instans Hologres untuk mengembangkan data.

    1. Hubungkan ke Hologres

      Buka antarmuka baris perintah PSQL client dan masukkan informasi koneksi. Sintaksnya sama seperti saat menghubungkan ke database PostgreSQL.

      • Pernyataan untuk Linux adalah sebagai berikut.

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

        Setelah mengeksekusi pernyataan tersebut, masukkan Rahasia AccessKey.

        LIN

      • Pernyataan untuk macOS adalah sebagai berikut.

        PGUSER=<AccessKey ID> PGPASSWORD=<AccessKey Secret> psql -p <Port> -h <Endpoint> -d <Database>

        linux

      • Pernyataan untuk Windows adalah sebagai berikut.

        Server [localhost]: Endpoint
Database [postgres]: Database
Port [5432]: Port
Username [postgres]: <AccessKey ID>
Password for user <AccessKey ID>: <AccessKey Secret>

      Parameter

      Deskripsi

      ID AccessKey

      • Akun Alibaba Cloud: ID AccessKey akun Alibaba Cloud Anda. Klik AccessKey Management untuk mendapatkan ID AccessKey.

      • Akun kustom: username akun kustom, misalnya BASIC$abc.

      Rahasia AccessKey

      • Akun Alibaba Cloud: Rahasia AccessKey akun Alibaba Cloud Anda.

      • Akun kustom: password akun kustom.

      Port

      Port jaringan publik atau VPC dari instans Hologres.

      Contoh nilai: 80.

      Catatan

      Untuk informasi selengkapnya tentang jaringan publik, lihat Instance Details.

      Titik Akhir

      Alamat jaringan publik atau VPC dari instans Hologres.

      Contoh nilai: xxx-cn-hangzhou.hologres.aliyuncs.com.

      Catatan

      Untuk informasi selengkapnya tentang jaringan publik, lihat Instance Details.

      Database

      Nama database Hologres.

      Setelah instans Hologres diaktifkan, sistem secara otomatis membuat database postgres.

      Gunakan database postgres untuk menghubungkan ke Hologres. Namun, database ini dialokasikan sumber daya yang terbatas. Untuk pengembangan bisnis, buat database baru. Untuk informasi selengkapnya, lihat Create a database.

      Contoh nilai: mydb.

      Contoh penggunaan:

      • Login dengan akun Alibaba Cloud. Pernyataannya sebagai berikut:

        PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo

        阿里云账号登录

      • Login dengan akun kustom

        • Jika username akun kustom adalah abc, seperti pada gambar berikut.自定义登录

        • Pernyataan login adalah sebagai berikut:

          PGUSER="BASIC\$abc" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo

          自定义账号登录

      Catatan

      Anda juga dapat menggunakan alat pengembangan lain untuk menghubungkan ke Hologres, seperti DataWorks atau HoloWeb. Untuk informasi selengkapnya, lihat DataWorks Quick Start atau Connect to HoloWeb and execute a query.

    2. (Opsional) Buat database

      Setelah instans Hologres diaktifkan, sistem secara otomatis membuat database postgres. Database ini memiliki sumber daya terbatas dan hanya ditujukan untuk manajemen operasional. Untuk pengembangan bisnis, buat database baru.

      Catatan

      Jika Anda telah membuat database bisnis, lewati langkah ini.

      • Sintaks perintah:

        CREATE Database <DatabaseName>;

        DatabaseName adalah nama database yang akan dibuat.

      • Contoh:

        -- Create a database named test.
CREATE Database test;

    3. Kembangkan data

      Gunakan pernyataan PostgreSQL standar di PSQL client untuk pengembangan data.

      Contoh berikut menunjukkan cara membuat tabel dan menulis data ke dalamnya. Pernyataan SQL-nya sebagai berikut.

      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;

      Kembangkan pekerjaan berdasarkan skenario bisnis Anda. Berikut beberapa contohnya.