メインコンテンツまでスキップ
バージョン: 26.2 Preview

table_bookmark_summary / _partitions / _references

information_schema.table_bookmark_summary、table_bookmark_partitions、table_bookmark_references は、StarRocks クラスター上のアクティブなブックマークの状態を提供します。ブックマークは、OlapTable のパーティション状態のイミュータブルな記録であり、ある時点で取得され、vacuum とタイムスタンプベースのルックアップに備えてパーティションバージョンを固定します。

3 つのテーブルは (DB_ID, TABLE_ID, BOOKMARK_ID) で結合します。

table_bookmark_summary​

ブックマークインベントリ。 アクティブなブックマークごとに 1 行を返し、作成時刻、パーティション数 / 参照数、および概要集計（直近に変化した 3 つのパーティション、最も古い保持者と最も新しい保持者）を含みます。テーブルやクラスターにどのブックマークが存在するかを知りたいときに最初に問い合わせるテーブルです。

カラム型説明
DB_IDBIGINT内部データベース ID。
TABLE_IDBIGINT内部テーブル ID。
BOOKMARK_IDBIGINTブックマーク ID（テーブル内で一意）。
CREATE_TIMEDATETIMEブックマークが取得された時刻。
LOGICAL_PARTITION_COUNTBIGINTキャプチャされた論理パーティション数。
PHYSICAL_PARTITION_COUNTBIGINTキャプチャされた物理パーティション数。
REFERENCE_COUNTBIGINTこのブックマークを参照している保持者の現在数。
LATEST_CHANGED_PHYSICAL_PARTITIONSARRAY<STRUCT<id BIGINT, version BIGINT, time DATETIME>>visible_version_time が最も新しい物理パーティションを最大 3 件、時刻の降順で返します。同値の場合は physical_partition_id が大きい方を優先します。ブックマークがパーティションをキャプチャしていない場合は空配列。パーティション数が 3 未満の場合は要素数も少なくなります。
OLDEST_REFERENCESTRUCT<id VARCHAR, time DATETIME, ttl_ms BIGINT>現在の取得時刻が最も古い保持者。同値の場合は保持者 ID が辞書順で最小の方を優先します。ttl_ms はその保持者の実効リース（ミリ秒）です。参照単位の TTL とクラスター上限 bookmark_reference_max_ttl_ms のうち小さい方（両方とも未設定の場合のみ -1）。time + ttl_ms は有効期限ではありません。更新し続ける保持者はそれを超えて存続します。table_bookmark_references.EXPIRE_TIME を参照してください。
NEWEST_REFERENCESTRUCT<id VARCHAR, time DATETIME, ttl_ms BIGINT>現在の取得時刻が最も新しい保持者。同値の場合の優先ルールは同じ。ttl_ms はその保持者の実効リース（ミリ秒）で、規則は OLDEST_REFERENCE と同じです。

table_bookmark_partitions​

パーティション粒度の詳細。 (bookmark, physical_partition) の組み合わせごとに 1 行を返し、ブックマークがどのパーティションバージョンを固定しているかを正確に示します。vacuum をデバッグする際にこのテーブルを問い合わせ、physical_partition_id で partitions_meta と結合することで、現在のテーブルより古いバージョンを保持しているブックマークを特定できます。

カラム型説明
DB_ID, TABLE_ID, BOOKMARK_ID(summary と同じ)結合キー。
LOGICAL_PARTITION_IDBIGINT論理パーティション ID。
PHYSICAL_PARTITION_IDBIGINT物理パーティション ID。
VISIBLE_VERSIONBIGINTこのブックマークでキャプチャされたパーティションの可視バージョン。
VISIBLE_VERSION_TIMEDATETIMEその可視バージョンが可視になった実時刻。
BASE_MATERIALIZED_INDEX_META_IDBIGINTブックマーク取得時点のベースマテリアライズドインデックスメタ ID。スキーマ変更 / リシャードで変化します。
BASE_MATERIALIZED_INDEX_IDBIGINTブックマーク取得時点のベースマテリアライズドインデックス ID。

table_bookmark_references​

保持者粒度の詳細。 (bookmark, holder) の組み合わせごとに 1 行を返し、現在誰がブックマークを生存させているか、いつ取得したかを示します。特定のマテリアライズドビューやその他の保持者が保持しているブックマークを調べる際に問い合わせるテーブルです。

カラム型説明
DB_ID, TABLE_ID, BOOKMARK_ID(summary と同じ)結合キー。
HOLDER_IDVARCHAR保持者の識別子。マテリアライズドビューは mv:<dbId>-<mvId> の形式でエンコードされます。
CREATE_TIMEDATETIMEこの保持者がブックマークを取得した時刻。更新（renew）では変わりません。
TTL_MSBIGINT実効リース期間（ミリ秒）。取得時に設定され、更新のたびに置き換えられる参照単位 TTL と、クラスター上限 bookmark_reference_max_ttl_ms のうち小さい方です。どちらか一方が <= 0 の場合はその側を制限なしとして扱うため、本カラムが -1 になるのは両方とも未設定のときだけです。起点は LAST_RENEW_TIME（更新されたことがない場合は CREATE_TIME）です。
LAST_RENEW_TIMEDATETIMEこの保持者のリースが最後に更新された時刻。bookmark_renew の呼び出しによる場合と、インクリメンタルマテリアライズドビューが変化のないベーステーブル上でこの pin を再利用した際に自動的に更新される場合があります。一度も更新されていない場合は NULL。
EXPIRE_TIMEDATETIMEクリーンアップスイープがこの参照を回収する時刻。リース起点に TTL_MS を加えた値です。TTL_MS が -1（期限なし）の場合は NULL。
RENEW_COUNTBIGINTこの参照のリースが更新された回数。一度も更新されていない場合は 0。

クエリパターン​

インベントリ: テーブルの全ブックマークを列挙する​

SELECT * FROM information_schema.table_bookmark_summary
WHERE table_id = <table_id>;

Vacuum デバッグ: 最も古いブックマークが固定しているパーティションを調べる​

SELECT p.physical_partition_id, p.visible_version
FROM information_schema.table_bookmark_partitions p
JOIN information_schema.table_bookmark_summary s
  USING (db_id, table_id, bookmark_id)
WHERE s.table_id = <table_id>
ORDER BY s.create_time ASC
LIMIT 100;

MV 保持者ルックアップ: MV が保持しているブックマークを検索する​

SELECT * FROM information_schema.table_bookmark_references
WHERE holder_id = 'mv:1001-2003';

リース: まもなく期限切れになる参照​

SELECT holder_id, ttl_ms, renew_count, expire_time
FROM information_schema.table_bookmark_references
WHERE expire_time IS NOT NULL
ORDER BY expire_time;

注意事項​

  • 行は権限でフィルタされます。ユーザーは自身が SELECT 可能なテーブル上のブックマークのみを参照できます。