#polars #sql-query #interface #command-line-interface #running #back-end #cli-interface

app polars-cli

以 Polars 作为后端运行 SQL 查询的 CLI 接口

9 个版本 (重大更改)

0.8.0 2024 年 6 月 3 日
0.7.0 2024 年 3 月 7 日
0.6.0 2024 年 1 月 4 日
0.5.1 2023 年 11 月 4 日
0.3.0 2023 年 7 月 15 日

#410 in 编码

MIT 许可证

34KB
527

Polars CLI

Crates.io PyPI

Polars 命令行界面提供了一种方便的方式,可以使用 Polars 作为后端来执行 SQL 命令。

安装

安装 Polars CLI 的推荐方法是使用 pip

pip install polars-cli

这将安装一个预编译的二进制文件,并将其放置在您的路径下 polars。如果您没有 Python,您可以从最新的 GitHub 发布版 下载合适的二进制文件。

或者,您可以使用 cargo 安装 Polars CLI,这将从头开始编译代码

cargo install --locked polars-cli

使用方法

不提供任何参数运行 polars 将启动一个交互式 shell,您可以在其中运行 SQL 命令。

$ polars
Polars CLI version 0.4.0
Type .help for help.

>> select * FROM read_csv('examples/datasets/foods.csv');
┌────────────┬──────────┬────────┬──────────┐
 category   ┆ calories ┆ fats_g ┆ sugars_g │
 ---        ┆ ---      ┆ ---    ┆ ---      │
 str        ┆ i64      ┆ f64    ┆ i64      │
╞════════════╪══════════╪════════╪══════════╡
 vegetables ┆ 45       ┆ 0.5    ┆ 2        │
 seafood    ┆ 150      ┆ 5.0    ┆ 0        │
 meat       ┆ 100      ┆ 5.0    ┆ 0        │
 fruit      ┆ 60       ┆ 0.0    ┆ 11       │
 …          ┆ …        ┆ …      ┆ …        │
 seafood    ┆ 200      ┆ 10.0   ┆ 0        │
 seafood    ┆ 200      ┆ 7.0    ┆ 2        │
 fruit      ┆ 60       ┆ 0.0    ┆ 11       │
 meat       ┆ 110      ┆ 7.0    ┆ 0        │
└────────────┴──────────┴────────┴──────────┘

或者,可以直接将 SQL 命令管道到 Polars CLI。

$ echo "SELECT category FROM read_csv('examples/datasets/foods.csv')" | polars
┌────────────┐
 category   │
 ---        │
 str        │
╞════════════╡
 vegetables │
 seafood    │
 meat       │
 fruit      │
 …          │
 seafood    │
 seafood    │
 fruit      │
 meat       │
└────────────┘

功能

从源代码编译 Polars CLI 时,可以启用以下功能

功能 描述
default 包括所有其他功能的默认功能集。
highlight 提供语法高亮显示
parquet 启用读取和写入 Apache Parquet 文件。
json 启用读取和写入 JSON 文件。
ipc 启用读取和写入 IPC/Apache Arrow 文件

依赖关系

~33–67MB
~1M SLoC