すべてのプロダクト
Search
ドキュメントセンター

Hologres:Hologres の動的テーブルのシステムテーブルの概要

最終更新日:Feb 04, 2026

このトピックでは、Hologres の動的テーブルに関連するシステムテーブルについて説明します。

テーブル名

説明

hologres.hg_dynamic_table_properties システムテーブル

動的テーブルのメタデータを格納します。

hologres.hg_dynamic_table_dependencies システムテーブル

動的テーブルのデータリネージを格納します。

hologres.hg_dynamic_table_refresh_activity システムテーブル

実行中の動的テーブルの更新タスクに関する情報を格納します。

説明

このシステムテーブルは、V3.1 以降の Hologres インスタンスではサポートされていません。

hologres.hg_dynamic_table_refresh_history システムテーブル

動的テーブルの更新タスクの履歴を格納します。

hologres.hg_dynamic_table_properties システムテーブル

hologres.hg_dynamic_table_properties システムテーブルは、動的テーブルのメタデータを格納します。次の表に、そのフィールドを示します。

フィールド

説明

dynamic_table_namespace

動的テーブルが存在するスキーマ。

dynamic_table_name

動的テーブルの名前。

property_key and property_value

動的テーブルのプロパティとプロパティ値。プロパティは次のとおりです:

  • 一般的なプロパティ:

    • execution_mode:更新モード。有効値:

      • full:完全更新。

      • incremental:増分更新。

      • none:更新モードは設定されていません。

    • task_definition:動的テーブルのクエリ定義。

    • auto_refresh_enable:自動更新を有効にするかどうかを指定します。有効値:

      • true:有効。

      • false: キャンセル。

    • task_definition_search_path:クエリのスキーマ。

    • state_time_to_live_in_seconds:状態表内のデータのライフサイクル。

  • 増分更新のパラメーター:

    • incremental_auto_refresh_schd_start_time:更新の開始時刻。有効値:

      • immediate:テーブル作成後すぐに更新が開始されます。

      • カスタム時刻:2024-08-27 15:00:00 などの特定の時刻値。

    • incremental_auto_refresh_interval:更新間隔。値の範囲は 1 分から 48 時間です。

    • incremental_guc_hg_computing_resource:更新用のコンピューティングリソース。値は serverless で、更新にサーバーレスコンピューティングリソースが使用されることを示します。

    • incremental_guc_hg_experimental_serverless_computing_required_cores:増分更新用のコンピューティングリソースの仕様。

    • incremental_state_table_group:増分更新モードで状態表が存在するテーブルグループ。

    • incremental_plan:増分更新の実行計画。

  • 完全更新のパラメーター:

    • full_auto_refresh_schd_start_time:更新の開始時刻。有効値:

      • immediate:テーブル作成後すぐに更新が開始されます。

      • カスタム時刻:2024-08-27 15:00:00 などの特定の時刻値。

    • full_auto_refresh_interval:更新間隔。値の範囲は 1 分から 48 時間です。

    • full_guc_hg_computing_resource:使用されるコンピューティングリソース。有効値:

      • local:現在のインスタンスのリソースが使用されます。

      • serverless:サーバーレスリソースが使用されます。サーバーレスリソースの詳細については、「サーバーレスコンピューティング」をご参照ください。

    • full_guc_hg_experimental_serverless_computing_required_cores:完全更新用のコンピューティングリソースの仕様。

hologres.hg_dynamic_table_dependencies システムテーブル

hologres.hg_dynamic_table_dependencies システムテーブルは、動的テーブルのデータリネージを格納します。次の表に、そのフィールドを示します。次の点にご注意ください:

  • 1 つの動的テーブルが複数のベーステーブルに対応する場合があるため、複数のレコードが存在する可能性があります。

  • 状態表も動的テーブルのベーステーブルと見なされます。デフォルトでは、hologres_streaming_mv システムスキーマに配置されます。実際には無視してかまいません。

  • pg_class などのシステムテーブルを使用して、動的テーブルのベーステーブルをさらに区別できます。

フィールド

説明

table_namespace

ベーステーブルが存在するスキーマ。

table_name

ベーステーブルの名前。

dynamic_table_namespace

動的テーブルが存在するスキーマ。

dynamic_table_name

動的テーブルの名前。

dependency

ベーステーブルのタイプ。有効値:

  • base_table: 標準テーブル。

  • base_dimension_table: ディメンションテーブル。

  • internal_table:内部テーブル。実際にはこの値を無視してかまいません。

hologres.hg_dynamic_table_refresh_activity システムテーブル

説明

このシステムテーブルは、V3.1 以降の Hologres インスタンスではサポートされていません。

hologres.hg_dynamic_table_refresh_activity システムテーブルは、現在実行中の動的テーブルの更新タスクを記録します。次の表に、そのフィールドを示します:

フィールド

説明

pid

動的テーブル更新タスクのプロセス ID。

PID を使用して、実行中の更新タスクをキャンセルできます。詳細については、「更新タスクのキャンセル」をご参照ください。

datname

動的テーブルが存在するデータベース。

query_id

動的テーブル更新タスクのクエリ ID。

usename

動的テーブルの更新を実行するユーザー。

query

更新クエリ。

refresh_mode

動的テーブルの更新モード。有効値:

  • full:完全更新。

  • incremental:増分更新。

  • none:更新モードは設定されていません。

refresh_start

更新タスクの開始時刻。

duration

更新タスクの実行時間。

serverless_queue_time_ms

更新タスクがサーバーレスリソースを使用するためのキューイング時間。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

serverless_resource_used_time_ms

更新タスクがサーバーレスリソースを使用する時間。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

serverless_allocated_cores

更新タスクによって使用されるサーバーレスリソースの仕様。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

serverless_allocated_workers

更新タスクによって使用されるサーバーレスワーカーの数。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

table_write

更新タスクが実行される動的テーブル。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

hologres.hg_dynamic_table_refresh_history システムテーブル

hologres.hg_dynamic_table_refresh_history システムテーブルは、動的テーブル更新タスクの履歴データを格納します。デフォルトでは、データは 1 か月間保持されます。次の表に、そのフィールドを示します。

フィールド

説明

datname

動的テーブルが存在するデータベースの名前。

schema_name

動的テーブルが存在するスキーマ。

dynamic_table_name

動的テーブルの名前。

query_id

更新のクエリ ID。

クエリ ID を使用して Query Insight に移動し、より詳細なクエリ情報を表示できます。

refresh_start

更新の開始時刻。

refresh_end

更新の終了時刻。

duration

更新の期間。

refresh_latency

更新完了時のデータ遅延。

refresh_mode

動的テーブルの更新モード。有効値:

  • full:完全更新。

  • incremental:増分更新。

  • none:更新モードは設定されていません。

status

更新のステータス。有効値:

  • SUCCESS:成功。

  • FAILED:タスクは失敗しました。

queue_time_ms

サーバーレスリソースをリクエストするためのキューイング時間。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

serverless_allocated_cores

使用されたサーバーレスリソースの量 (CU 単位)。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

serverless_allocated_workers

使用されたサーバーレスワーカーの数。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

serverless_resource_used_time_ms

クエリの実行にサーバーレスリソースが実際に使用された時間 (ミリ秒単位)。これには、リソースのキューイング時間は含まれません。

説明

このフィールドは、サーバーレスコンピューティングリソースを使用して実行される更新の場合にのみ表示されます。

参考

これらのシステムテーブルの使用方法の詳細については、次のトピックをご参照ください: