パラメーターの設定ダイアログを開く方法

パラメーターの設定ダイアログは、以下の場所からアクセスできます。

• プロジェクトメニュー
• フィルタ
• SQL
• パラメーターペイン

プロジェクトメニュー

フィルタのダイアログ

SQL エディタ

パラメーターペイン

パラメーターアイコンをクリックします。

するとパラメーターペインが表示されるので、「パラメータを作成」ボタンをクリックします。

データ型の選択

パラメーターの作成は非常に簡単ですが、作成するパラメーターのデータ型によって 、異なる設定オプションがあります。そのため、パラメーターを作成するときに最も重要なことは、正しいデータ型を選択することです。

もし「Character（文字）」型の列で利用するためのパラメーターを作成するのであれば、データ型に「Character（文字）」型を選択します。

「Character（文字）」型の「マーケット」列があったとして、「マーケット」の列と一緒に使用するパラメータを作成する場合を例に考えてみます。

そのようにときには、値のタイプに「Character（文字）」型を選択します。

入力タイプの選択

入力タイプにはいくつかのオプションがあります。

Character（文字）型のパラメーターの場合、重要なポイントは、「値のリスト （単一選択）」あるいは「値のリスト （複数選択）」 のどちらかを選択することです。

フィルタ用のパラメーターを作成している場合、値のリスト （単一選択）」あるいは「値のリスト （複数選択）」 のどちらを選択するかは、使用するフィルタの演算子によって決まります。

上記の例では、フィルタの演算子は「どれかに等しい（複数選択）」のため、入力タイプに「値のリスト （複数選択）」 を選択します。

また、パラメーターでは表示スタイルも選択できます。

「ドロップダウン」を使用した場合、パラメーターは以下のように表示され、パラメーターの値の一覧はパラメーターをクリックしたときにのみ表示されます。

一方で、「リスト」を使用した場合、パラメーターは以下のように表示され、パラメーターの値の一覧はパラメーターペインの一部として埋め込まれます。

値のリスト

入力タイプに「値のリスト」を選択した場合、「値を手動で入力」オプションにチェックを付けて、選択可能な値を手動で入力して設定することが可能です。

ただし、特に多くの値がある場合、値を手動で入力するのは少し面倒です。また、データが変更された場合には値のリストに値を手動で追加/削除する必要があるため、メンテナンスが煩雑になる可能性があります。

こういったときに使えるのが、「データフレームから値を取得」オプションです。このオプションを使うと、データフレーム （多くの場合、パラメータを適用するデータフレームである可能性が高い） を選択し、パラメーターの値に使用できる値を含む列を選択して値のリストを生成できます。

なお、データフレームには複数のデータラングリングのステップを含めることができます。

そのため、「データフレームから値を取得」オプションを使うときには、値のリストを取得する特定のステップを選択する必要があります。

多くの場合、値のリストを取得するステップはデータフレームの「最後のステップ 」となるため、そちらがデフォルトとして設定されています。

一方で、途中のステップで列を削除したり、値をフィルタすること、値のリストを生成するために必要な列とデータが、最後のステップで存在しない場合もあります。このようなときは、必要に応じて適切なステップを選択する必要があります。

他のタイプのパラメータ

データ型に応じて、他にも、以下の種類のパラメータもあります。

• 数値型
• 日付または日付時間型
• ロジカル型

フィルタ

フィルタを作成するときには、「値」のオプションを使用する代わりに、「パラメーター」のオプションにチェックをつけ、作成したパラメーターを選択して、値を設定できます。

これにより、パラメーターペインから選択したパラメーターの値に基づきフィルタの条件が動的に生成されます。

計算

「計算を作成」の中では「@{パラメーター名}」と記述することで、使用するパラメータを指定できます。

なお、計算エディタに@をタイプするだけで、利用可能なすべてのパラメータが表示され、必要なパラメータを選択するだけで、利用するパラメーターを指定できます。

SQL

SQLのエディタの中では「@{パラメーター名}」と記述することで、使用するパラメータを指定できます。

@をタイプするだけで、利用可能なすべてのパラメータが表示され、必要なパラメータを選択するだけで、利用するパラメーターを指定できます。

ダッシュボード/ノート

これは、複数のグラフを追加できるダッシュボードとノートでも同様です。

Exploratory は、特定のダッシュボードまたはノート内のチャートの基礎となるデータ生成にどのパラメーターが使用されているかを検出し、パラメーターペインを開いたときに関連するパラメーターを自動的に表示します。

パラメーターの設定

サーバーにパブリッシュしたダッシュボードやノートの設定メニューからは、サーバー上のパラメーターの設定の変更が可能です。

招待されたユーザーも使える

デフォルトの設定では「招待されたユーザーも使える」は無効になっています。「招待されたユーザーも使える」にチェックを付けて有効にすると、サーバーにコンテンツをパブリッシュした人だけでなく、それぞれのコンテンツの閲覧権限を持っているユーザーであれば、誰でもパラメーターの利用が可能となります。

データの再インポートを有効にする

デフォルトの設定では「データの再インポートを有効にする」は有効になっています。

「データの再インポートを有効にする」にチェックがついていると、パラメーターペイン内の実行ボタンに「データ再インポート」のオプションが表示されるようになり、パラメーターの実行時にデータを再インポートすることが可能です。

ページの上に重ねて表示

デフォルトの設定では「ページの上に重ねて表示」は無効になっています。有効にすると、サーバーにパブリッシュされているノートやダッシュボードに重なる形でパラメーターが表示されるようになります。

なお、「ページの上に重ねて表示」のオプションを有効にすると、パラメーターボタンをクリックしないと、パラメーターペインは表示されなくなります。

さらに、「ページの上に重ねて表示」のオプションを有効にすると、パラメーターの位置も「右」から「左」に変更することが可能です。

パラメーターの位置を「左」に変更すると、パラメーターボタンをクリックしたときに、パラメーターの表示位置が左側に変わります。

パラメーターを使用したデータやダッシュボードをサーバーにパブリッシュしてインタラクティブモードを使用した時に、どの時点のデータを使用していますか？

パラメーターをどのように使用しているかによって、データフレームのどの時点のデータを使用しているかが変わります。

SQLのクエリにパラメーターを使用している場合

SQLのクエリに対してパラメーターを使用していたとします。（SQLクエリにパラメーターを使用する方法はこちらをご覧ください）

その場合は、データの取得段階からパラメーターが適用されているため、変更したパラメーターの内容に合わせてデータを取り直すことができます。

データラングリングのステップにパラメーターを使用している場合

データラングリングのステップとして、例えばフィルタなどでパラメーターを使用していたとします。

その場合は、そのパラメーターが使われるステップの時点（厳密にはその前のステップの結果）のデータをキャッシュしており、そこからパラメーターでデータを動的に変更できるようになっています。

チャートフィルタでパラメーターを使用している場合

チャートフィルタとして、パラメーターを使用していたとします。

その場合は、チャートピンを紐づけているステップの時点のデータをキャッシュしており、そこからパラメーターでデータを動的に変更できるようになっています。