Cara menggunakan JDBC dan PSQL untuk menghubungkan ke instans kelompok komputasi - Hologres

Topik ini menjelaskan cara menggunakan Java Database Connectivity (JDBC) dan PSQL untuk menghubungkan ke instans kelompok komputasi.

Hubungkan ke instans Hologres menggunakan JDBC

Format perintah

Jika kelompok komputasi tidak ditentukan dalam string koneksi, koneksi akan menggunakan kelompok komputasi default pengguna.
```
jdbc:postgresql:<Endpoint>:<Port>/<database_name>
```

Tentukan kelompok komputasi.

jdbc:postgresql://<Endpoint>:<Port>/<database_name>@<warehouse_name>

Deskripsi parameter

Parameter	Wajib	Deskripsi
Endpoint	Ya	Alamat jaringan dan port instans Hologres. Masuk ke Konsol Hologres. Di panel navigasi sebelah kiri, klik Instances. Pada halaman Instances, klik ID instans tersebut. Di halaman Instance Details, lihat endpoint dan nomor port di bagian Network Information. Penting Pilih alamat jaringan dan port yang sesuai dengan lingkungan jaringan tempat perintah SQL dijalankan. Jika tidak, koneksi akan gagal.
Port	Ya
database_name	Ya	Nama database Hologres. Setelah instans Hologres dibuat, 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: demo.
warehouse_name	Tidak	Nama kelompok komputasi yang digunakan untuk menghubungkan ke instans.

Contoh penggunaan

Kelompok komputasi tidak ditentukan

String koneksi JDBC berikut menghubungkan ke database demo dari instans hgpostcn-cn-zz4xxxxxxxxxx. Karena kelompok komputasi tidak ditentukan, sistem menggunakan kelompok komputasi default pengguna untuk koneksi tersebut.
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo
```
Kelompok komputasi ditentukan

String koneksi JDBC berikut menghubungkan ke database demo dari instans hgpostcn-cn-zz4xxxxxxxxxx. Koneksi ini menggunakan kelompok komputasi yang ditentukan `warehouse_1`.
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo@warehouse_1
```

Hubungkan ke instans Hologres menggunakan PSQL

Format perintah

Jika kelompok komputasi tidak ditentukan dalam string koneksi, koneksi akan menggunakan kelompok komputasi default pengguna.
```
PGUSER="<AccessKey_ID>" PGPASSWORD="<AccessKey_Secret>" psql -h <Endpoint> -p <Port> -d <database_name>
```

Tentukan kelompok komputasi.

PGUSER="<AccessKey_ID>" PGPASSWORD="<AccessKey_Secret>" psql -h <Endpoint> -p <Port> -d <database_name>@<warehouse_name>

Deskripsi parameter

Parameter	Wajib	Deskripsi
AccessKey_ID	Ya	Akun Alibaba Cloud: ID AccessKey akun Alibaba Cloud Anda. Klik AccessKey Management untuk mendapatkan ID AccessKey. Akun kustom: username akun kustom, seperti BASIC$abc.
AccessKey_Secret	Ya	Akun Alibaba Cloud: Rahasia AccessKey akun Alibaba Cloud Anda. Akun kustom: password akun kustom tersebut.
Endpoint	Ya	Alamat jaringan instans Hologres. Buka halaman Instance Details di Konsol Hologres untuk mendapatkan alamat jaringan tersebut.
Port	Ya	Port jaringan instans Hologres. Buka halaman Instance Details di Konsol Hologres untuk mendapatkan port jaringan tersebut.
database_name	Ya	Nama database Hologres. Setelah instans Hologres dibuat, 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: demo.
warehouse_name	Tidak	Nama kelompok komputasi yang digunakan untuk menghubungkan ke instans.

Contoh penggunaan

Kelompok komputasi tidak ditentukan

String koneksi PSQL berikut menghubungkan ke database demo dari instans hgpostcn-cn-zz4xxxxxxxxxx. Karena kelompok komputasi tidak ditentukan, sistem menggunakan kelompok komputasi default pengguna untuk koneksi tersebut.
```
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com -p 80 -d demo
```
Kelompok komputasi ditentukan

String koneksi PSQL berikut menghubungkan ke database demo dari instans hgpostcn-cn-zz4xxxxxxxxxx. Koneksi ini menggunakan kelompok komputasi yang ditentukan `warehouse_1`.
```
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com -p 80 -d demo@warehouse_1
```

Ganti kelompok komputasi untuk koneksi saat ini menggunakan SQL

Pada Hologres V4.0 dan versi setelahnya, Anda dapat mengganti kelompok komputasi untuk koneksi saat ini menggunakan SQL.

Format perintah

-- Ganti kelompok komputasi untuk koneksi saat ini
SET current_warehouse = <warehouse_name>;

-- Verifikasi: Tampilkan kelompok komputasi untuk koneksi saat ini
SHOW current_warehouse;

Perhatian

Saat Anda mengganti kelompok komputasi untuk suatu koneksi, status seperti variabel Grand Unified Configuration (GUC) dan prepared statements untuk koneksi tersebut tetap tidak berubah.
Pengaturan ini hanya didukung pada tingkat session, bukan pada tingkat database atau pengguna. Jika Anda mencoba menerapkan pengaturan ini pada tingkat database atau pengguna, akan muncul error: 'This can only be set at session level.'
Pengguna untuk koneksi saat ini harus memiliki izin pada kelompok komputasi tujuan. Jika pengguna tidak memiliki izin yang diperlukan, akan muncul error: 'Permission denied for warehouse "xxx".'
Anda tidak dapat mengganti kelompok komputasi untuk koneksi yang berisi tabel temporary (TEMP TABLE).