パラメータを使用すると、クエリの実行時間ごとにフィルターや計算の値を設定することができます。クエリ間の一貫性を有効にするには、ワークスペース所有者は構成 から共通値のパラメータを設定できます。例えば、Current Fiscal Year、 Entity 、Region のパラメータを複数のクエリで共有することができます。
これらの共有されたパラメータにより：
- 共同作業者は、クエリに固有のカスタムパラメータを追加することに加えて、設定値を持つ共通パラメータを使用することができます 。
- 管理者は、すべてのインスタンスでパラメータを特定の値にロックすることができます（例えば、Current Fiscal Yearを設定することで、一貫した分析を保証します）。
パラメータの構成
クエリ間で一貫性を持たせるには、パラメータを共通の値に構成する。
ステップ1：パラメータを作成する
-
構成 から、パラメータ タブを選択し、作成 をクリックする。
-
パラメータの名称を入力し、Createをクリック
注： パラメータ名には英数文字とアンダースコアを含むことができますが、間隔やその他の特殊文字は使用できません。
ステップ2.パラメータの詳細設定
-
詳細 パネルから、パラメータの値のデータタイプ（テキストや整数など）を選択する。
-
クエリ実行時に選択するオプションの設定リストを提供するには、Pick List を有効にし、各オプションをそれぞれの行に入力する。
注： 日付またはタイムスタンプ・フィルタの場合、各オプションを
YYYY-MM-dd形式で入力する。 - パラメータのデフォルト値を入力または選択する。
- 共同作業者がデフォルト以外の値を使用できないようにするには、Locked を選択します。
- [適用]をクリックします。
パラメータの詳細編集
ピックリストの調整や値のロックなど、パラメータの詳細を編集する：
- 構成 から、パラメータ タブでパラメータを選択する。
- 詳細 パネルから、必要に応じてパラメータの名称、データタイプ、値を編集する。
- 共同作業者がデフォルト以外の値を使用できないようにするには、Locked を選択します。
- [適用]をクリックします。
パラメータの詳細を編集すると、そのクエリが次へ実行または更新されたときに変更が適用されます。
警告
アクティブなパラメータ（SQL 名の変更、新規データ型の選択、フィールド型の "複数選択" オプションへの切り替えなど）を大幅に更新すると、既存のクエリが破壊され、接続に失敗します。
このため、変更を行う前に、従属クエリからグローバルパラメータを削除することをお勧めします。そうでなければ、変更されたパラメータを説明すべく、SQLモード、各クエリを個別に編集する必要があります。
パラメータの削除
構成 からパラメータを削除するには、パラメータ タブで選択し、削除 をクリックする。