BigQuery Codelab で AI エージェントを使用してデータを準備する

BigQuery Codelab で AI エージェントを使用してデータを準備する

この Codelab について

subject最終更新: 4月 9, 2025
account_circle作成者: Tim Bezold

1. はじめに

コーディングの専門知識がなくても、分析に備えてデータをより迅速かつ効率的に準備できるとしたらどうでしょう。BigQuery Data Preparation を使用すると、それが現実になります。この強力な機能により、データの取り込み、変換、クレンジングが簡素化され、組織内のすべてのデータ担当者がデータ準備を行うことができます。

商品データに隠された秘密を解き明かす準備はできていますか？

  • Google Cloud コンソールの基本的な知識
  • SQL に関する基本的な知識
  • ファッションと美容業界の現実的な例を使用して、BigQuery データ準備で元データをクリーニングして、実用的なビジネス インテリジェンスに変換する方法について説明します。
  • クリーニングされたデータのデータ準備を実行してスケジュールを設定する方法

必要なもの

  • Google Cloud アカウントと Google Cloud プロジェクト
  • ウェブブラウザ（Chrome など）

2. 基本的な設定と要件

セルフペース型の環境設定

  1. Google Cloud コンソールにログインして、プロジェクトを新規作成するか、既存のプロジェクトを再利用します。Gmail アカウントも Google Workspace アカウントもまだお持ちでない場合は、アカウントを作成してください。

fbef9caa1602edd0.png

a99b7ace416376c4.png

5e3ff691252acf41.png

  • プロジェクト名は、このプロジェクトの参加者に表示される名称です。Google API では使用されない文字列です。いつでも更新できます。
  • プロジェクト ID は、すべての Google Cloud プロジェクトにおいて一意でなければならず、不変です（設定後は変更できません）。Cloud コンソールでは一意の文字列が自動生成されます。通常は、この内容を意識する必要はありません。ほとんどの Codelab では、プロジェクト ID（通常は PROJECT_ID と識別されます）を参照する必要があります。生成された ID が好みではない場合は、ランダムに別の ID を生成できます。または、ご自身で試して、利用可能かどうかを確認することもできます。このステップ以降は変更できず、プロジェクトを通して同じ ID になります。
  • なお、3 つ目の値として、一部の API が使用するプロジェクト番号があります。これら 3 つの値について詳しくは、こちらのドキュメントをご覧ください。
  1. 次に、Cloud のリソースや API を使用するために、Cloud コンソールで課金を有効にする必要があります。この Codelab の操作をすべて行って、費用が生じたとしても、少額です。このチュートリアルの終了後に請求が発生しないようにリソースをシャットダウンするには、作成したリソースを削除するか、プロジェクトを削除します。Google Cloud の新規ユーザーは、300 米ドル分の無料トライアル プログラムをご利用いただけます。

3. 始める前に

API を有効にする

Gemini in BigQuery を使用するには、Gemini for Google Cloud API を有効にする必要があります。通常、この手順は、serviceusage.services.enable IAM 権限を持つサービス管理者またはプロジェクト オーナーが行います。

  1. Gemini for Google Cloud API を有効にするには、Google Cloud Marketplace の [Gemini for Google Cloud] ページに移動します。[Gemini for Google Cloud] に移動
  2. プロジェクト セレクタでプロジェクトを選択します。
  3. [有効にする] をクリックします。ページが更新され、[有効] のステータスが表示されます。これで、必要な IAM 権限を持つすべてのユーザーが、選択した Google Cloud プロジェクトで Gemini in BigQuery を使用できるようになりました。

データ準備を開発するためのロールと権限を設定する

  1. [IAM と管理] で [IAM] を選択します。

4477412d79f29e0b.png

  1. ユーザーを選択し、鉛筆アイコンをクリックして [プリンシパルを編集] を選択します。

5eb558e04ad12362.png

BigQuery データ準備を使用するには、次のロールと権限が必要です。

4. BigQuery Analytics Hub で「bq data preparation demo」のリスティングを見つけてサブスクライブする

このチュートリアルでは、bq data preparation demo データセットを使用します。これは、BigQuery Analytics Hub のリンク済みデータセットで、読み取るデータセットです。

データ準備では、ソースに書き戻すことはありません。書き込む宛先テーブルを定義するよう求められます。この演習で使用するテーブルには 1,000 行のみが含まれており、費用を最小限に抑えていますが、データ準備は BigQuery で実行され、スケーリングされます。

リンクされたデータセットを見つけてサブスクライブする手順は次のとおりです。

  1. Analytics Hub にアクセスする: Google Cloud コンソールで BigQuery に移動します。
  2. BigQuery のナビゲーション メニューで、[ガバナンス] の下にある [Analytics Hub] を選択します。

