Hologres:Gerencie grupos de tabelas e 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>';

Limitações

• Requer Hologres V0.10 ou posterior. Verifique sua versão na página Instance Details. Se for anterior, atualize sua instância ou obtenha suporte online.

• Interrompa todas as escritas durante o resharding. As leituras não são afetadas. A partir da V1.1, use set table readonly para failover automático de tarefas de escrita em tempo real.

• O resharding consome CPU e aumenta temporariamente o armazenamento. Execute fora do horário de pico.

• Desative o binary log da tabela antes do resharding e reative-o depois. Assinar binary logs do Hologres.

• Tabelas com campos SERIAL não podem passar por resharding. Tabelas com valores DEFAULT perdem o atributo DEFAULT após o resharding.

• A tabela não deve depender de outros objetos, como views. Exclua as dependências antes do resharding; caso contrário, o Hologres retornará: "ERROR: resharding table xxx can not executed because other objects depend on it.". Para contornar dependências de views, defina set hg_experimental_hg_insert_overwrite_enable_view=on;.

• O resharding aplica-se apenas ao Modelo de Permissão Simples (SPM). Modelo de permissões do Hologres.

• O resharding não preserva propriedades de particionamento automático.

• A partir do Hologres V2.0, comentários de colunas são preservados durante o resharding. Em versões anteriores, faça backup e restaure os comentários de colunas manualmente.

Sintaxe

Para V2.0.24 e posterior: Use o HoloWeb para executar o resharding por meio de uma interface gráfica. Resharding de tabelas.

Para versões anteriores: Execute os seguintes comandos SQL.

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

Trate exceções de resharding

Erros de OOM ou encerramento manual podem interromper o resharding. Se isso ocorrer, a tabela original torna-se somente leitura e uma tabela temporária chamada <initial_table_name>_xxxxxxxx aparece.

Para instâncias na V2.0.24 ou posterior:

• HoloWeb: Continue ou cancele o resharding pela UI. Resharding de tabelas.

• SQL: Siga as etapas abaixo.

Para instâncias em versões anteriores: Atualize para V2.0.24 ou posterior primeiro.

Para retomar o resharding, resolva a causa raiz e execute o comando HG_MOVE_TABLE_TO_TABLE_GROUP novamente.

Para cancelar o resharding e restaurar o estado original, execute estes comandos em ordem:

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