メインコンテンツへスキップ
データをデータフレームとしてプロジェクトに取り込み、列を確認し、加工のステップを追加します。

前提

  • 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 を渡す)。
import.R は、最後の値が data.frame になるスクリプトです。たとえば 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. データフレームを見る

list は、各データフレームの id を返します。get-schema は、列名と型、加工のステップ、行数を返します。preview は、先頭の行を、最大 100 行返します。列名は、get-schema の表記のまま写します。

3. 加工のステップを追加する

先に、コマンドが受け取る設定を調べます。get-command が返す名前だけが有効です。
そのあと、ステップを 1 つ追加します。--command は操作、--params は、その設定をすべて入れた JSON オブジェクトです。
<command> は、get-command で調べたコマンド名に置き換え、params.json には、返ってきた名前で設定を書きます。ステップは、1 回に 1 つの操作ずつ追加します。R で実行できなかったステップは取り消されます。--save-with-error を付けると、エラーのステップとして残します。既存のステップの前後に入れるときは、--insert-position ‘{"side":"after","stepName":"<ステップ名>"}’ を渡します。付けないと、最後に追加します。 expl dataframe preview-steps は、一時的なオブジェクトで変更を試し、保存せずに結果を表示します。引数は expl dataframe preview-steps --help で確認します。

4. 結果を確認する

追加したステップが steps に出て、列と行数が更新されています。 依頼の内容から AI に R を書かせたいときは、expl dataframe ai-wrangle --prompt "..." を使います(--run を付けると、ステップとして追加します)。実行の前に確認が出ます。ステップダイアグラムなど、そのほかの読み取りのコマンドは、Desktop のコマンドにあります。

失敗したとき

コマンドの引数は、expl <コマンド> --help または expl tools describe "<コマンド>" で確認します。

関連するページ

同じことを MCP で行う例は、使い方の「データを取り込む・加工する」を参照してください。