Hologres:Manage table groups and shards

SET hg_experimental_enable_shard_count_cap = off;

SELECT * FROM hologres.hg_table_group_properties
WHERE tablegroup_name IN (
  SELECT tablegroup_name FROM hologres.hg_table_group_properties
  WHERE property_key = 'is_default_tg' AND property_value = '1'
);

 tablegroup_name |   property_key   | property_value
-----------------+------------------+----------------
 test_tg_default | tg_version       | 1
 test_tg_default | table_num        | 1
 test_tg_default | is_default_tg    | 1
 test_tg_default | shard_count      | 3
 test_tg_default | replica_count    | 1
 test_tg_default | created_manually | 0
(6 rows)

SELECT tablegroup_name
FROM hologres.hg_table_group_properties GROUP BY tablegroup_name;

SELECT property_value AS shard_count
FROM hologres.hg_table_group_properties
WHERE property_key = 'shard_count' AND tablegroup_name = '<tg_name>';

SELECT table_namespace AS schema_name, table_name
FROM hologres.hg_table_properties
WHERE property_key = 'table_group' AND property_value = '<tg_name>';

SELECT property_value AS table_group_name
FROM hologres.hg_table_properties
WHERE property_key = 'table_group' AND table_name = '<table_name>';

Sınırlamalar

• Hologres V0.10 veya sonraki bir sürüm gerektirir. Sürümünüzü Instance Details sayfasında kontrol edin. Daha eski bir sürüm kullanıyorsanız, örneğinizi yükseltin veya çevrimiçi destek alın.

• Yeniden parçalama sırasında tüm yazma işlemlerini durdurun. Okuma işlemleri etkilenmez. V1.1'den itibaren, gerçek zamanlı yazma görevlerinin otomatik yük devretmesi için set table readonly kullanın.

• Yeniden parçalama CPU tüketir ve depolamayı geçici olarak artırır. Yoğun olmayan saatlerde çalıştırın.

• Yeniden parçalamadan önce tablo ikili günlüğünü devre dışı bırakın ve işlem bittikten sonra yeniden etkinleştirin. Hologres ikili günlüklerine abone olun.

• SERIAL alanları içeren tablolar yeniden parçalanamaz. DEFAULT değerleri içeren tablolar, yeniden parçalamadan sonra DEFAULT niteliğini kaybeder.

• Tablo, görünümler gibi diğer nesnelere bağımlı olmamalıdır. Yeniden parçalamadan önce bağımlılıkları silin; aksi takdirde Hologres şu hatayı döndürür: "ERROR: resharding table xxx can not executed because other objects depend on it.". Görünüm bağımlılıklarını atlamak için set hg_experimental_hg_insert_overwrite_enable_view=on; ayarlayın.

• Yeniden parçalama yalnızca Basit İzin Modeli (SPM) için geçerlidir. Hologres izin modeli.

• Yeniden parçalama, otomatik bölümlendirme özelliklerini korumaz.

• Hologres V2.0'dan itibaren, sütun açıklamaları yeniden parçalama sırasında korunur. Daha eski sürümlerde, sütun açıklamalarını manuel olarak yedekleyin ve geri yükleyin.

Söz dizimi

V2.0.24 ve sonraki sürümler için: Grafik arayüz üzerinden yeniden parçalama yapmak için HoloWeb'i kullanın. Tablo yeniden parçalama.

Daha eski sürümler için: Aşağıdaki SQL komutlarını çalıştırın.

-- For V1.1 and later:
CALL HG_MOVE_TABLE_TO_TABLE_GROUP('<table_name>', '<new_table_group_name>');

-- For V0.10 and later:
CALL HG_UPDATE_TABLE_SHARD_COUNT('<table_name>', '<new_table_group_name>');

Yeniden parçalama istisnalarını yönetin

Yeniden parçalama, OOM hataları veya manuel sonlandırma nedeniyle kesintiye uğrayabilir. Kesintiye uğrarsa, orijinal tablo salt okunur hale gelir ve <initial_table_name>_xxxxxxxx adında geçici bir tablo görünür.

V2.0.24 veya sonraki sürümlerdeki örnekler için:

• HoloWeb: Kullanıcı arayüzünden yeniden parçalamaya devam edin veya iptal edin. Tablo yeniden parçalama.

• SQL: Aşağıdaki adımları izleyin.

Daha eski sürümlerdeki örnekler için: Önce V2.0.24 veya sonraki bir sürüme yükseltin.

Yeniden parçalamaya devam etmek için, kök nedeni çözün ve HG_MOVE_TABLE_TO_TABLE_GROUP komutunu tekrar çalıştırın.

Yeniden parçalamayı iptal etmek ve orijinal durumu geri yüklemek için, bu komutları sırayla çalıştırın:

-- 1. Remove the read-only flag from the original table.
CALL set_table_property('<schema_name>.<table_name>', 'readonly', 'false');

-- 2. Find the temporary table name.
-- For a partitioned table:
SELECT schema_name, target_temp_table_name
FROM hologres.hg_resharding_properties
WHERE reshard_table_name = '<schema_name>.<table_name>' AND is_parent_table IS TRUE;

-- For a non-partitioned table:
SELECT schema_name, target_temp_table_name
FROM hologres.hg_resharding_properties
WHERE reshard_table_name = '<schema_name>.<table_name>'
  AND is_parent_table IS FALSE AND is_sub_table IS FALSE;

-- 3. Drop the temporary table.
DROP TABLE IF EXISTS <schema_name>.<target_temp_table_name>;

-- 4. Clear the resharding progress record.
CALL hologres.hg_internal_clear_resharding_properties('<schema_name>.<table_name>');