6ddfac4dd863ca7b.png

  1. リスティングを検索する: Analytics Hub の UI で [リスティングを検索] をクリックします。」
  2. 検索バーに「bq data preparation demo」と入力して、Enter キーを押します。

7e0cb82b80174cdc.png

  1. リスティングを定期購入する: 検索結果から bq data preparation demo リスティングを選択します。
  2. リスティングの詳細ページで、[登録] ボタンをクリックします。
  3. 確認ダイアログを確認し、必要に応じてプロジェクトまたはデータセットを更新します。デフォルト設定はそのまま使用できるはずです。

2ef0ac1e3557f2f9.png

  1. BigQuery でデータセットにアクセスする: 定期購入が正常に完了すると、リスティング内のデータセットが BigQuery プロジェクトにリンクされます。

BigQuery Studio に戻ります。

5. データを探索してデータ準備を開始する

  1. データセットとテーブルを見つける: [エクスプローラ] パネルでプロジェクトを選択し、bq data preparation demo のリストに含まれているデータセットを見つけます。stg_product テーブルを選択します。
  2. データ準備で開く: テーブル名の横にあるその他アイコンをクリックし、Open in Data Preparation を選択します。

データ準備インターフェースでテーブルが開き、データの変換を開始できるようになります。

76ace3d4b5cfc2d0.png

以下のデータのプレビューに示すように、Google はいくつかのデータに関する課題に取り組んでいます。

  • 価格列には金額と通貨の両方が含まれるため、分析が困難です。
  • 商品列には、商品名とカテゴリが混在しています（パイプ記号 | で区切られています）。

f4d93aa59a56447a.png

Gemini はすぐにデータを分析し、いくつかの変換を提案します。この例では、いくつかの推奨事項が表示されています。必要なものは次のステップで適用します。

fd4d14e4fa3c31c1.png

6. 価格列の処理

次に、[Price] 列を処理します。ご覧のとおり、通貨と金額の両方が含まれています。目標は、これらを「通貨」と「金額」の 2 つの列に分離することです。

Gemini は、[価格] 列に関する推奨事項をいくつか特定しました。

  1. 次のような推奨事項を見つけます。

説明: 「この式は、指定したフィールドの先頭にある「USD」を削除します」

REGEXP_REPLACE(Price,` `r'^USD\s',` `r'')
  1. [プレビュー] を選択します。

c9327cfbd32247d6.png

  1. [適用] を選択します。

次に、Price 列のデータ型を STRING から NUMERIC に変換します。

  1. 次のような推奨事項を見つけます。

説明: 「列 Price の型を string から float64 に変換」

SAFE_CAST(Price AS float64)
  1. [適用] を選択します。

ステップリストに、適用された 3 つのステップが表示されます。

d3359af47dce0c15.png

7. 商品列の処理

product 列には、商品名とカテゴリの両方がパイプ（|）で区切られて格納されます。

自然言語で質問することもできますが、Gemini の強力な機能のもう 1 つを試してみましょう。

商品名をクリーンアップする

  1. | 文字を含む商品エントリのカテゴリ部分を選択し、削除します。

5171d598a8cb3a75.png

Gemini は、このパターンをインテリジェントに認識し、列全体に適用する変換を提案します。

  1. [編集] を選択します。

b36cac918b4f30e9.png

Gemini の最適化案は的確です。「|」文字の後の部分が削除され、商品名が効果的に分離されます。

しかし、今回は元のデータを上書きしたくありません。

  1. ターゲット列のプルダウンで、[新しい列を作成する] を選択します。
  2. 名前を ProductName に設定します。

bda19e0e5e536ccd.png

  1. 変更内容をプレビューして、問題がないことを確認します。
  2. 変換を適用します。

商品カテゴリを抽出する

自然言語を使用して、[商品] 列のパイプ（|）の後の単語を抽出するよう Gemini に指示します。この抽出された値は、Product という既存の列に上書きされます。

  1. Add Step をクリックして、新しい変換ステップを追加します。

77944047e698494c.png

  1. プルダウン メニューから [Transformation] を選択します。
  2. 自然言語プロンプト フィールドに「Product 列のパイプライン（|）の後の単語を抽出します。」と入力し、Enter キーを押します。SQL が生成されます。

82efc2447a3210bd.png

  1. ターゲット列は「商品」のままにします。
  2. [適用] をクリックします。

変換の結果は次のようになります。

d741c66d9e0e8e00.png

8. 結合してデータを拡充する

多くの場合、他の情報源からのデータでデータを拡充する必要があります。この例では、商品データをサードパーティのテーブルの拡張商品属性 stg_extended_product と結合します。この表には、ブランドやリリース日などの詳細情報が含まれます。

  1. Add Step をクリックします。
  2. 「Join」を選択する
  3. stg_extended_product テーブルに移動します。

dca14451c3fbc7f0.png

Gemini in BigQuery は、productid 結合キーを自動的に選択し、キー名が同じであるため、左側と右側を修飾しました。

