Modos de Computação do PyGWalker

Use computation para escolher onde o PyGWalker executa consultas de dados. kernel_computation, cloud_computation e use_kernel_calc são flags legadas de compatibilidade e têm remoção programada para o PyGWalker 0.7.0.

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

Matriz de modos

Valor de `computation`	Comportamento interno	Use quando
omitido	Preserva o comportamento automático	Você quer que o PyGWalker mantenha sua seleção padrão.
`"auto"`	Preserva o comportamento automático	Você quer ser explícito sem forçar um backend.
`"browser"`	Computação no frontend/navegador	Você precisa de HTML estático ou tem dados locais menores.
`"kernel"`	Computação Python local baseada em DuckDB	Você precisa de dados locais maiores em uma sessão ativa de notebook, Streamlit, Gradio ou webserver.
`"cloud"`	Computação em nuvem da Kanaries	Você quer computação em nuvem com uma chave de API Kanaries.

Exemplos recomendados

Para saída estática ou apenas frontend, escolha computação no navegador.

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

Para uma sessão ativa de notebook ou app com dados locais maiores, escolha computação em kernel.

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

Para computação em nuvem, escolha o modo cloud e passe sua chave de API.

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

Flags legadas

Opção legada	Substituição	Status
`kernel_computation=True`	`computation="kernel"`	Depreciada, com remoção programada para o PyGWalker `0.7.0`.
`kernel_computation=False`	`computation="browser"`	Depreciada, com remoção programada para o PyGWalker `0.7.0`.
`cloud_computation=True`	`computation="cloud"`	Depreciada, com remoção programada para o PyGWalker `0.7.0`.
`use_kernel_calc=True`	`computation="kernel"`	Depreciada, com remoção programada para o PyGWalker `0.7.0`.
`use_kernel_calc=False`	`computation="browser"`	Depreciada, com remoção programada para o PyGWalker `0.7.0`.

As flags legadas ainda funcionam por compatibilidade e emitem avisos de depreciação. Docs novos e código novo devem usar computation.

Regra de conflito

Não misture um valor computation não automático com flags legadas habilitadas.

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

Use uma única expressão de intenção:

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

Limitações de HTML estático

Exportações HTML estáticas não podem chamar um kernel Python ativo ou serviço de nuvem. As chamadas abaixo são rejeitadas:

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)

Use computação no navegador para exportações estáticas:

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

Use APIs de Notebook, Streamlit, Gradio ou uma sessão webserver quando precisar de computação ativa em kernel ou nuvem.

Observações por adaptador

Adaptador	Observações de computação
`pyg.walk`, `pyg.render`, `pyg.table`	Aceitam `computation`; roteiam para adaptadores de notebook no Jupyter e webserver em outros ambientes.
`pyg.Walker`	Armazena o modo de computação para reutilização. Métodos de exportação estática ainda rejeitam modos ativos de kernel/cloud.
`pygwalker.api.anywidget.walk`	Usa comportamento de kernel por padrão quando o modo automático é usado em contextos de widget de notebook.
`StreamlitRenderer`	Usa comportamento de kernel por padrão quando o modo automático é usado; aceita `computation="browser"`, `"kernel"` ou `"cloud"`.
`get_html_on_gradio`	Aceita `computation` e modos com backend ativo.
`pyg.to_html`	Apenas navegador/estático.
Adaptador Reflex	Rejeita computação em kernel e nuvem; use `computation="browser"`.

Guias Relacionados

APIs de Notebook Streamlit