Hologres：Kelola virtual warehouse

Catatan

• Hanya Akun Alibaba Cloud atau pengguna Resource Access Management (RAM) yang dapat membuat virtual warehouse. Diperlukan izin Superuser untuk instans tersebut.

• Karena pembuatan virtual warehouse merupakan proses asinkron, menjalankan perintah SQL untuk membuat virtual warehouse tidak berarti pembuatan telah selesai. Anda harus menggunakan fungsi hg_get_warehouse_status untuk menanyakan status virtual warehouse.

Metode

Catatan

• Hanya Akun Alibaba Cloud atau pengguna RAM yang dapat menghapus virtual warehouse. Diperlukan izin Superuser untuk instans tersebut.

• Anda tidak dapat menghapus virtual warehouse default suatu instans.

• Anda tidak dapat menggunakan perintah SQL untuk menghapus virtual warehouse utama dari kelompok tabel.

• Karena penghapusan virtual warehouse merupakan proses asinkron, menjalankan perintah SQL tidak berarti penghapusan telah selesai. Anda harus menggunakan fungsi hg_get_warehouse_status untuk menanyakan status virtual warehouse.

Metode

Izin

• Sebelum V3.0.28, hanya Akun Alibaba Cloud atau pengguna RAM yang dapat menskalakan virtual warehouse. Mulai dari V3.0.28, role RAM (akun STS) juga dapat melakukan operasi ini.

• Untuk menskalakan virtual warehouse, Anda memerlukan izin berikut:

  • Izin role RAM: AliyunHologresWarehouseFullAccess atau AliyunHologresFullAccess.

  • Izin Superuser dalam instans.

Untuk informasi tentang cara kerja skalabilitas elastis virtual warehouse, lihat Ikhtisar elastisitas resource.

Tingkatkan kapasitas virtual warehouse (skalabilitas vertikal)

-- Tingkatkan resource virtual warehouse.
CALL hg_alter_warehouse ('read_warehouse_1',64);

-- Tunggu hingga virtual warehouse ditingkatkan kapasitasnya.
SELECT wait_until_warehouse_running ('read_warehouse_1');

-- Penyeimbangan ulang.
SELECT hg_rebalance_warehouse ('read_warehouse_1');

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

Kurangi kapasitas virtual warehouse (skalabilitas vertikal)

Perluas kapasitas virtual warehouse (skalabilitas horizontal)

Skala-masuk kluster kelompok komputasi

Lihat Kelompok Komputasi

• Sintaks

  • Tabel sistem hologres.hg_warehouses menyimpan informasi tentang semua virtual warehouse dalam instans saat ini. Anda dapat menjalankan pernyataan SQL berikut untuk melihat informasi tentang semua virtual warehouse dalam instans saat ini.

    SELECT * FROM hologres.hg_warehouses;

  • Jalankan pernyataan SQL berikut untuk melihat virtual warehouse yang sedang digunakan. Sistem mengembalikan nama virtual warehouse saat ini.

    SELECT current_warehouse();

• Parameter

  Tabel sistem hologres.hg_warehouses berisi kolom-kolom berikut:

  Field	Tipe Data	Deskripsi	Contoh
  warehouse_id	INTEGER	ID kelompok komputasi yang secara unik mengidentifikasi kelompok komputasi.	1
  warehouse_name	TEXT	Nama kelompok komputasi.	init_warehouse
  cpu	INTEGER	Jumlah core CPU untuk kelompok komputasi.	32
  mem	INTEGER	Memori kelompok komputasi (GB)	128
  cluster_min_count	INTEGER	Jumlah minimum shard untuk kelompok komputasi.	1
  cluster_max_count	INTEGER	Jumlah maksimum shard untuk kelompok komputasi.	1
  target_status	INTEGER	Status target virtual warehouse. Karena mengubah status virtual warehouse merupakan proses asinkron, saat Anda menjalankan pernyataan SQL untuk membuat virtual warehouse, sistem segera mengembalikan hasil eksekusi, tetapi virtual warehouse belum dibuat. Sistem membuat virtual warehouse secara asinkron di latar belakang. Status ini mencatat status akhir yang harus dicapai oleh virtual warehouse. Nilai yang valid: 1: Running. 2. Instance dihentikan secara manual.	1
  status	INTEGER	Kelompok komputasi dapat memiliki salah satu status berikut: 0: Inisialisasi. 1: Running. 2: Dihentikan secara manual. 3: Pemrosesan gagal. Jika statusnya Pemrosesan gagal, kolom status_detail menunjukkan alasan spesifiknya. 4: Pemrosesan.	1
  status_detail	TEXT	Rincian status kelompok komputasi.	None
  is_default	BOOLEAN	Menunjukkan apakah ini virtual warehouse default. Nilai yang valid: t adalah kelompok komputasi default. f: Ini bukan kelompok komputasi default.	t
  config	TEXT	Konfigurasi kelompok komputasi	None
  comment	TEXT	Catatan tentang kelompok komputasi.	None

Hentikan Kelompok Komputasi

Resume Compute Group

Mulai Ulang Kelompok Komputasi

Ambil Status Kelompok Komputasi

