Hologres：Mengelola gudang virtual

Catatan

• Hanya Akun Alibaba Cloud atau Pengguna RAM dengan izin Superuser untuk instans yang dapat membuat gudang virtual.

• Membuat gudang virtual adalah proses asinkron yang berjalan di latar belakang. Untuk memastikan bahwa gudang virtual siap digunakan, gunakan fungsi hg_get_warehouse_status untuk menanyakan statusnya.

Prosedur

Catatan

• Hanya Akun Alibaba Cloud atau Pengguna RAM dengan izin Superuser untuk instans yang dapat menghapus gudang virtual.

• Anda tidak dapat menghapus gudang virtual default suatu instans.

• Anda tidak dapat menggunakan perintah SQL untuk menghapus gudang virtual leader dari Table Group.

• Menghapus gudang virtual adalah proses asinkron yang berjalan di latar belakang. Untuk memastikan bahwa gudang virtual telah dihapus, gunakan fungsi hg_get_warehouse_status untuk menanyakan status gudang virtual tersebut.

Prosedur

Izin

• Sebelum V3.0.28, hanya Akun Alibaba Cloud atau Pengguna RAM yang dapat menskalakan gudang virtual. Mulai dari V3.0.28, Peran RAM juga dapat melakukan operasi ini.

• Untuk menskalakan gudang virtual, Anda harus memiliki izin berikut:

  • Izin Peran RAM: AliyunHologresWarehouseFullAccess atau AliyunHologresFullAccess.

  • Izin Superuser dalam instans.

Untuk informasi tentang skalabilitas elastis untuk gudang virtual, lihat Ikhtisar skalabilitas sumber daya.

Skalakan naik gudang virtual

-- Tingkatkan sumber daya gudang virtual
CALL hg_alter_warehouse ('read_warehouse_1',64);

-- Tunggu hingga gudang virtual selesai penskalaan naik
SELECT wait_until_warehouse_running ('read_warehouse_1');

-- Lakukan penyeimbangan ulang shard
SELECT hg_rebalance_warehouse ('read_warehouse_1');

-- Tunggu hingga penyeimbangan ulang selesai
SELECT hg_wait_until_rebalance_warehouse_done ('read_warehouse_1');

Skalakan turun gudang virtual

Perluas gudang virtual (Tambahkan kluster)

Kurangi gudang virtual (Kurangi kluster)

Lihat gudang virtual

• Perintah

  • Tampilan sistem hologres.hg_warehouses menyimpan informasi tentang semua gudang virtual dalam Instans saat ini.

    SELECT * FROM hologres.hg_warehouses;

  • Lihat gudang virtual saat ini:

    SELECT current_warehouse();

• Parameter

  Tampilan sistem hologres.hg_warehouses mencakup bidang-bidang berikut:

  Bidang	Tipe	Deskripsi	Contoh
  warehouse_id	INTEGER	ID unik gudang virtual.	1
  warehouse_name	TEXT	Nama gudang virtual.	init_warehouse
  cpu	INTEGER	vCPU gudang virtual.	32
  mem	INTEGER	Memori gudang virtual dalam GB.	128
  cluster_min_count	INTEGER	Jumlah minimum kluster untuk gudang virtual.	1
  cluster_max_count	INTEGER	Jumlah maksimum kluster untuk gudang virtual.	1
  target_status	INTEGER	Status akhir gudang virtual. Karena pembaruan status bersifat asinkron, bidang ini mencerminkan status target. Nilai yang mungkin: 1: Berjalan 2: Dihentikan secara manual	1
  status	INTEGER	Status saat ini dari gudang virtual. Statusnya adalah: 0: Menginisialisasi 1: Berjalan 2: Dihentikan secara manual 3: Pemrosesan gagal. Periksa bidang status_detail untuk mengetahui penyebab kegagalan. 4: Memproses	1
  status_detail	TEXT	Rincian tentang status gudang virtual.
  is_default	BOOLEAN	Menunjukkan apakah ini adalah gudang virtual default. t: Benar f: Salah	t
  config	TEXT	Konfigurasi gudang virtual.
  comment	TEXT	Komentar untuk gudang virtual.

Hentikan gudang virtual

Lanjutkan gudang virtual

Mulai ulang gudang virtual

Dapatkan status gudang virtual

• Sintaks

  • Dapatkan status saat ini dari gudang virtual:

    select hg_get_warehouse_status('<warehouse_name>');

  • Operasi seperti membuat atau menskalakan gudang virtual bersifat asinkron. Gunakan fungsi wait_until_warehouse_running untuk menunggu hingga gudang virtual mencapai status Running dan mengembalikan hasil:

    select wait_until_warehouse_running('<warehouse_name>',<timeout_seconds>);

