System tables for dynamic table - Hologres: Central de Documentação do Alibaba Cloud

O Hologres oferece quatro tabelas de sistema para gerenciar e monitorar Dynamic Tables. Utilize essas tabelas para inspecionar metadados, rastrear a linhagem de dados e diagnosticar problemas em tarefas de atualização.

Tabela de sistema	Descrição
`hologres.hg_dynamic_table_properties`	Armazena metadados da Dynamic Table, incluindo modo de atualização, agendamento e configuração de recursos de computação.
`hologres.hg_dynamic_table_dependencies`	Registra a linhagem de dados, ou seja, as tabelas base das quais uma Dynamic Table depende.
`hologres.hg_dynamic_table_refresh_activity`	Contém as tarefas de atualização em execução no momento. Não há suporte para esta tabela no Hologres V3.1 e versões posteriores.
`hologres.hg_dynamic_table_refresh_history`	Mantém o histórico de tarefas de atualização. Por padrão, os dados são retidos por um mês.

Tabela de sistema `hologres.hg_dynamic_table_properties`

Esta tabela armazena os metadados de cada Dynamic Table, abrangendo sua configuração de atualização e definição de consulta.

Campo	Descrição
`dynamic_table_namespace`	Schema onde a Dynamic Table está localizada.
`dynamic_table_name`	Nome da Dynamic Table.
`property_key` e `property_value`	Nome da propriedade e seu respectivo valor. Consulte as tabelas a seguir para ver todas as propriedades suportadas.

Propriedades gerais

Propriedade	Descrição
`execution_mode`	Modo de atualização. Valores válidos: `full` (atualização completa), `incremental` (atualização incremental) e `none` (nenhum modo de atualização definido).
`task_definition`	Definição de consulta da Dynamic Table.
`auto_refresh_enable`	Indica se a atualização automática está ativada. Valores válidos: `true` (ativado) e `false` (desativado).
`task_definition_search_path`	Schema da consulta.
`state_time_to_live_in_seconds`	Período de retenção dos dados na tabela de estado, em segundos.

Parâmetros para atualização incremental

Propriedade	Descrição
`incremental_auto_refresh_schd_start_time`	Horário de início da atualização. Valores válidos: `immediate` (inicia logo após a criação da tabela) ou um horário personalizado, como `2024-08-27 15:00:00`.
`incremental_auto_refresh_interval`	Intervalo entre atualizações. Faixa permitida: de 1 minuto a 48 horas.
`incremental_guc_hg_computing_resource`	Recurso de computação destinado à atualização. O valor é `serverless`, indicando o uso de recursos do Serverless Computing.
`incremental_guc_hg_experimental_serverless_computing_required_cores`	Especificações de recursos de computação para a atualização incremental.
`incremental_state_table_group`	Grupo de tabelas onde reside a tabela de estado no modo de atualização incremental.
`incremental_plan`	Plano de execução para a atualização incremental.

Parâmetros para atualização completa

Propriedade	Descrição
`full_auto_refresh_schd_start_time`	Horário de início da atualização. Valores válidos: `immediate` (inicia logo após a criação da tabela) ou um horário personalizado, como `2024-08-27 15:00:00`.
`full_auto_refresh_interval`	Intervalo entre atualizações. Faixa permitida: de 1 minuto a 48 horas.
`full_guc_hg_computing_resource`	Recurso de computação utilizado. Valores válidos: `local` (utiliza os recursos da instância atual) e `serverless` (utiliza recursos do Serverless Computing). Para mais informações, consulte Serverless Computing.
`full_guc_hg_experimental_serverless_computing_required_cores`	Especificações de recursos de computação para a atualização completa.

Tabela de sistema `hologres.hg_dynamic_table_dependencies`

Esta tabela registra a linhagem de dados das Dynamic Tables, especificando quais tabelas base cada Dynamic Table utiliza como dependência.

Observações de uso:

Como uma Dynamic Table pode depender de várias tabelas base, múltiplas linhas podem aparecer para uma única Dynamic Table.
A tabela de estado usada na atualização incremental também é registrada como tabela base. Por padrão, ela reside no schema de sistema hologres_streaming_mv. Na prática, ignore as linhas associadas a este schema.
Utilize tabelas de sistema como pg_class para diferenciar melhor os tipos de tabelas base.

Campo	Descrição
`table_namespace`	Schema onde a tabela base está localizada.
`table_name`	Nome da tabela base.
`dynamic_table_namespace`	Schema onde a Dynamic Table está localizada.
`dynamic_table_name`	Nome da Dynamic Table.
`dependency`	Tipo da tabela base. Valores válidos: `base_table` (tabela padrão), `base_dimension_table` (tabela de dimensão) e `internal_table` (tabela interna — ignore na prática).

Exemplo: consultar a linhagem de dados de uma Dynamic Table específica

SELECT
  table_namespace,
  table_name,
  dependency
FROM hologres.hg_dynamic_table_dependencies
WHERE dynamic_table_name = '<your_dynamic_table>'
  AND table_namespace != 'hologres_streaming_mv'
ORDER BY dependency;

Tabela de sistema `hologres.hg_dynamic_table_refresh_activity`

