Python 语言参考
Python 查询脚本运行的是真正的 Python——由 RustPython 解释器编译为 WebAssembly，在受限沙箱中执行。脚本用完整的 Python 语法编写，并可 import 冻结的标准库；数据处理 API 采用 Polars 风格的 DataFrame / Series / Expr。
本参考描述脚本作用域中直接可用（无需 import）的内置类型与函数。如需入门与整体流程说明，请先阅读 Python 查询脚本。
脚本约定
- 脚本必须定义
main()函数作为入口，其返回值即查询结果。 main()可返回DataFrame、Series，或list[dict]等 JSON 可序列化值。- 以下名称已注入作用域，无需
import：DataFrame、Series、pl、query、fetch、args、print。 pl命名空间除pl.col()/pl.lit()和数据类型常量外，还提供pl.when()条件表达式、pl.cov()/pl.corr()统计函数。
内置函数
- 全局函数 —
query、fetch、args、print与pl命名空间
内置类型
示例
- 示例合集 — 取数、参数、HTTP、分组聚合等常见写法
数据类型
pl 命名空间下提供以下逻辑数据类型常量：
| 常量 | 说明 |
|---|---|
pl.Int / pl.Int32 / pl.Int64 | 整数（物理上均为 Int64，repr 为 Int） |
pl.Float / pl.Float32 / pl.Float64 | 浮点数（物理上均为 Float64，repr 为 Float） |
pl.Boolean | 布尔 |
pl.String | 字符串 |
pl.Datetime | 日期时间 |
pl.Date | 日期 |
备注
精度在用户侧不作区分：pl.Int32 == pl.Int64、pl.Float32 == pl.Float64 均成立。