Skip to content

API Cloud de PyGWalker

Usa computation="cloud" cuando una sesión activa de PyGWalker deba ejecutar consultas de datos mediante Kanaries cloud. Usa las API helper de cloud cuando necesites crear o abrir activos de Kanaries cloud directamente.

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

create_cloud_dataset

create_cloud_dataset sube un dataset y devuelve el ID del dataset cloud.

from pygwalker.api.kanaries_cloud import create_cloud_dataset
 
dataset_id = create_cloud_dataset(
    df,
    name="sales_dataset",
    is_public=False,
    kanaries_api_key="...",
)

Firma:

create_cloud_dataset(
    dataset,
    *,
    name=None,
    is_public=False,
    kanaries_api_key="",
) -> str

dataset puede ser un pandas DataFrame, polars DataFrame, pyarrow Table o Connector de base de datos.

Helpers heredados de cloud walker

Estos helpers existen por compatibilidad con flujos de trabajo cloud antiguos.

from pygwalker.api.kanaries_cloud import create_cloud_walker, walk_on_cloud
 
create_cloud_walker(
    df,
    chart_name="Revenue Dashboard",
    workspace_name="Analytics",
    kanaries_api_key="...",
)
 
walk_on_cloud(
    workspace_name="Analytics",
    chart_name="Revenue Dashboard",
    kanaries_api_key="...",
)

Firmas:

create_cloud_walker(
    dataset,
    *,
    chart_name,
    workspace_name,
    field_specs=None,
    kanaries_api_key="",
) -> str
 
walk_on_cloud(workspace_name, chart_name, kanaries_api_key="")

Prefiere computation="cloud" en las API normales de PyGWalker cuando el objetivo sea computación respaldada por cloud en un notebook o app activos.

Computación cloud vs flags heredados

Usa:

pyg.walk(df, computation="cloud", kanaries_api_key="...")

No empieces código nuevo con:

pyg.walk(df, cloud_computation=True)

cloud_computation es un flag heredado de compatibilidad y está programado para eliminarse en PyGWalker 0.7.0. También entra en conflicto con valores computation no automáticos cuando está habilitado.

Guías relacionadas