BigQuery テーブルやカラムの説明（メタデータ）を自動生成する

こんにちは、デジタルマーケティング事業に携わっている神崎です。本記事では、Google Cloud の BigQuery でテーブルやカラムの説明（メタデータ）を自動生成する方法について、紹介します。

docs.cloud.google.com

今回ご紹介する内容は、2026年3月19日に開催された Google Cloud のイベント「Agentic AI Summit '26 Spring」で私が講演した内容をもとにしたものです。よろしければ、以下のページより講演のアーカイブ配信もご覧ください。

cloudonair.withgoogle.com

本記事の目次は、下記のとおりです。

BigQuery のメタデータの自動生成機能概要
BigQuery のメタデータを自動生成する方法
BigQuery のメタデータの取り扱いについてのポイント
BigQuery のメタデータの自動生成機能についての留意事項
おわりに

BigQuery のメタデータの自動生成機能概要

BigQuery でテーブルやカラムの説明を自動生成する機能は、「データエージェントファミリー」と呼ばれる Google Cloud の AI エージェント群の、Data Governance Agent の機能です。

※出典：生成 AI が拓くデータ活用の新境地：Google Cloud の「データエージェント」とは？
https://www.youtube.com/watch?v=YGZozq561iI

以下は、Google アナリティクスのエクスポートデータの整形テーブルについての説明を自動生成した例です。

BigQuery テーブルやカラムの説明は、「データエージェントファミリー」の一員である Conversational Analytics Agent や Data Science Agent からも参照され、会話分析時の返答精度向上に役立ちます。
Conversational Analytics Agent の機能のひとつである、BigQuery の会話分析機能については、以下の記事をご参照ください。

tech.nri-net.com

BigQuery のメタデータを自動生成する方法

まずは、テーブルやカラムの説明を生成したい BigQuery のテーブルを選択します。
テーブルやカラムの説明は標準では英語で出力されますが、テーブルの説明に「Generate table and column descriptions in "｛言語（日本語の場合 ja）｝"」のように事前入力しておくことで、日本語を含む他言語の説明を生成できます。

サポートされている言語の一覧については、下記のページより Gemini の言語サポートをご参照ください。

Google モデル | Generative AI on Vertex AI | Google Cloud Documentation

続いて「Gemini を使用してテーブルと列の説明を～」箇所にある「生成」ボタンを押下すると、説明の生成が開始されます。

しばらく経つと、自動生成されたテーブルの説明が表示されます。続けて「列の説明を表示」を押下します。

説明のプレビュー画面が表示されるので、自動生成されたテーブル・カラムの説明を確認の上、保存（詳細に保存、スキーマに保存）します。

以上で、テーブルやカラムの説明の自動生成～保存は完了です。

BigQuery のメタデータの取り扱いについてのポイント

BigQuery のメタデータの自動生成機能で生成された説明は、手動で編集可能です。
日付やページの URL などの汎用的な内容のカラムであれば、自動生成された結果をそのまま利用できますが、定義が複雑／独特なカラムや、集計ロジックとの関係性が深いカラムは、手動で編集することを推奨します。

たとえば、下図では「ga_session_id」というカラムの説明の手動編集前後で、BigQuery の会話分析機能利用時に実行される SQL が変わっていることがわかります。

自動生成された説明のままでも、正しく集計が行われる場合もありますが、安定性向上のためには、このようなひと手間が重要となります。

BigQuery のメタデータの自動生成機能についての留意事項

BigQuery のメタデータの自動生成機能には、下記 Gemini in BigQuery の料金体系が適用されます。本記事執筆時点において、標準の BigQuery オンデマンドコンピューティングでは無料で利用できますが、BigQuery Standard エディションでは利用できない点に注意してください。