LogoLogo
codatum.jpお問い合わせログイン無料ではじめる
  • はじめに
  • 使い始めるには
    • クイックスタート
    • 詳しい設計思想
      • なぜセルベースエディタではなくブロックエディタを選んだのか?
  • データ接続と管理
    • コネクション
      • テーブルメタデータの同期
    • 対応データウェアハウス
      • BigQuery
      • Snowflake
      • Redshift
      • その他のデータウェアハウス
    • カタログ
    • クイック検索
  • データ探索
    • データ探索の概要
    • ノートブック
      • ドキュメントページ
      • グリッドページ
      • SQLブロック
      • バージョン
      • ノートブックに関するFAQ
    • チャート
    • エクスプローラ
    • パラメータ
      • パラメータの種類
      • エスケープと動的参照
      • 動的な選択肢の生成
    • (補足) キャッシュ
  • AIアシスタント
    • AIアナリスト
  • 共有
    • 共有方法
    • チームスペース
    • ノートブック単位の共有
    • レポート
    • パブリックリンク
    • 署名付き埋め込み
      • 署名付き埋め込みの設定方法
  • アカウント管理
    • アカウント
    • アカウント設定
  • ワークスペースとユーザー管理
    • ワークスペース
    • ユーザー管理
      • 招待
      • グループ
  • セキュリティ
    • セキュリティの概要
    • 監査ログ
    • IPアクセス制御 (プレビュー)
  • アクセス制御
    • アクセス制御の概要
    • ワークスペースのアクセス制御
    • リソースのアクセス制御
      • グループのアクセス制御
      • チームスペースのアクセス制御
      • ノートブックのアクセス制御
      • コネクションのアクセス制御
      • レポートのアクセス制御
  • [準備中] プランと請求
    • 制限と使用量
    • ダウングレードとキャンセル
  • ベストプラクティス
    • SQLの高度な制御構造
  • その他の考慮事項
    • システム要件
  • 外部連携
    • KARTE Datahubとの連携方法
GitBook提供

Reference

  • Privacy policy
  • Terms of service
  • EN Docs Site
このページ内
  • 1. 固定リスト
  • 2. テーブル
  • 3. クエリ実行結果
  • SQLの実行タイミング
  • キャッシュの動作

役に立ちましたか?

PDFとしてエクスポート
  1. データ探索
  2. パラメータ

動的な選択肢の生成

テキスト選択やテキスト複数選択では、3種類の選択肢の生成方法をサポートしています。

1. 固定リスト

固定の値から選択したい場合に使用します。

  • 設定:

    • CSV Text:

      • CSV形式のテキストで選択肢を定義します。各項目は改行で区切ります。表示名を指定する場合は、同じ行にカンマ(,)で区切って記述します。

例:

value1,表示名1
value2,表示名2

2. テーブル

特定のテーブルのカラムから選択可能な値を生成したい場合に使用します。

  • 設定:

    • テーブル: 値を取得するテーブルを選択します。

    • 選択肢にするカラム: 選択肢の値として使用するカラムを指定します。

    • 表示名にするカラム: 表示ラベルとして使用するカラムを指定します。

3. クエリ実行結果

指定したSQLの実行結果に基づいて選択肢を生成したい場合に使用します。

  • 設定:

    • コネクション:

      • クエリに使用するデータベース接続を選択します。

    • SQL:

      • 選択肢の値を返すSQLを入力します。クエリが複数のカラムを返す場合、最初のカラムが選択肢の値として、2番目のカラム(存在する場合)が表示ラベルとして使用されます。

選択肢用のSQLは頻繁に実行されるため、パフォーマンスを最適化するために、遅いクエリやリソースを多く消費するクエリの使用は避けてください。

SQLの実行タイミング

パラメータの選択肢にSQLを使用する場合、以下のタイミングでクエリが実行されます:

  1. ノートブックページが読み込まれたとき:

    • そのページで使用されているパラメータのSQLはページの初期化時に実行されます

    • 現在のページで使用されていないパラメータは初期化されず、そのSQLも実行されません

  2. パラメータのドロップダウンが開かれたとき:

    • ドロップダウンメニューが最初に開かれたときにSQLクエリが実行されます

  3. 検索フィールドに入力するとき:

    • 初回のクエリ実行後は、すでに取得したデータを使用してクライアント側でフィルタリングが行われます

    • キーストロークごとにSQLが再実行されることはありません

キャッシュの動作

パラメータ用のSQLは、通常のSQLブロックと同じキャッシュメカニズムを使用します:

  • 結果はバックエンドで最大24時間キャッシュされます

  • 同一のクエリ(パラメータ値を含む)はキャッシュされた結果を使用します

  • フロントエンドも現在のセッション中はメモリキャッシュを維持します

これにより、パラメータ選択のドロップダウンが頻繁に開かれたとしても、実際のクエリはキャッシュ期間内に1回だけ実行され、パフォーマンスが大幅に向上します。

前へエスケープと動的参照次へ(補足) キャッシュ

最終更新 6 日前

役に立ちましたか?