文档

Hologres Dynamic Table系统表介绍

更新时间:

本文为您介绍Hologres Dynamic Table相关的系统表信息。

表名称

说明

hologres.hg_dynamic_table_properties系统表

存储Dynamic Table的元数据信息。

hologres.hg_dynamic_table_dependencies系统表

存储Dynamic Table的血缘信息。

hologres.hg_dynamic_table_refresh_activity系统表

存储正在运行的Dynamic Table刷新任务信息。

hologres.hg_dynamic_table_refresh_history 系统表

存储Dynamic Table刷新任务的历史记录。

hologres.hg_dynamic_table_properties系统表

hologres.hg_dynamic_table_properties系统表,用于存储Dynamic Table的元数据信息,其字段及含义如下。

字段

描述

dynamic_table_namespace

Dynamic Table所在的Schema。

dynamic_table_name

Dynamic Table的表名。

property_key和property_value

Dynamic Table的表属性和属性值,属性详情如下:

  • 通用属性:

    • execution_mode:刷新模式,取值如下:

      • full:全量刷新。

      • incremental:增量刷新。

      • none:未设置刷新模式。

    • task_definition:Dynamic Table的Query定义。

    • auto_refresh_enable:是否开启自动刷新,取值如下:

      • true:开启。

      • false:取消。

    • task_definition_search_path:Query的Schema。

    • state_time_to_live_in_seconds:状态表数据的生命周期。

  • 增量刷新相关参数:

    • incremental_auto_refresh_schd_start_time:刷新的开始时间,取值如下:

      • immediate:建表成功后立即开始。

      • 自定义时间:具体的时间值,如:2024-08-27 15:00:00。

    • incremental_auto_refresh_interval:刷新的时间间隔,取值范围:取值区间为[1min,48hours]。

    • incremental_guc_hg_computing_resource:刷新的计算资源,取值为serverless,表示使用serverless计算资源执行刷新。

    • incremental_guc_hg_experimental_serverless_computing_required_cores:增量刷新的计算资源规格。

    • incremental_state_table_group:增量刷新模式下,状态表所在的Table Group。

    • incremental_plan:增量刷新的执行计划。

  • 全量刷新相关参数:

    • full_auto_refresh_schd_start_time:刷新的开始时间,取值如下:

      • immediate:建表成功后立即开始

      • 自定义时间:具体的时间值,如2024-08-27 15:00:00

    • full_auto_refresh_interval:刷新的时间间隔,取值范围:取值区间为[1min,48hours]。

    • full_guc_hg_computing_resource:使用的计算资源,取值如下:

    • full_guc_hg_experimental_serverless_computing_required_cores:全量刷新的计算资源规格。

hologres.hg_dynamic_table_dependencies系统表

hologres.hg_dynamic_table_dependencies系统表,用于存储Dynamic Table的血缘信息,其字段及含义如下。其中需注意:

  • 一张Dynamic Table表可能对应多个基表,因此会有多条数据。

  • 状态表(State)也会被视为Dynamic Table的基表,默认放在hologres_streaming_mv系统Schema下,在实际使用中建议忽略。

  • 可以结合pg_class等系统表对dynamic table的基表做进一步的区分。

字段

描述

table_namespace

基表所在的Schema。

table_name

基表的表名称。

dynamic_table_namespace

Dynamic Table所在的Schema。

dynamic_table_name

Dynamic Table的表名。

dependency

基表类型,取值如下:

  • base_table:普通表。

  • base_dimension_table:维表。

  • internal_table:内部表,实际使用中可忽略。

hologres.hg_dynamic_table_refresh_activity系统表

hologres.hg_dynamic_table_refresh_activity系统表记录正在运行的Dynamic Table刷新任务,只记录当前正在运行的任务。其字段以及含义如下:

字段

描述

pid

Dynamic Table刷新任务的进程ID。

您可以通过pid取消某个正在运行的刷新任务,详情见取消刷新任务

datname

Dynamic Table所在的数据库。

query_id

Dynamic Table Refresh任务对应的Query ID。

usename

执行Dynamic Table刷新的用户。

query

Refresh Query。

refresh_mode

Dynamic Table的刷新模式。取值如下:

  • full:全量刷新。

  • incremental:增量刷新。

  • none:未设置刷新模式。

refresh_start

Refresh任务的开始执行时间。

duration

Refresh任务执行时长。

serverless_queue_time_ms

Refresh任务使用Serverless资源的排队时间。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

serverless_resource_used_time_ms

Refresh使用Serverless资源的时间。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

serverless_allocated_cores

Refresh任务使用Serverless资源的规格。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

serverless_allocated_workers

Refresh任务使用Serverless资源的Worker数。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

table_write

Refresh任务作用的Dynamic Table。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

hologres.hg_dynamic_table_refresh_history 系统表

hologres.hg_dynamic_table_refresh_history系统表,用于存储Dynamic Table刷新任务的历史数据,数据默认保留一个月,其字段以及含义如下。

字段

描述

datname

Dynamic Table所在的数据库名称。

schema_name

Dynamic Table所在的Schema。

dynamic_table_name

Dynamic Table的表名称。

query_id

Refresh的Query ID。

您可以通过Query ID前往Query洞察查看更详细的Query信息。

refresh_start

Refresh的开始时间。

refresh_end

Refresh的结束时间。

duration

Refresh的耗时。

refresh_latency

本次Refresh完成时的数据延迟。

refresh_mode

Dynamic Table的刷新模式,取值如下:

  • full:全量刷新。

  • incremental:增量刷新。

  • none:未设置刷新模式。

status

Refresh的状态,取值如下:

  • SUCCESS:成功。

  • FAILED:失败。

queue_time_ms

申请Serverless资源的排队时间。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

serverless_allocated_cores

使用的Serverless资源量(单位:CU)。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

serverless_allocated_workers

使用的Serverless Worker个数。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

serverless_resource_used_time_ms

实际使用Serverless资源执行Query的时长(单位:毫秒),不包含资源等待排队时长。

说明

仅使用Serverless Computing资源执行的Refresh显示该字段。

相关文档

上述系统表使用示例详情,请参见: