PyGWalker Berechnungsmodi

Verwenden Sie computation, um zu wählen, wo PyGWalker Datenabfragen ausführt. kernel_computation, cloud_computation und use_kernel_calc sind Legacy-Kompatibilitäts-Flags und zur Entfernung in PyGWalker 0.7.0 vorgesehen.

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

Modusmatrix

`computation`-Wert	Internes Verhalten	Verwenden, wenn
weggelassen	Automatisches Verhalten beibehalten	PyGWalker soll seine Standardauswahl behalten.
`"auto"`	Automatisches Verhalten beibehalten	Sie möchten explizit sein, ohne ein Backend zu erzwingen.
`"browser"`	Frontend-/Browser-Berechnung	Sie benötigen statisches HTML oder haben kleinere lokale Daten.
`"kernel"`	Lokale DuckDB-basierte Python-Berechnung	Sie benötigen größere lokale Daten in einer Live-Notebook-, Streamlit-, Gradio- oder Webserver-Sitzung.
`"cloud"`	Kanaries Cloud Computation	Sie möchten Cloud-gestützte Berechnung mit einem Kanaries API-Schlüssel.

Empfohlene Beispiele

Für statische oder reine Frontend-Ausgabe wählen Sie Browser-Berechnung.

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

Für eine Live-Notebook- oder App-Sitzung mit größeren lokalen Daten wählen Sie Kernel-Berechnung.

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

Für Cloud-Berechnung wählen Sie den Cloud-Modus und übergeben Ihren API-Schlüssel.

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

Legacy-Flags

Legacy-Option	Ersatz	Status
`kernel_computation=True`	`computation="kernel"`	Veraltet, zur Entfernung in PyGWalker `0.7.0` vorgesehen.
`kernel_computation=False`	`computation="browser"`	Veraltet, zur Entfernung in PyGWalker `0.7.0` vorgesehen.
`cloud_computation=True`	`computation="cloud"`	Veraltet, zur Entfernung in PyGWalker `0.7.0` vorgesehen.
`use_kernel_calc=True`	`computation="kernel"`	Veraltet, zur Entfernung in PyGWalker `0.7.0` vorgesehen.
`use_kernel_calc=False`	`computation="browser"`	Veraltet, zur Entfernung in PyGWalker `0.7.0` vorgesehen.

Legacy-Flags funktionieren aus Kompatibilitätsgründen noch und geben Deprecation-Warnungen aus. Neue Dokumentation und neuer Code sollten computation verwenden.

Konfliktregel

Mischen Sie keinen nicht automatischen computation-Wert mit aktivierten Legacy-Flags.

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

Drücken Sie die Absicht stattdessen nur einmal aus:

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

Grenzen statischer HTML-Exporte

Statische HTML-Exporte können nicht in einen Live-Python-Kernel oder Cloud-Service zurückrufen. Folgendes wird abgelehnt:

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)

Verwenden Sie Browser-Berechnung für statische Exporte:

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

Verwenden Sie Notebook-APIs, Streamlit, Gradio oder eine Webserver-Sitzung, wenn Sie Live-Kernel- oder Cloud-Berechnung benötigen.

Adapterhinweise

Adapter	Hinweise zur Berechnung
`pyg.walk`, `pyg.render`, `pyg.table`	Akzeptieren `computation`; leiten in Jupyter an Notebook-Adapter und sonst an Webserver-Adapter weiter.
`pyg.Walker`	Speichert den Berechnungsmodus zur Wiederverwendung. Statische Exportmethoden lehnen Live-Kernel-/Cloud-Modi weiterhin ab.
`pygwalker.api.anywidget.walk`	Verwendet in Notebook-Widget-Kontexten standardmäßig Kernel-Verhalten, wenn der automatische Modus genutzt wird.
`StreamlitRenderer`	Verwendet bei automatischem Modus standardmäßig Kernel-Verhalten; akzeptiert `computation="browser"`, `"kernel"` oder `"cloud"`.
`get_html_on_gradio`	Akzeptiert `computation` und Live-Backend-Modi.
`pyg.to_html`	Nur Browser/statisch.
Reflex-Adapter	Lehnt Kernel- und Cloud-Berechnung ab; verwenden Sie `computation="browser"`.