Appearance
カタログ
概要
カタログは、テーブルと保存済みクエリのメタデータを一覧・詳細で確認し、説明やタグを付与する機能です。グローバルナビ > カタログ から利用します。テーブルメタデータの取り込み元は コネクション です。コネクション詳細の カタログで閲覧 からも開けます。開くと、対象コネクションで絞り込まれた一覧が表示されます。
カタログ専用のリソースロールはありません。閲覧・編集は関連コネクションの権限に準じます。詳細は カタログ を参照してください。
主な機能
- テーブルメタデータの同期: コネクションからテーブル・カラムのメタデータを取り込み、定期・手動で更新します
- アノテーション: テーブルとカラムに説明・タグを付与します
- 人気度と参照: クエリジョブに基づく人気度と、参照関係の確認
- 絞り込みと検索: 共通フィルタ、コネクション、検索キーによる一覧の絞り込み
- ノートブック / クエリの作成: カタログからノートブックや保存済みクエリを作成します
画面構成
左サイドバーで テーブル と クエリ を切り替えます。
- テーブル: 同期済みテーブルの一覧と詳細
- クエリ: 保存済みクエリの一覧と詳細
左サイドバーには次もあります。
- 共通フィルタ: スター(スター付きのみ)。クエリ側では 自分が作成 も使えます
- コネクション: コネクション単位の絞り込み。コネクションを管理 から コネクション の設定画面へ移動できます
テーブル詳細
テーブルを開くと、次のタブがあります。
| タブ | 内容 |
|---|---|
| 概要 | コネクション、構造、説明、タイプ、タグ、ストレージ情報、日時 |
| カラム | カラム一覧。説明とタグを編集できます |
| プレビュー | テーブルデータのプレビュー(最大 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 でも同じ絞り込みができます。
ノートブック / クエリの作成
一覧の アクション から、選択中のリソースを起点に作成できます。
- ノートブックを作成: テーブルまたはクエリからノートブックを作成します
- クエリを作成: テーブルから保存済みクエリを作成します(テーブル一覧のみ)
ノートブック数が上限に達している場合、ノートブックを作成 は無効になります。