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>';

Limitations

• Requiert Hologres V0.10 ou version ultérieure. Vérifiez votre version sur la page Instance Details. Si vous utilisez une version antérieure, mettez votre instance à niveau ou contactez le support en ligne.

• Interrompez toutes les opérations d'écriture pendant la redistribution. Les lectures ne sont pas affectées. À partir de la V1.1, utilisez set table readonly pour assurer le basculement automatique des tâches d'écriture en temps réel.

• La redistribution consomme du CPU et augmente temporairement l'espace de stockage. Exécutez cette opération pendant les heures creuses.

• Désactivez le journal binaire de la table avant la redistribution, puis réactivez-le ensuite. Consultez la rubrique S'abonner aux journaux binaires Hologres.

• Les tables contenant des champs SERIAL ne peuvent pas être redistribuées. Les tables dotées de valeurs DEFAULT perdent leur attribut DEFAULT après redistribution.

• La table ne doit dépendre d'aucun autre objet, tel qu'une vue. Supprimez les dépendances avant la redistribution, sinon Hologres renvoie l'erreur suivante : "ERROR: resharding table xxx can not executed because other objects depend on it.". Pour contourner les dépendances de vues, définissez set hg_experimental_hg_insert_overwrite_enable_view=on;.

• La redistribution s'applique uniquement au modèle d'autorisations simple (SPM). Consultez la documentation sur le modèle d'autorisations Hologres.

• La redistribution ne préserve pas les propriétés de partitionnement automatique.

• À partir de Hologres V2.0, les commentaires de colonnes sont conservés lors de la redistribution. Sur les versions antérieures, sauvegardez et restaurez manuellement les commentaires de colonnes.

Syntaxe

Pour la V2.0.24 et les versions ultérieures : utilisez HoloWeb pour effectuer la redistribution via une interface graphique. Consultez la rubrique Redistribution des tables.

Pour les versions antérieures : exécutez les commandes SQL suivantes.

-- 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>');

Gérer les exceptions de redistribution

La redistribution peut être interrompue par des erreurs OOM (Out Of Memory) ou une terminaison manuelle. En cas d'interruption, la table d'origine devient accessible en lecture seule et une table temporaire nommée <initial_table_name>_xxxxxxxx apparaît.

Pour les instances exécutant la V2.0.24 ou une version ultérieure :

• HoloWeb : poursuivez ou annulez la redistribution depuis l'interface utilisateur. Consultez la rubrique Redistribution des tables.

• SQL : suivez les étapes ci-dessous.

Pour les instances exécutant des versions antérieures : Effectuez une mise à niveau vers la V2.0.24 ou une version ultérieure au préalable.

Pour reprendre la redistribution, résolvez la cause racine du problème et exécutez à nouveau la commande HG_MOVE_TABLE_TO_TABLE_GROUP.

Pour annuler la redistribution et restaurer l'état initial, exécutez les commandes suivantes dans l'ordre indiqué :

-- 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>');