Skip to content

PyGWalker 計算モード

PyGWalker がデータクエリをどこで実行するかを選ぶには computation を使います。kernel_computation、cloud_computation、use_kernel_calc はレガシー互換フラグで、PyGWalker 0.7.0 で削除予定です。

import pygwalker as pyg
 
walker = pyg.walk(df, spec_path="./gw_config.json", computation="kernel")

モードマトリクス

computation 値内部挙動使う場面
省略自動挙動を維持PyGWalker のデフォルト選択を維持したい場合。
"auto"自動挙動を維持バックエンドを強制せず、意図を明示したい場合。
"browser"フロントエンド / ブラウザー計算静的 HTML が必要な場合、または小さめのローカルデータを扱う場合。
"kernel"ローカル DuckDB ベースの Python 計算ライブ notebook、Streamlit、Gradio、webserver セッションで大きめのローカルデータを扱う場合。
"cloud"Kanaries cloud computationKanaries API キーを使ったクラウド計算が必要な場合。

推奨例

静的またはフロントエンドのみの出力では、browser computation を選びます。

html = pyg.to_html(df, spec_path="./gw_config.json", computation="browser")

大きめのローカルデータをライブ notebook やアプリセッションで扱う場合は、kernel computation を選びます。

walker = pyg.walk(df, spec_path="./gw_config.json", computation="kernel")

cloud computation では cloud モードを選び、API キーを渡します。

walker = pyg.walk(
    df,
    spec_path="./gw_config.json",
    computation="cloud",
    kanaries_api_key="...",
)

レガシーフラグ

レガシーオプション置き換えステータス
kernel_computation=Truecomputation="kernel"非推奨。PyGWalker 0.7.0 で削除予定です。
kernel_computation=Falsecomputation="browser"非推奨。PyGWalker 0.7.0 で削除予定です。
cloud_computation=Truecomputation="cloud"非推奨。PyGWalker 0.7.0 で削除予定です。
use_kernel_calc=Truecomputation="kernel"非推奨。PyGWalker 0.7.0 で削除予定です。
use_kernel_calc=Falsecomputation="browser"非推奨。PyGWalker 0.7.0 で削除予定です。

レガシーフラグは互換性のため引き続き動作し、非推奨警告を出します。新しいドキュメントと新しいコードでは computation を使ってください。

競合ルール

非 auto の computation 値と有効化されたレガシーフラグを混在させないでください。

# Raises ValueError.
pyg.walk(df, computation="browser", kernel_computation=True)

意図は 1 つの書き方だけで表します。

pyg.walk(df, computation="browser")

静的 HTML の制限

静的 HTML エクスポートはライブ Python kernel やクラウドサービスへコールバックできません。次の指定は拒否されます。

pyg.to_html(df, computation="kernel")
pyg.to_html(df, computation="cloud")
pyg.to_html(df, kernel_computation=True)
pyg.to_html(df, cloud_computation=True)
pyg.to_html(df, use_kernel_calc=True)

静的エクスポートでは browser computation を使います。

html = pyg.to_html(df, spec_path="./gw_config.json", computation="browser")

ライブ kernel や cloud computation が必要な場合は、ノートブック API、Streamlit、Gradio、または webserver セッションを使います。

アダプターメモ

アダプター計算に関するメモ
pyg.walk, pyg.render, pyg.tablecomputation を受け取り、Jupyter では notebook アダプターへ、それ以外では webserver アダプターへルーティングします。
pyg.Walker再利用用に計算モードを保持します。静的エクスポートメソッドは live kernel / cloud mode を引き続き拒否します。
pygwalker.api.anywidget.walknotebook widget コンテキストで automatic mode が使われた場合、kernel 挙動がデフォルトになります。
StreamlitRendererautomatic mode では kernel 挙動がデフォルトです。computation="browser"、"kernel"、"cloud" を受け取ります。
get_html_on_gradiocomputation とライブバックエンドモードを受け取ります。
pyg.to_htmlブラウザー / 静的のみです。
Reflex adapterkernel と cloud computation を拒否します。computation="browser" を使います。

関連ガイド