前提
- Exploratory Desktop が起動していて、プロジェクトが開いています(プロジェクトを選ぶ)。expl status で確認できます。
- 作成や変更をするコマンド(このページの create-source、apply-step など)は、システム設定 > MCP / CLI の「作成、変更、削除を許可する」がオンのときだけ使えます。
- R の実行(run-r)、ai-wrangle、ステップの削除は、実行の前に確認が出ます。ターミナルでは Continue? [y/N] と聞かれます。スクリプトや AI エージェントからは
--yesを付けます。確認と時間のかかる操作を参照してください。
手順
1. ファイルを確認して取り込む
ローカルのテキストファイルは、先に先頭と形式を確認します。--head-bytes で読む量を、--encoding で utf-8、shift_jis、auto を指定できます。
取り込むときは、名前と、データフレーム全体を返す R スクリプトを渡します。@ファイル名 と書くと、スクリプトをファイルから読みます(引数と JSON を渡す)。
readr::read_csv("./sales_orders.csv") です。スクリプトでなくデータソースのプラグインから取り込むときは、--source に、type、connection_id、params を持つ JSON を渡します。データベースの場合は、expl dataframe get-source-params で、プラグインが受け取る項目を確認します。カタログの項目を取り込むときの type は、local_catalog(params.item_id)と server_catalog(params.url)です。
2. データフレームを見る
3. 加工のステップを追加する
先に、コマンドが受け取る設定を調べます。get-command が返す名前だけが有効です。--command は操作、--params は、その設定をすべて入れた JSON オブジェクトです。
--save-with-error を付けると、エラーのステップとして残します。既存のステップの前後に入れるときは、--insert-position ‘{"side":"after","stepName":"<ステップ名>"}’ を渡します。付けないと、最後に追加します。
expl dataframe preview-steps は、一時的なオブジェクトで変更を試し、保存せずに結果を表示します。引数は expl dataframe preview-steps --help で確認します。
4. 結果を確認する
expl dataframe ai-wrangle --prompt "..." を使います(--run を付けると、ステップとして追加します)。実行の前に確認が出ます。ステップダイアグラムなど、そのほかの読み取りのコマンドは、Desktop のコマンドにあります。
失敗したとき
コマンドの引数は、
expl <コマンド> --help または expl tools describe "<コマンド>" で確認します。
