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 계산	라이브 노트북, Streamlit, Gradio, 웹서버 세션에서 큰 로컬 데이터가 필요할 때입니다.
`"cloud"`	Kanaries 클라우드 계산	Kanaries API 키로 클라우드 기반 계산을 사용하고 싶을 때입니다.

권장 예시

정적 또는 프론트엔드 전용 출력에는 browser 계산을 선택하세요.

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

큰 로컬 데이터를 다루는 라이브 노트북 또는 앱 세션에는 kernel 계산을 선택하세요.

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

클라우드 계산에는 cloud 모드를 선택하고 API 키를 전달하세요.

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

레거시 플래그

레거시 옵션	대체 옵션	상태
`kernel_computation=True`	`computation="kernel"`	Deprecated, PyGWalker `0.7.0`에서 제거 예정입니다.
`kernel_computation=False`	`computation="browser"`	Deprecated, PyGWalker `0.7.0`에서 제거 예정입니다.
`cloud_computation=True`	`computation="cloud"`	Deprecated, PyGWalker `0.7.0`에서 제거 예정입니다.
`use_kernel_calc=True`	`computation="kernel"`	Deprecated, PyGWalker `0.7.0`에서 제거 예정입니다.
`use_kernel_calc=False`	`computation="browser"`	Deprecated, PyGWalker `0.7.0`에서 제거 예정입니다.

레거시 플래그는 호환성을 위해 아직 동작하며 deprecation 경고를 냅니다. 새 문서와 새 코드는 computation을 사용해야 합니다.

충돌 규칙

non-auto computation 값과 활성화된 레거시 플래그를 섞지 마세요.

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

의도는 하나의 표현으로만 지정하세요.

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 계산을 사용하세요.

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

라이브 kernel 또는 cloud 계산이 필요하면 노트북 API, Streamlit, Gradio 또는 웹서버 세션을 사용하세요.

어댑터 참고

어댑터	계산 관련 참고
`pyg.walk`, `pyg.render`, `pyg.table`	`computation`을 받고, Jupyter에서는 노트북 어댑터로, 그 밖에서는 웹서버 어댑터로 라우팅합니다.
`pyg.Walker`	재사용을 위해 계산 모드를 저장합니다. 정적 내보내기 메서드는 여전히 라이브 kernel/cloud 모드를 거부합니다.
`pygwalker.api.anywidget.walk`	노트북 위젯 컨텍스트에서 자동 모드를 사용할 때 kernel 동작이 기본입니다.
`StreamlitRenderer`	자동 모드를 사용할 때 kernel 동작이 기본이며, `computation="browser"`, `"kernel"`, `"cloud"`를 받습니다.
`get_html_on_gradio`	`computation`과 라이브 백엔드 모드를 받습니다.
`pyg.to_html`	브라우저/정적 전용입니다.
Reflex adapter	kernel 및 cloud 계산을 거부합니다. `computation="browser"`를 사용하세요.