Lakeview ダッシュボード パラメーターを使用する

Lakeviewダッシュボードは、ダッシュボードをインタラクティブにする 1 つの方法であり、閲覧者が単一値セレクターと日付ピッカーを使用して、ランタイム時にデータセット クエリに特定の値を入力できるようにします。 たとえば、 SQLクエリで集計される前に日付や製品カテゴリなどの条件に基づいてデータをフィルタリングできるため、より効率的なクエリと正確な分析が可能になります。

パラメーターは、ダッシュボード作成者または編集者によってデータセットに追加され、Lakeview ダッシュボードのキャンバス上の 1 つ以上のウィジェットに接続されます。 ダッシュボード ビューアは、ランタイム時にフィルター ウィジェットの値を選択することで、ダッシュボード データを操作します。 これにより、関連するクエリが再実行され、フィルター処理されたデータに基づいて構築された視覚化が表示されます。

パラメーターはクエリを直接変更するため、強力な効果が得られます。 データセット フィルターは、ダッシュボードの対話性、より多くの機能、大規模なデータセットでのパフォーマンスも問題よりも優れています。 「 フィルター」を参照してください

問題を追加する

Lakeview ダッシュボード データセットにパラメーターを追加するには、少なくともドラフト ダッシュボードで編集可能権限が必要です。 「データ」タブのデータセット クエリに直接「問題」を追加できます。

GIF は次のステップの例を示しています。

クエリに問題を追加するには:

  1. クエリ内で問題を配置する場所にカーソルを置きます。

  2. 新しい問題を挿入するには、[追加]をクリックします。

    これにより、安全な名前parameterを持つ新しい問題が作成されます。 デフォルトの名前を変更するには、クエリ エディターで名前を置き換えます。 クエリ エディターにこの構文を入力してパラメーターを追加することもできます。

問題を編集する

問題を編集するには:

  1. クリック歯車アイコン問題名の横にあります。 「問題の詳細」ダイアログが表示されます。

    このダイアログには、次の構成オプションが含まれています。

    • キーワード: クエリ内の問題を表すキーワード。 これは、クエリ内のテキストを直接更新することによってのみ変更できます。

    • 表示名: フィルター エディターでの名前。 デフォルトでは、タイトルはキーワードと同じです。

    • タイプ: サポートされているタイプには、文字列日付日付と時刻数値が含まれます。

      • 安心タイプは文字列です。

      • 数値データ型では、DecimalInteger のどちらかを指定できます。デフォルトの数値タイプはDecimalです。

  2. UI の別の部分をクリックして、ダイアログを閉じます。

問題を削除する

問題を削除するには、クエリから削除します。

ダッシュボード キャンバスで問題を使用する

ダッシュボードに問題を追加するには:

  1. クリックフィルター アイコンフィルター (フィールド/問題) を追加します

  2. クリック[フィールドの追加] アイコン構成パネルの「問題」の隣にあります。

  3. 視聴者がこのウィジェットで使用したい名前をクリックします。

URL に「問題」を含める

問題設定は URL に保存されるため、ユーザーはそれをブックマークして、事前設定されたフィルターや問題を含むダッシュボードの状態を維持したり、同じフィルターや問題を一貫して適用するために他のユーザーと共有したりできます。

問題の構文例

使用量

使用例

Lakeview ダッシュボード パラメーターの構文

日付を挿入する

特定の日付より前のレコードのみを含める

WHERE date_field < :date_param

数値を挿入する

特定の価格を下回る価格のみを含める

WHERE price < :max_price

テーブル名を挿入する

クエリで使用されるテーブルを変更する

SELECT * FROM IDENTIFIER(:param)

他のデータベース・オブジェクトの挿入

クエリで使用されるカタログ、スキーマ、およびテーブルを変更する

SELECT * FROM IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

複数の論点を連結する

2 つの問題を括弧で結合して、書式設定された電話番号を作成します

format_string('(%d) %d', :area_code, :phone_number) (1)

(1) format_string 関数を使用して値を挿入します。 format_string 関数 (function function) を参照。

重要

ダッシュボードの閲覧者がテーブル名やカタログ名などの選択を介してデータにアクセスできるようにすると、機密情報が誤って漏洩する可能性があります。 これらのオプションを使用してダッシュボードを公開する場合、Databricks では、公開されたダッシュボードに資格情報を埋め込まないことをお勧めします。

Lakeview ダッシュボード パラメーターと Databricks SQL クエリ パラメーター

Lakeviewダッシュボードでは、名前付きマーカーと同じ構文を使用します。 「名前付きマーカー」を参照してください。 Lakeview ダッシュボードは、Databricks SQL スタイルのパラメーターをサポートしていません。