メインコンテンツへスキップ
データの絞り込みや集計の結果を、CSV または Parquet のファイルとして保存し、ダウンロードリンクを取得します。

ファイルとして保存する

dataframe export は、dataset query と同じ指定で絞り込みや集計を行い、結果をファイルにします。結果が大きく、dataset query では取得しきれない場合に使用します。
<dataset_id> は、データの id に置き換えます。実行結果は、データ Sales Orders(id は hI6jK7lM8n)で実行したものです。download_url(ダウンロードリンク)の行は省略しているので、次の JSON は抜粋で、完全な JSON ではありません。 実行結果
ダウンロードリンクは 15 分間有効で、サインインしている同じユーザーだけが使用できます。形式は --format で指定します。既定は csv で、UTF-8(BOM 付き)のため、Excel で正しく開けます。ファイルの保存先は --output で指定します。 上の例は、サーバー上にファイルを作り、ダウンロードリンクを返します。手元のコンピューターには何も保存されません。手元に保存するときは、--output を付けます。
保存できたときは、結果に saved(保存先のパス)と bytes が表示されます。
result に rows と expires_at が表示されていれば、サーバー上にファイルができています。saved と bytes も表示されていれば、手元にも保存できています。

ダウンロードが許可されていない場合

公開した人がファイルとしてのダウンロードを許可していないデータでは、dataframe export は DATA_EGRESS_LIMIT で失敗します。
実行結果は、id が US-Home-Sales-1963-2016-gH3iJ4kL5m のデータで実行したものです。 実行結果
この場合は、fetch または dataframe get-schema で、公開した人が共有している内容を確認するか、URL をブラウザで開きます。 メッセージには、dataframe_get_schema のような道具の名前が出ることがあります。expl server tools describe <tool_name> で、その道具に対応するコマンドを確認できます。
error_code が DATA_EGRESS_LIMIT であれば、このデータはファイルとして保存できません。

トラブルシューティング

すべてのフラグはdataframe export、絞り込みと集計の指定方法はdataset queryで説明しています。