Skip to content

カタログ

概要

カタログは、テーブルと保存済みクエリのメタデータを一覧・詳細で確認し、説明やタグを付与する機能です。グローバルナビ > カタログ から利用します。テーブルメタデータの取り込み元は コネクション です。コネクション詳細の カタログで閲覧 からも開けます。開くと、対象コネクションで絞り込まれた一覧が表示されます。

カタログ専用のリソースロールはありません。閲覧・編集は関連コネクションの権限に準じます。詳細は カタログ を参照してください。

主な機能

画面構成

左サイドバーテーブルクエリ を切り替えます。

  • テーブル: 同期済みテーブルの一覧と詳細
  • クエリ: 保存済みクエリの一覧と詳細

左サイドバーには次もあります。

  • 共通フィルタ: スター(スター付きのみ)。クエリ側では 自分が作成 も使えます
  • コネクション: コネクション単位の絞り込み。コネクションを管理 から コネクション の設定画面へ移動できます

テーブル詳細

テーブルを開くと、次のタブがあります。

タブ内容
概要コネクション、構造、説明、タイプ、タグ、ストレージ情報、日時
カラムカラム一覧。説明とタグを編集できます
プレビューテーブルデータのプレビュー(最大 100 行。制約と上限値
参照参照元ノートブック / 参照元クエリ
クエリジョブこのテーブルを参照したクエリジョブ
その他定義、データロケーション、ビュークエリ、パーティションなど(取得できる場合)

クエリ詳細

クエリを開くと、次のタブがあります。

タブ内容
概要説明、タグなどのメタデータ
カラムカラム情報
SQL保存された SQL
プレビュー実行結果のプレビュー
参照参照関係
クエリジョブ関連するクエリジョブ

クエリ本体の編集・管理は クエリ 画面でも行えます。

人気度と参照

カタログでは、リソースがどれだけ使われているか(人気度)と、どこから参照されているか(参照)を確認できます。両者は別の情報です。

人気度

一覧の 人気度 列に表示されます(テーブル・クエリ)。

  • 人気度は、そのリソースを参照するクエリジョブの数に基づきます
  • ヘルプ文言(テーブル): 「人気度はテーブルを参照するジョブ数に基づきます。」
  • ツールチップでは参照ジョブ数を確認でき、ジョブ一覧を表示 から詳細の クエリジョブ タブへ移動できます

相対的なスコアとして表示されます。ジョブが無い場合は人気度も空(または 0)になります。

参照

詳細の 参照 タブでは、次を確認できます。

  • 参照元ノートブック: そのテーブル(またはクエリ)を参照しているノートブック
  • 参照元クエリ: 参照している保存済みクエリ

参照が無い場合は 参照なし と表示されます。

クエリジョブ

詳細の クエリジョブ タブでは、そのリソースを参照したクエリジョブの履歴を確認できます。人気度の根拠となるジョブ一覧としても使えます。

絞り込みと検索

一覧上部の検索欄では、キーワードに加えて次のキーで候補から絞り込めます。空白区切りで複数指定できます。キーを入力すると候補が表示されます。

テーブル

キー内容
connection:コネクション
database:データベース(BigQuery ではプロジェクト)
schema:スキーマ(BigQuery ではデータセット)
type:テーブルタイプ
tag:テーブルタグ
updatedBy:更新者
is:starred(スター付きのみ)
sortBy:並び替え。候補は Popularity / Rows です

クエリ

キー内容
connection:コネクション
tag:クエリタグ
createdBy:作成者
updatedBy:更新者
is:starred(スター付きのみ)
sortBy:並び替え。候補は Popularity / Updated です

適用中の条件は検索欄付近のタグとして表示されます(例: is:starred)。

スター

一覧・詳細のスターアイコンで、テーブルやクエリにスターを付けたり外したりできます。付けたリソースは左サイドバーの 共通フィルタ > スター で絞り込めます。検索の is:starred でも同じ絞り込みができます。

ノートブック / クエリの作成

一覧の アクション から、選択中のリソースを起点に作成できます。

  • ノートブックを作成: テーブルまたはクエリからノートブックを作成します
  • クエリを作成: テーブルから保存済みクエリを作成します(テーブル一覧のみ)

ノートブック数が上限に達している場合、ノートブックを作成 は無効になります。