Modes de calcul PyGWalker

Utilisez computation pour choisir où PyGWalker exécute les requêtes de données. kernel_computation, cloud_computation et use_kernel_calc sont des anciennes options de compatibilité et leur suppression est prévue dans PyGWalker 0.7.0.

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

Matrice des modes

Valeur de `computation`	Comportement interne	À utiliser lorsque
omise	Préserve le comportement automatique	Vous voulez que PyGWalker conserve sa sélection par défaut.
`"auto"`	Préserve le comportement automatique	Vous voulez être explicite sans forcer un backend.
`"browser"`	Calcul frontend/browser	Vous avez besoin de HTML statique ou travaillez avec de petites données locales.
`"kernel"`	Calcul Python local basé sur DuckDB	Vous avez besoin de données locales plus volumineuses dans une session notebook, Streamlit, Gradio ou webserver active.
`"cloud"`	Calcul cloud Kanaries	Vous voulez un calcul cloud avec une clé API Kanaries.

Exemples recommandés

Pour une sortie statique ou frontend-only, choisissez le calcul browser.

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

Pour une session notebook ou application active avec de grandes données locales, choisissez le calcul kernel.

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

Pour le calcul cloud, choisissez le mode cloud et passez votre clé API.

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

Anciennes options

Ancienne option	Remplacement	Statut
`kernel_computation=True`	`computation="kernel"`	Obsolète, suppression prévue dans PyGWalker `0.7.0`.
`kernel_computation=False`	`computation="browser"`	Obsolète, suppression prévue dans PyGWalker `0.7.0`.
`cloud_computation=True`	`computation="cloud"`	Obsolète, suppression prévue dans PyGWalker `0.7.0`.
`use_kernel_calc=True`	`computation="kernel"`	Obsolète, suppression prévue dans PyGWalker `0.7.0`.
`use_kernel_calc=False`	`computation="browser"`	Obsolète, suppression prévue dans PyGWalker `0.7.0`.

Les anciennes options fonctionnent encore pour la compatibilité et émettent des avertissements de dépréciation. Les nouveaux docs et le nouveau code doivent utiliser computation.

Règle de conflit

Ne mélangez pas une valeur computation non automatique avec des anciennes options activées.

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

Exprimez l'intention d'une seule façon :

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

Limites du HTML statique

Les exports HTML statiques ne peuvent pas rappeler un kernel Python actif ou un service cloud. Les appels suivants sont refusés :

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)

Utilisez le calcul browser pour les exports statiques :

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

Utilisez API Notebook, Streamlit, Gradio ou une session webserver lorsque vous avez besoin de calcul kernel ou cloud en direct.

Notes par adaptateur

Adaptateur	Notes de calcul
`pyg.walk`, `pyg.render`, `pyg.table`	Acceptent `computation` ; routent vers les adaptateurs notebook dans Jupyter et webserver ailleurs.
`pyg.Walker`	Stocke le mode de calcul pour réutilisation. Les méthodes d'export statique refusent quand même les modes kernel/cloud actifs.
`pygwalker.api.anywidget.walk`	Utilise par défaut le comportement kernel lorsque le mode automatique est utilisé dans les contextes widget de notebook.
`StreamlitRenderer`	Utilise par défaut le comportement kernel lorsque le mode automatique est utilisé ; accepte `computation="browser"`, `"kernel"` ou `"cloud"`.
`get_html_on_gradio`	Accepte `computation` et les modes backend actifs.
`pyg.to_html`	Browser/statique uniquement.
Adaptateur Reflex	Refuse le calcul kernel et cloud ; utilisez `computation="browser"`.

Guides associés

API Notebook Streamlit