Exploratoryのパラメーターの紹介
Exploratory でパラメーターを使用すると、ダッシュボード、ノート、チャート、データをよりインタラクティブに使えます。またこれらのコンテンツを Exploratoryサーバーにパブリッシュすると、あなたのチームのメンバーはパラメーターを使用して、コンテンツを操作できるようになります。
Exploratoryのパラメーターは非常にユニークです。パラメーターは様々なタイプを作成できるだけでなく、データソースのステップの SQLのクエリ、計算、そしてもちろんフィルターなど、様々な場所でも利用できます。
パラメーターの値を変更すると、関連するデータパイプラインを更新し、更新されたデータで、ダッシュボード、ノート、チャート、などのアウトプットが再生成されます。
ダッシュボード
チャート
データ
パラメーターの作り方と更新方法
パラメーターは、パラメーターの設定ダイアログから作成・更新します。
パラメーターの設定ダイアログを開く方法
パラメーターの設定ダイアログは、以下の場所からアクセスできます。
- プロジェクトメニュー
- フィルタ
- SQL
- パラメーターペイン
プロジェクトメニュー
フィルタのダイアログ
SQL エディタ
パラメーターペイン
パラメーターアイコンをクリックします。
するとパラメーターペインが表示されるので、「パラメータを作成」ボタンをクリックします。
データ型の選択
パラメーターの作成は非常に簡単ですが、作成するパラメーターのデータ型によって 、異なる設定オプションがあります。そのため、パラメーターを作成するときに最も重要なことは、正しいデータ型を選択することです。
もし「Character（文字）」型の列で利用するためのパラメーターを作成するのであれば、データ型に「Character（文字）」型を選択します。
「Character（文字）」型の「マーケット」列があったとして、「マーケット」の列と一緒に使用するパラメータを作成する場合を例に考えてみます。
そのようにときには、値のタイプに「Character（文字）」型を選択します。
入力タイプの選択
入力タイプにはいくつかのオプションがあります。
Character（文字）型のパラメーターの場合、重要なポイントは、「値のリスト （単一選択）」あるいは「値のリスト （複数選択）」 のどちらかを選択することです。
フィルタ用のパラメーターを作成している場合、値のリスト （単一選択）」あるいは「値のリスト （複数選択）」 のどちらを選択するかは、使用するフィルタの演算子によって決まります。
上記の例では、フィルタの演算子は「どれかに等しい（複数選択）」のため、入力タイプに「値のリスト （複数選択）」 を選択します。
また、パラメーターでは表示スタイルも選択できます。
「ドロップダウン」を使用した場合、パラメーターは以下のように表示されます。
パラメーターの値の一覧はパラメーターをクリックしたときにのみ表示されます。
また「リスト」を使用した場合、パラメーターは以下のように表示されます。
パラメーターの値の一覧はパラメーターペインの一部として埋め込まれます。
値のリスト
入力タイプに「値のリスト」を選択した場合、「値を手動で入力」オプションにチェックを付けて、選択可能な値を手動で入力して設定することが可能です。
ただし、特に多くの値がある場合、値を手動で入力するのは少し面倒です。また、データが変更された場合には値のリストに値を手動で追加/削除する必要があるため、メンテナンスが煩雑になる可能性があります。
こういったときに使えるのが、「データフレームから値を取得」オプションです。このオプションを使うと、データフレーム （多くの場合、パラメータを適用するデータフレームである可能性が高い） を選択し、パラメーターの値に使用できる値を含む列を選択して値のリストを生成できます。
なお、データフレームには複数のデータラングリングのステップを含めることができます。
そのため、「データフレームから値を取得」オプションを使うときには、値のリストを取得する特定のステップを選択する必要があります。
多くの場合、値のリストを取得するステップはデータフレームの「最後のステップ 」となるため、そちらがデフォルトとして設定されています。
一方で、途中のステップで列を削除したり、値をフィルタすること、値のリストを生成するために必要な列とデータが、最後のステップで存在しない場合もあります。このようなときは、必要に応じて適切なステップを選択する必要があります。
他のタイプのパラメータ
データ型に応じて、他の種類のパラメータもあります。
詳細については、以下のメモをご覧ください。
- 数値型データのパラメーターを作成する方法
- 日付または日付時間型データのパラメーターを作成する方法
- ロジカル型データのパラメータを作成する方法
何をどのようにパラメータ化できますか?
パラメーターを作成したら、作成したパラメーターを使ってExploratoryの中で様々なものにパラメーターを適用できますが、最も一般的なものは以下の通りです。
- フィルタ
- 計算
- SQL
フィルタ
フィルタを作成するときには、「値」のオプションを使用する代わりに、「パラメーター」のオプションにチェックをつけ、作成したパラメーターを選択して、値を設定できます。
これにより、パラメーターペインから選択したパラメーターの値に基づきフィルタの条件が動的に生成されます。
計算
「計算を作成」の中では「@{パラメーター名}」と記述することで、使用するパラメータを指定できます。
なお、計算エディタに@をタイプするだけで、利用可能なすべてのパラメータが表示され、必要なパラメータを選択するだけで、利用するパラメーターを指定できます。
SQL
SQLのエディタの中では「@{パラメーター名}」と記述することで、使用するパラメータを指定できます。
Just typing @ will list all the available parameters and you can simply select the one you need.
@をタイプするだけで、利用可能なすべてのパラメータが表示され、必要なパラメータを選択するだけで、利用するパラメーターを指定できます。
パラメータの使い方
適切な場所でパラメータを設定したら、あとは「パラメーター」ボタンをクリックするだけで、パラメーターは利用できます。
ここからはSalesforce のデータから作成した以下のチャートを例にパラメーターの使い方を紹介します。
今回のSalesforceのデータのデータソースのダイアログを開くと、フィルタに「Close_Date（商談完了予定日）」のパラメーターが設定されています。
また、データソースステップの、このパラメーター以外に、データラングリングのステップで利用されているパラメーターはありません。
その状態で「パラメーター」ボタンをクリックすると、
パラメーターペインにはパラメーター 商談完了予定日（Close Dateの日本語の表示名）が 1 つだけ表示されます。
ここで、同じデータ フレームの別のチャートを見てみましょう。
このチャートでは、データ ラングリングのパイプラインの6番目のステップであるフィルターからデータを取得しています。
このフィルター ステップには 3つのトークン（ボックス）があり、それらはすべてパラメーターを使用しています。
これは、パラメーターボタンをクリックして、パラメーター ペインを開くと、データソースのステップで使用されるパラメーターを含む、データラングリングのステップで使用されるすべてのパラメーターが表示されることを意味します。
このように、特定のチャートにパラメータを追加する必要はありません。
Exploratory は、データラングリングのステップで使用される全てのパラメーターを検出して、データを生成し、パラメーターペインに必要なパラメーターを自動的に表示します。
ダッシュボード/ノート
これは、複数のグラフを追加できるダッシュボードとノートでも同様です。
Exploratory は、特定のダッシュボードまたはノート内のチャートの基礎となるデータ生成にどのパラメーターが使用されているかを検出し、パラメーターペインを開いたときに関連するパラメーターを自動的に表示します。
パラメータペイン内の設定
パラメータペインにどのパラメータを表示するかは、Exploratoryが自動的に決めますが、「レイアウト」ボタンをクリックしてパラメータの順序を設定できます。
パラメーターの表示順序をドラッグアンドドロップで変更できます。
なお、固定値を設定したいパラメーターがあり、それを他の人に見せたくない場合は、パラメーターの「Hide（非表示）」ボタンをクリックして非表示にすることができます。
Exploratoryサーバーでパラメータを使用する
パラメータを使用するダッシュボード、ノート、チャート、またはデータをパブリッシュすると、パラメータも一緒にパブリッシュされます。
これは、パブリッシュされたインサイトのページを開いたときに、Web ブラウザー内に同じパラメーターが表示されることを意味しています。
「インタラクティブ・モード」を「On」にすることで、パラメーターが有効になります。