Instâncias do Hologres V3.1 e posteriores não oferecem suporte a esta tabela de sistema. Utilize a tabela hologres.hg_dynamic_table_refresh_history para visualizar tarefas de atualização concluídas.

Esta tabela registra as tarefas de atualização de Dynamic Table que estão em execução no momento.

Campo	Descrição
`pid`	ID do processo (PID) da tarefa de atualização. Utilize o PID para cancele uma tarefa de atualização em andamento. Para mais informações, consulte Cancelar uma tarefa de atualização.
`datname`	Banco de dados onde a Dynamic Table está localizada.
`query_id`	ID da consulta da tarefa de atualização.
`usename`	Usuário que executa a atualização da Dynamic Table.
`query`	Consulta de atualização.
`refresh_mode`	Modo de atualização. Valores válidos: `full` (atualização completa), `incremental` (atualização incremental) e `none` (nenhum modo de atualização definido).
`refresh_start`	Horário de início da tarefa de atualização.
`duration`	Tempo de execução da tarefa de atualização.
`serverless_queue_time_ms`	Tempo que a tarefa de atualização passou aguardando recursos do Serverless Computing. Exibido apenas para atualizações que utilizam Serverless Computing.
`serverless_resource_used_time_ms`	Tempo durante o qual a tarefa de atualização utilizou recursos do Serverless Computing. Exibido apenas para atualizações que utilizam Serverless Computing.
`serverless_allocated_cores`	Especificações de recursos do Serverless Computing alocados para a tarefa de atualização. Exibido apenas para atualizações que utilizam Serverless Computing.
`serverless_allocated_workers`	Quantidade de workers serverless alocados para a tarefa de atualização. Exibido apenas para atualizações que utilizam Serverless Computing.
`table_write`	Dynamic Table na qual a tarefa de atualização é executada. Exibido apenas para atualizações que utilizam Serverless Computing.

Tabela de sistema `hologres.hg_dynamic_table_refresh_history`

Esta tabela armazena o histórico de tarefas de atualização de Dynamic Tables. Por padrão, os dados são retidos por um mês.

Campo	Descrição
`datname`	Banco de dados onde a Dynamic Table está localizada.
`schema_name`	Schema onde a Dynamic Table está localizada.
`dynamic_table_name`	Nome da Dynamic Table.
`query_id`	ID da consulta da atualização. Utilize este ID no recurso Get query insights para visualize informações detalhadas sobre a consulta.
`refresh_start`	Horário de início da atualização.
`refresh_end`	Horário de término da atualização.
`duration`	Duração total da atualização.
`refresh_latency`	Latência dos dados no momento em que a atualização foi concluída.
`refresh_mode`	Modo de atualização. Valores válidos: `full` (atualização completa), `incremental` (atualização incremental) e `none` (nenhum modo de atualização definido).
`status`	Status da atualização. Valores válidos: `SUCCESS` (sucesso) e `FAILED` (falha na tarefa).
`queue_time_ms`	Tempo de espera por recursos do Serverless Computing. Exibido apenas para atualizações que utilizam Serverless Computing.
`serverless_allocated_cores`	Quantidade de recursos do Serverless Computing utilizados, medida em CUs. Exibido apenas para atualizações que utilizam Serverless Computing.
`serverless_allocated_workers`	Número de workers serverless utilizados. Exibido apenas para atualizações que utilizam Serverless Computing.
`serverless_resource_used_time_ms`	Tempo em que os recursos do Serverless Computing foram ativamente utilizados para executar a consulta, em milissegundos. Não inclui o tempo de fila. Exibido apenas para atualizações que utilizam Serverless Computing.

Exemplo: localizar atualizações com falha na última semana

SELECT
  dynamic_table_name,
  refresh_start,
  refresh_end,
  duration,
  refresh_mode,
  status
FROM hologres.hg_dynamic_table_refresh_history
WHERE status = 'FAILED'
  AND refresh_start >= NOW() - INTERVAL '7 days'
ORDER BY refresh_start DESC;

Exemplo: verificar a latência de atualização de uma Dynamic Table específica

SELECT
  refresh_start,
  refresh_end,
  duration,
  refresh_latency,
  status
FROM hologres.hg_dynamic_table_refresh_history
WHERE dynamic_table_name = '<your_dynamic_table>'
ORDER BY refresh_start DESC
LIMIT 20;

Hologres:System tables for dynamic table

Tabela de sistema `hologres.hg_dynamic_table_properties`

Tabela de sistema `hologres.hg_dynamic_table_dependencies`

Tabela de sistema `hologres.hg_dynamic_table_refresh_activity`

Tabela de sistema `hologres.hg_dynamic_table_refresh_history`

Próximos passos

Tabela de sistema hologres.hg_dynamic_table_properties

Tabela de sistema hologres.hg_dynamic_table_dependencies

Tabela de sistema hologres.hg_dynamic_table_refresh_activity

Tabela de sistema hologres.hg_dynamic_table_refresh_history

Próximos passos

Tabela de sistema `hologres.hg_dynamic_table_properties`

Tabela de sistema `hologres.hg_dynamic_table_dependencies`

Tabela de sistema `hologres.hg_dynamic_table_refresh_activity`

Tabela de sistema `hologres.hg_dynamic_table_refresh_history`