前提
- Exploratory Desktop が起動していて、プロジェクトが開いています(プロジェクトを選ぶ)。expl status で確認できます。
- データフレームの id と列名が分かっています(expl dataframe list、expl dataframe get-schema <dataframe_id>)。
- chart add と chart edit は、システム設定 > MCP / CLI の「作成、変更、削除を許可する」がオンのときだけ使えます。確認は出ません。チャートの削除は、確認が出ます。確認と時間のかかる操作を参照してください。
手順
1. チャートの種類の設定を調べる
--marker は、チャートの種類です。bar、line、area、pie、scatter、pivot、singlevalue、table などです。--section を付けないと、設定の目次が返ります。
--setting <名前> で、設定を 1 つ、名前の完全一致で引けます。--search <名前の一部> で、名前の一部から絞り込めます。設定の名前は推測せず、ここで返った名前だけを使います。
2. チャートを作る
--marker と --axes が必須です。--axes は、枠の名前をキーにして、列を置く JSON オブジェクトです。bar と line の枠は x、y、color、facet、ピボットテーブルの枠は rowh、colh、meas です。値は、列名か、集計を選ぶ {"column": "...", "func": "sum"} です。
--settings には、手順 1 で調べた名前の JSON オブジェクトを渡します(オンとオフの設定は、true や false でなく、文字列の “on” か “off” です)。--filters には、フィルタ条件の配列を渡します。条件の形は、expl chart add --help で確認します。
結果に、作ったチャートの id(chartId)が入ります。--data-frame-id を付けないと、Desktop で選択中のデータフレームを使います。選択中のものがないときは、NO_DATA_FRAME で止まります。
3. 数値と画像を確認する
4. 変更する
変えるものだけを渡します。渡さなかったものは、そのまま残ります。id は変わりません。--axes、--settings、--filters は、chart add と同じ書き方です。Auto Run がオフのチャートは、--run を付けると実行します。
失敗したとき
コマンドの引数は、
expl <コマンド> --help または expl tools describe "<コマンド>" で確認します。
