📄

【スプシ】コネクテッドシートでセルの値をクエリに渡して動的に絞り込む

2025/08/23に公開

 これなにコネクテッドシートは、GoogleスプレッドシートからBigQueryに対してクエリを実行し、データを出力できる機能です。
今回はスプレッドシート上のセルの値をクエリに渡し、動的にデータを絞り込む方法について紹介してみようと思います。

 具体例1BigQueryに以下のようなusersテーブルがあるとします。
スプシ上のB1セルにユーザーIDが入力されているので、その値をクエリに渡して対象ユーザーの情報をスプシに出力してみましょう。
データ>データコネクタ>BigQueryに接続を選択し、GoogleCloudプロジェクトを選択した上で、保存したクエリとクエリエディタを選択します。
クエリエディタが表示されたら、パラメータから追加を選択し、USER_IDという名前でユーザーIDが入力されているB1セルを選択してパラメータを追加してみましょう。
するとクエリエディタ上に@USER_IDが出力されます。
以下のように@USER_IDを含めた上でクエリを実行すると、@USER_IDにB1セルの値が代入され実行される仕組みになっています。
SELECT
  *
FROM
  sample.users
WHERE
  id = @USER_ID

 複数セルを条件に含める方法コネクテッドシートのパラメータは特定の1セルしか参照できないため、TEXTJOIN()関数を使って1つの文字列にした上で、パラメータとして渡していきます。

 具体例2以下のように、A2〜A4セルにメールアドレスが入力されているとします。
パラメータで参照できるようにするために、B1セルに=TEXTJOIN(",", TRUE, A2:A4)を入力し、カンマ区切りで1つの文字列にしてみましょう。
あとは先程と同じように、コネクテッドシートでパラメータを追加してクエリするだけです。
この時、複数のメールアドレスが1つの文字列になっているため、SPLIT()で個々のメールアドレスに分解し、それを配列に入れた上で再度UNNEST()するのがポイントです。
SELECT
  *
FROM
  sample.users
WHERE
  email IN UNNEST(
    ARRAY(
      SELECT 
        TRIM(email, "'")
      FROM 
        UNNEST(SPLIT(@EMAIL, ',')) email
    )
  )
ORDER BY 
  id
ちなみに、BigQuery上で実行されたクエリのログを確認すると、以下のように@EMAILのままログが残されるため、個人情報がログに残る心配もありません。

GitHubで編集を提案

これなに

具体例1

複数セルを条件に含める方法

具体例2

Discussion