👌

Redashでのクエリとダッシュボード作成時のハマりポイント

に公開
2026/01/06

本記事は2024年12月09日に執筆したものです。所属会社のTech Blogプラットフォーム移行に伴い、当該記事を他プラットフォームから移行しました。


はじめに

Gakken LEAPのmizunoです。
当プロジェクトではBIツールとしてRedashを採用しており、データの可視化を行っています。
今回は、クエリやダッシュボードの作成時に直面した課題やその解決方法を共有したいと思います。

はまってしまった話

文字列検索のシングルクォーテーション問題

Redashでは、{{}}で囲んだ部分をパラメータとして利用できます。
ただし、文字列検索においては、クエリ中のパラメータをシングルクォーテーションで囲む必要があります。これを忘れると検索が正常に動作しません。

  • シングルクォーテーションを囲んでいない場合(検索が失敗)
    img1.png

  • シングルクォーテーションで囲んだ場合(検索が成功)
    img2.png

Redashでは、パラメータとして渡された値にシングルクォーテーションを自動補完してくれない仕様です。そのため、文字列検索の場合は、'{{hoge}}'のようにクエリ内で手動で囲む必要があります。

ダッシュボードでの検索パラメータが統一される問題

クエリを作成後、ダッシュボードでウィジェットとして追加して使用することができます。しかし、この際、検索パラメータがすべてのウィジェットで共通化されてしまい、個別の検索ができないという問題が発生しました。

解決方法

ウィジェットを追加する際、Parameters欄でValue Sourceの設定を変更できます。

  • 共通のパラメータを使用する設定(変更せずにそのまま追加)
    img4.png

  • 個別のパラメータを使用する設定(Widget parameter を選択)
    img5.png

この設定により、各ウィジェットごとに異なる検索パラメータを使用できるようになります。

グラフ表示やテーブル表示を複数組み合わせて利用する場合、この方法で検索パラメータの競合を防ぐことができました。

まとめ

Redashを使用してクエリやダッシュボードを作成する際、以下の2つのポイントに注意が必要です。

  1. 文字列検索のシングルクォーテーション

    • クエリ内でパラメータを利用する際、文字列検索の場合はシングルクォーテーションでパラメータを囲む必要があります。
    • シングルクォーテーションがないと検索が正しく動作しません。
  2. ダッシュボードでの検索パラメータの統一問題

    • ダッシュボードにウィジェットを追加する際、ParametersのValue SourceをWidget parameterに設定することで、各ウィジェットで個別の検索が可能になります。

エンジニア募集

Gakken LEAPでは、教育のアップデートに取り組むエンジニアを絶賛募集中です!
ぜひお気軽にカジュアル面談にお越しください!

https://gakken-leap.co.jp/recruit/

Gakken LEAP Developers

Discussion