• Sintaks

  • Anda dapat menggunakan pernyataan SQL berikut untuk mengambil status saat ini dari kelompok komputasi:

    select hg_get_warehouse_status('<warehouse_name>');

  • Karena operasi seperti membuat dan menskalakan virtual warehouse dilakukan secara asinkron, Anda mungkin perlu melakukan operasi lain setelah status virtual warehouse berubah. Dalam hal ini, Anda dapat menggunakan fungsi wait_until_warehouse_running. Fungsi ini menunggu hingga virtual warehouse yang ditentukan berada dalam status Running sebelum mengembalikan hasil. Perintahnya sebagai berikut:

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

• Parameter

  Parameter	Tipe	Deskripsi
  warehouse_name	TEXT	Nama kelompok komputasi yang statusnya ingin Anda ambil.
  timeout_seconds	INTEGER	Periode timeout dalam detik. Parameter ini opsional.

• Contoh

  Jalankan pernyataan SQL berikut untuk menaikkan kapasitas virtual warehouse sebelum mengimpor data dari tabel org_data ke tabel res_data, lalu kurangi kapasitas virtual warehouse setelah impor selesai:

  -- Naikkan kapasitas warehouse_1 menjadi 64 CU.
  CALL hg_alter_warehouse ('warehouse_1',64);
  
  -- Tunggu hingga warehouse_1 dinaikkan kapasitasnya.
  SELECT wait_until_warehouse_running('warehouse_1');
  
  -- Tulis data.
  INSERT INTO res_data SELECT * FROM org_data;
  
  -- Turunkan kapasitas warehouse_1 menjadi 32 CU.
  CALL hg_alter_warehouse ('warehouse_1',32);

Ubah nama kelompok komputasi

Metode

Penyeimbangan Ulang Kelompok Komputasi

Saat instans Hologres berjalan, node pekerja di setiap virtual warehouse memuat metadata shard data secara merata. Namun, dalam beberapa skenario—seperti setelah pemulihan cepat atau perluasan kapasitas—shard data mungkin terdistribusi tidak merata di seluruh node pekerja. Dalam kasus ini, Anda harus memicu operasi Penyeimbangan ulang shard untuk mendistribusikan ulang shard data secara proaktif dan memastikan bahwa node pekerja di virtual warehouse memuat metadata shard secara merata.

• Izin

  Anda harus memiliki izin Superuser untuk instans agar dapat memicu operasi Penyeimbangan ulang shard.

• Catatan

  • Mulai dari Hologres V2.1, jika virtual warehouse berisi node pekerja kosong—yaitu node yang belum memuat shard apa pun—virtual warehouse secara otomatis memicu Penyeimbangan ulang.

  • Mulai dari Hologres V2.2, sistem mendukung percobaan ulang otomatis untuk kueri SELECT yang dijalankan selama Penyeimbangan ulang virtual warehouse. Hal ini memungkinkan kueri berhasil diselesaikan setelah waktu eksekusi yang sedikit lebih lama dan mencegah error 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	Jenis	Deskripsi
  warehouse_name	TEXT	Nama kelompok komputasi yang memicu penyeimbangan shard.

• Nilai kembali

  Setelah Anda memicu operasi Penyeimbangan ulang shard, salah satu hasil berikut dikembalikan:

  • true: Penyeimbangan ulang berhasil dipicu, dan sistem memulai operasi Penyeimbangan ulang.

  • false: Penyeimbangan ulang tidak diperlukan.

  • Error: Penyeimbangan ulang gagal dipicu. Misalnya, jika Pod mengalami gangguan, error dilaporkan saat Anda memicu operasi Penyeimbangan ulang.

  Catatan

  • Selama Penyeimbangan ulang, sistem menghitung apakah Penyeimbangan ulang diperlukan untuk mencapai keadaan seimbang—keadaan di mana selisih jumlah shard yang dimuat oleh setiap node pekerja kurang dari atau sama dengan 1. Contohnya:

    • Jika terdapat 2 pekerja dan 2 shard, setiap pekerja diberi 1 shard.

    • Jika terdapat 2 pekerja dan 3 shard, satu pekerja diberi 1 shard dan yang lain diberi 2 shard.

  • Operasi Penyeimbangan ulang biasanya memakan waktu 2 hingga 3 menit. Durasi tergantung pada jumlah kelompok tabel dalam virtual warehouse—semakin banyak kelompok tabel, semakin lama Penyeimbangan ulang berlangsung. Selama Penyeimbangan ulang, operasi tulis terganggu selama sekitar 15 detik.

  • Karena Penyeimbangan ulang dilakukan secara asinkron, Anda dapat menjalankan pernyataan SQL berikut untuk memantau progres eksekusi:

    SELECT hg_get_rebalance_warehouse_status('<warehouse_name>');

    Nilai kembali DOING menunjukkan bahwa Penyeimbangan ulang sedang berlangsung. Nilai kembali DONE menunjukkan bahwa Penyeimbangan ulang telah selesai.

Atur durasi timeout untuk kelompok komputasi

Anda dapat mengatur parameter statement_timeout untuk mengonfigurasi periode timeout pada tingkat session atau tingkat database. Untuk informasi lebih lanjut, lihat Parameter GUC.

Untuk virtual warehouse, Anda dapat menjalankan perintah berikut untuk mengatur periode timeout. Konfigurasi ini memiliki prioritas lebih rendah daripada konfigurasi tingkat session dan tingkat database. Oleh karena itu, Anda harus terlebih dahulu membatalkan konfigurasi tingkat database.

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

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