System tables for dynamic table - Hologres - Centro de documentación de Alibaba Cloud

Hologres ofrece cuatro tablas del sistema para gestionar y monitorear las Dynamic Tables. Utilice estas tablas para inspeccionar metadatos, rastrear el linaje de datos y diagnosticar problemas en las tareas de actualización.

Tabla del sistema	Descripción
`hologres.hg_dynamic_table_properties`	Almacena los metadatos de la Dynamic Table, incluido el modo de actualización, la programación y la configuración de recursos de cómputo.
`hologres.hg_dynamic_table_dependencies`	Almacena el linaje de datos, es decir, las tablas base de las que depende una Dynamic Table.
`hologres.hg_dynamic_table_refresh_activity`	Almacena las tareas de actualización que se ejecutan actualmente. No es compatible con Hologres V3.1 ni versiones posteriores.
`hologres.hg_dynamic_table_refresh_history`	Almacena el historial de tareas de actualización. De forma predeterminada, los datos se conservan durante un mes.

La tabla del sistema `hologres.hg_dynamic_table_properties`

Esta tabla almacena los metadatos de cada Dynamic Table, incluida su configuración de actualización y la definición de la consulta.

Campo	Descripción
`dynamic_table_namespace`	El esquema donde reside la Dynamic Table.
`dynamic_table_name`	El nombre de la Dynamic Table.
`property_key` y `property_value`	El nombre de la propiedad y su valor. Consulte las siguientes tablas para ver todas las propiedades compatibles.

Propiedades generales

Propiedad	Descripción
`execution_mode`	El modo de actualización. Valores válidos: `full` (actualización completa), `incremental` (actualización incremental), `none` (sin modo de actualización establecido).
`task_definition`	La definición de consulta de la Dynamic Table.
`auto_refresh_enable`	Indica si la actualización automática está habilitada. Valores válidos: `true` (habilitado), `false` (Cancel).
`task_definition_search_path`	El esquema de la consulta.
`state_time_to_live_in_seconds`	El periodo de retención de datos en la tabla de estado, en segundos.

Parámetros para la actualización incremental

Propiedad	Descripción
`incremental_auto_refresh_schd_start_time`	La hora de inicio de la actualización. Valores válidos: `immediate` (comienza inmediatamente después de crear la tabla) o una hora personalizada como `2024-08-27 15:00:00`.
`incremental_auto_refresh_interval`	El intervalo de actualización. Rango: de 1 minuto a 48 horas.
`incremental_guc_hg_computing_resource`	El recurso de cómputo para la actualización. El valor es `serverless`, lo que indica que se utilizan recursos de Serverless Computing.
`incremental_guc_hg_experimental_serverless_computing_required_cores`	Las especificaciones de recursos de cómputo para la actualización incremental.
`incremental_state_table_group`	El grupo de tablas donde reside la tabla de estado en el modo de actualización incremental.
`incremental_plan`	El plan de ejecución para la actualización incremental.

Parámetros para la actualización completa

Propiedad	Descripción
`full_auto_refresh_schd_start_time`	La hora de inicio de la actualización. Valores válidos: `immediate` (comienza inmediatamente después de crear la tabla) o una hora personalizada como `2024-08-27 15:00:00`.
`full_auto_refresh_interval`	El intervalo de actualización. Rango: de 1 minuto a 48 horas.
`full_guc_hg_computing_resource`	El recurso de cómputo utilizado. Valores válidos: `local` (utiliza los recursos de la instancia actual), `serverless` (utiliza recursos de Serverless Computing). Para obtener más información, consulte Serverless Computing.
`full_guc_hg_experimental_serverless_computing_required_cores`	Las especificaciones de recursos de cómputo para la actualización completa.

La tabla del sistema `hologres.hg_dynamic_table_dependencies`

Esta tabla almacena el linaje de datos de las Dynamic Tables; específicamente, de qué tablas base depende cada Dynamic Table.

Notas de uso:

Una Dynamic Table puede depender de varias tablas base, por lo que pueden aparecer múltiples filas para una sola Dynamic Table.
La tabla de estado utilizada en la actualización incremental también se registra como una tabla base. De forma predeterminada, se encuentra en el esquema del sistema hologres_streaming_mv. En la práctica, ignore las filas con este esquema.
Utilice tablas del sistema como pg_class para diferenciar aún más los tipos de tablas base.

Campo	Descripción
`table_namespace`	El esquema donde reside la tabla base.
`table_name`	El nombre de la tabla base.
`dynamic_table_namespace`	El esquema donde reside la Dynamic Table.
`dynamic_table_name`	El nombre de la Dynamic Table.
`dependency`	El tipo de la tabla base. Valores válidos: `base_table` (tabla estándar), `base_dimension_table` (tabla de dimensiones), `internal_table` (tabla interna; ignórela en la práctica).