• Parameter

  Parameter	Tipe	Deskripsi
  warehouse_name	TEXT	Nama gudang virtual.
  timeout_seconds	INTEGER	Opsional. Periode timeout dalam detik.

• Contoh

  Contoh berikut menskalakan naik gudang virtual sebelum mengimpor data dan menskalakan turun setelahnya.

  -- Skalakan naik warehouse_1 menjadi 64 CU.
  CALL hg_alter_warehouse ('warehouse_1',64);
  
  -- Tunggu hingga warehouse_1 selesai penskalaan naik.
  SELECT wait_until_warehouse_running('warehouse_1');
  
  -- Tulis data.
  INSERT INTO res_data SELECT * FROM org_data；
  
  -- Skalakan turun warehouse_1 menjadi 32 CU.
  CALL hg_alter_warehouse ('warehouse_1',32);

Ubah nama gudang virtual

Prosedur

Lakukan penyeimbangan ulang gudang virtual

Saat berjalan, Node Pekerja setiap gudang virtual Hologres memuat metadata shard secara merata. Namun, dalam beberapa skenario, seperti setelah pemulihan cepat atau operasi penskalaan naik, shard mungkin menjadi tidak merata didistribusikan di seluruh Node Pekerja. Anda kemudian dapat memicu penyeimbangan ulang untuk mendistribusikan ulang shard data secara merata di seluruh Node Pekerja.

• Izin

  Anda memerlukan izin Superuser untuk instans agar dapat memicu penyeimbangan ulang.

• Catatan

  • V2.1 ke atas: Hologres secara otomatis memulai penyeimbangan ulang untuk gudang virtual yang tidak memiliki Shard yang dimuat di Node Pekerjanya.

  • V2.2 ke atas: Hologres kini mendukung pengulangan otomatis untuk kueri SELECT selama penyeimbangan ulang gudang virtual. Fitur ini memungkinkan kueri selesai dengan sedikit peningkatan waktu eksekusi, mencegah kegagalan seperti ERROR: fail to execute query internal error: Get rundown is not allowed in recovering state.

• Sintaks

  SELECT hg_rebalance_warehouse ('<warehouse_name>');

• Parameter

  Parameter	Tipe	Deskripsi
  warehouse_name	TEXT	Nama gudang virtual yang akan diseimbangkan ulang.

• Nilai kembalian

  Setelah Anda memicu penyeimbangan ulang, Hologres mengembalikan salah satu hasil berikut:

  • true: Penyeimbangan ulang berhasil dipicu.

  • false: Penyeimbangan ulang tidak diperlukan.

  • Error: Gagal memicu penyeimbangan ulang karena penyebab seperti Pod rusak.

  Catatan

  • Selama penyeimbangan ulang, Hologres menilai kebutuhan redistribusi dan bertujuan untuk distribusi shard yang optimal. Secara khusus, jumlah shard pada dua Node Pekerja mana pun tidak akan berbeda lebih dari satu. Misalnya:

    • Dengan 2 Node Pekerja dan 2 shard, setiap node menerima 1 shard.

    • Dengan 2 Node Pekerja dan 3 shard, satu node menerima 1 shard, dan yang lain menerima 2.

  • Penyeimbangan ulang biasanya memakan waktu 2 hingga 3 menit, dengan durasi meningkat berdasarkan jumlah Table Group yang dimuat. Penulisan terganggu selama sekitar 15 detik selama proses ini.

  • Penyeimbangan ulang adalah proses asinkron. Periksa progresnya menggunakan perintah SQL ini:

    SELECT hg_get_rebalance_warehouse_status('<warehouse_name>');

    Perintah ini mengembalikan DOING untuk menunjukkan penyeimbangan ulang sedang berlangsung; DONE menunjukkan penyeimbangan ulang selesai.

Tetapkan durasi timeout untuk gudang virtual

Durasi timeout dapat dikonfigurasi di tingkat sesi, database, atau gudang virtual menggunakan parameter statement_timeout. Untuk detailnya, lihat Parameter GUC.

Pengaturan timeout di tingkat gudang virtual memiliki prioritas lebih rendah daripada konfigurasi tingkat sesi atau tingkat database. Untuk memastikan pengaturan ini berlaku, hapus terlebih dahulu pengaturan timeout tingkat database yang ada.

-- Nonaktifkan pengaturan timeout tingkat database.
ALTER DATABASE <db_name> RESET statement_timeout;

-- Tetapkan durasi timeout untuk gudang virtual menjadi 600 detik.
CALL hg_alter_warehouse ('<warehouse_name>', <cu>, '{"configs":{"gucs":{"statement_timeout":"600000"}}}');