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