Ejemplo: consultar el linaje de datos de una 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;

La tabla del sistema `hologres.hg_dynamic_table_refresh_activity`

Esta tabla del sistema no es compatible con instancias de Hologres V3.1 ni versiones posteriores. Utilice hologres.hg_dynamic_table_refresh_history para consultar las tareas de actualización completadas.

Esta tabla registra las tareas de actualización de Dynamic Tables que se están ejecutando actualmente.

Campo	Descripción
`pid`	El identificador de proceso (PID) de la tarea de actualización. Utilice el PID para cancelar una tarea de actualización en ejecución. Para obtener más información, consulte Cancel a refresh task.
`datname`	La base de datos donde reside la Dynamic Table.
`query_id`	El identificador de consulta de la tarea de actualización.
`usename`	El usuario que realiza la actualización de la Dynamic Table.
`query`	La consulta de actualización.
`refresh_mode`	El modo de actualización. Valores válidos: `full` (actualización completa), `incremental` (actualización incremental), `none` (sin modo de actualización establecido).
`refresh_start`	La hora de inicio de la tarea de actualización.
`duration`	El tiempo de ejecución de la tarea de actualización.
`serverless_queue_time_ms`	El tiempo que la tarea de actualización pasó en espera de recursos de Serverless Computing. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`serverless_resource_used_time_ms`	El tiempo que la tarea de actualización utilizó recursos de Serverless Computing. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`serverless_allocated_cores`	Las especificaciones de recursos de Serverless Computing asignados a la tarea de actualización. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`serverless_allocated_workers`	El número de workers serverless asignados a la tarea de actualización. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`table_write`	La Dynamic Table sobre la que se realiza la tarea de actualización. Se muestra solo para actualizaciones que utilizan Serverless Computing.

La tabla del sistema `hologres.hg_dynamic_table_refresh_history`

Esta tabla almacena el historial de tareas de actualización de Dynamic Tables. De forma predeterminada, los datos se conservan durante un mes.

Campo	Descripción
`datname`	La base de datos donde reside la Dynamic Table.
`schema_name`	El esquema donde reside la Dynamic Table.
`dynamic_table_name`	El nombre de la Dynamic Table.
`query_id`	El identificador de consulta de la actualización. Utilice el identificador de consulta en Obtener información de consultas para consultar información detallada de la consulta.
`refresh_start`	La hora de inicio de la actualización.
`refresh_end`	La hora de finalización de la actualización.
`duration`	La duración de la actualización.
`refresh_latency`	La latencia de datos al momento de completar la actualización.
`refresh_mode`	El modo de actualización. Valores válidos: `full` (actualización completa), `incremental` (actualización incremental), `none` (sin modo de actualización establecido).
`status`	El estado de la actualización. Valores válidos: `SUCCESS` (Success), `FAILED` (The task failed).
`queue_time_ms`	El tiempo de espera por recursos de Serverless Computing. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`serverless_allocated_cores`	La cantidad de recursos de Serverless Computing utilizados, en CUs. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`serverless_allocated_workers`	El número de workers serverless utilizados. Se muestra solo para actualizaciones que utilizan Serverless Computing.
`serverless_resource_used_time_ms`	El tiempo durante el cual se utilizaron activamente los recursos de Serverless Computing para ejecutar la consulta, en milisegundos. No incluye el tiempo de espera en cola. Se muestra solo para actualizaciones que utilizan Serverless Computing.

Ejemplo: buscar actualizaciones con errores en la ú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;

Ejemplo: comprobar la latencia de actualización de una 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

La tabla del sistema `hologres.hg_dynamic_table_properties`

La tabla del sistema `hologres.hg_dynamic_table_dependencies`

La tabla del sistema `hologres.hg_dynamic_table_refresh_activity`

La tabla del sistema `hologres.hg_dynamic_table_refresh_history`

Pasos siguientes

La tabla del sistema hologres.hg_dynamic_table_properties

La tabla del sistema hologres.hg_dynamic_table_dependencies

La tabla del sistema hologres.hg_dynamic_table_refresh_activity

La tabla del sistema hologres.hg_dynamic_table_refresh_history

Pasos siguientes

La tabla del sistema `hologres.hg_dynamic_table_properties`

La tabla del sistema `hologres.hg_dynamic_table_dependencies`

La tabla del sistema `hologres.hg_dynamic_table_refresh_activity`

La tabla del sistema `hologres.hg_dynamic_table_refresh_history`