ファイルとして保存する
dataframe export は、dataset query と同じ指定で絞り込みや集計を行い、結果をファイルにします。結果が大きく、dataset query では取得しきれない場合に使用します。--format で指定します。既定は csv で、UTF-8(BOM 付き)のため、Excel で正しく開けます。ファイルの保存先は --output で指定します。
上の例は、サーバー上にファイルを作り、ダウンロードリンクを返します。手元のコンピューターには何も保存されません。手元に保存するときは、--output を付けます。
result に rows と expires_at が表示されていれば、サーバー上にファイルができています。saved と bytes も表示されていれば、手元にも保存できています。
ダウンロードが許可されていない場合
公開した人がファイルとしてのダウンロードを許可していないデータでは、dataframe export は DATA_EGRESS_LIMIT で失敗します。error_code が DATA_EGRESS_LIMIT であれば、このデータはファイルとして保存できません。
トラブルシューティング
すべてのフラグはdataframe export、絞り込みと集計の指定方法はdataset queryで説明しています。