注: 説明フィールドに「Join by productid」と表示されていることをご確認ください。結合キーが他にもある場合は、説明フィールドを「productid による結合」に上書きし、説明フィールドの生成ボタンを選択して、次の条件 L を使用して結合式を再生成します。

productid

= R。

productid。4d6dbfea28772f34.png

  1. 必要に応じて、[プレビュー] を選択して結果をプレビューします。
  2. Apply をクリックします。

拡張属性のクリーンアップ

結合は成功しましたが、拡張属性データのクリーニングが必要です。LaunchDate 列の日付形式が一貫しておらず、Brand 列に欠落値が含まれています。

まず、LaunchDate 列について説明します。

f9b570d7c2d3a98d.png

変換を作成する前に、Gemini の推奨事項を確認します。

  1. 列名 LaunchDate をクリックします。次の画像のような推奨事項が生成されます。

62b6e6027a46ba75.png

  1. 次の SQL を含む推奨事項が表示された場合は、推奨事項を適用し、次の手順をスキップします。
COALESCE(SAFE.PARSE_DATE('%Y-%m-%d',
LaunchDate),SAFE.PARSE_DATE('%Y/%m/%d', LaunchDate))
  1. 上記の SQL に一致する推奨事項が表示されない場合は、[Add Step] をクリックします。
  2. Transformation を選択します。
  3. [SQL] フィールドに次のクエリを入力します。
COALESCE(SAFE.PARSE_DATE('%Y-%m-%d',
LaunchDate),SAFE.PARSE_DATE('%Y/%m/%d', LaunchDate))
  1. Target Columns を LaunchDate に設定します。
  2. Apply をクリックします。

LaunchDate 列の日付形式が統一されました。

ccf34aa05754a834.png

9. 宛先テーブルの追加

これでデータセットがクリーンになり、データウェアハウスのディメンション テーブルに読み込む準備ができました。

  1. ADD STEP をクリックします。
  2. Destination を選択します。
  3. 必要なパラメータ（データセット: bq_data_preparation_demo テーブル: DimProduct）を入力します。
  4. Save をクリックします。

79fdc3666a3a21b9.png

これで、[データ] タブと [スキーマ] タブを使用できるようになりました。これに加えて、BigQuery Data Preparation には、パイプライン内の変換ステップの順序を視覚的に表示する「グラフ」ビューがあります。

95e64d8152228f7b.png

10. ボーナス A: メーカー列の処理とエラーテーブルの作成

また、Manufacturer 列に空の値が含まれていることも確認されています。これらのレコードについては、データ品質チェックを実装し、エラーテーブルに移動して詳細な審査を行う必要があります。

エラーテーブルを作成する

  1. stg_product data preparation タイトルの横にある More ボタンをクリックします。
  2. [Setting] で [Error Table] を選択します。
  3. [Enable error table] チェックボックスをオンにして、次の設定を行います。
  • データセット: [bq_data_preparation_demo] を選択します。
  • テーブル: err_dataprep と入力します。
  • [Define duration for keeping errors] で [30 days (default)] を選択します。
  1. Save をクリックします。

adb5722f05c1b205.png

メーカー列の検証を設定する

  1. [メーカー] 列を選択します。
  2. Gemini は関連する変換を特定している可能性があります。Manufacturer フィールドが空でない行のみを保持する推奨事項を見つけます。SQL は次のようになります。
Manufacturer IS NOT NULL

2. この最適化案の [編集] ボタンをクリックして確認します。

4749b551a03d8193.png

  1. [検証に失敗した行をエラーテーブルに送信する] オプションがオンになっていない場合はオンにします。
  2. Apply をクリックします。

適用した変換は、[適用されたステップ] ボタンをクリックすることでいつでも確認、変更、削除できます。

15df6caacbdd6a69.png

重複する ProductID_1 列をクリーンアップする

結合テーブルの ProductID を複製する ProductID_1 列を削除できます。

  1. [Schema] タブに移動します。
  2. [ProductID_1] 列の横にあるその他アイコンをクリックします。
  3. Drop をクリックします。

これで、データ準備ジョブを実行してパイプライン全体を検証する準備が整いました。結果に問題がなければ、ジョブを自動で実行するようにスケジュールできます。

  1. データ準備ビューから移動する前に、準備を保存します。stg_product data preparation のタイトルの横に Save ボタンが表示されます。ボタンをクリックして保存します。

11. 環境をクリーンアップする

  • stg_product data preparation を削除します。
  • bq data preparation demo データセットを削除する

12. 完了

以上で、この Codelab は完了です。

学習した内容

  • データ準備の設定
  • テーブルを開いてデータ準備を操作する
  • 数値と単位記述子データを含む列を分割する
  • 日付形式の標準化
  • データ準備の実行
bug_report 誤りを報告