在python 3.14 容器中安装和使用chdb包
更新时间：2026年02月14日 14:01:19 作者：l1t
文章介绍了如何在Python容器中使用chdb包进行ClickHouse数据库的查询,本文给大家讲解的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
1.docker exec -it登录容器用pip install 命令安装
sudo docker exec -it python3143 bash
root@DESKTOP-59T6U68:/# pip install chdb
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Collecting chdb
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/23/28/f3aa551b4af78b8ac967c191407301eff5906dc7239ddb232d4d34bf8ad4/chdb-4.0.1-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (149.4 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 149.4/149.4 MB 31.3 MB/s 0:00:04
Collecting pandas<3.0.0,>=2.1.0 (from chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/15/b2/0e62f78c0c5ba7e3d2c5945a82456f4fac76c480940f805e0b97fcbc2f65/pandas-2.3.3-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (12.3 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 12.3/12.3 MB 51.4 MB/s 0:00:00
Collecting pyarrow>=13.0.0 (from chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/9c/86/95c61ad82236495f3c31987e85135926ba3ec7f3819296b70a68d8066b49/pyarrow-23.0.0-cp314-cp314-manylinux_2_28_x86_64.whl (47.6 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 47.6/47.6 MB 33.8 MB/s 0:00:01
Collecting numpy>=1.26.0 (from pandas<3.0.0,>=2.1.0->chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/5d/6c/7f237821c9642fb2a04d2f1e88b4295677144ca93285fd76eff3bcba858d/numpy-2.4.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (16.6 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 16.6/16.6 MB 43.4 MB/s 0:00:00
Collecting python-dateutil>=2.8.2 (from pandas<3.0.0,>=2.1.0->chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl (229 kB)
Collecting pytz>=2020.1 (from pandas<3.0.0,>=2.1.0->chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/81/c4/34e93fe5f5429d7570ec1fa436f1986fb1f00c3e0f43a589fe2bbcd22c3f/pytz-2025.2-py2.py3-none-any.whl (509 kB)
Collecting tzdata>=2022.7 (from pandas<3.0.0,>=2.1.0->chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl (348 kB)
Collecting six>=1.5 (from python-dateutil>=2.8.2->pandas<3.0.0,>=2.1.0->chdb)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl (11 kB)
Installing collected packages: pytz, tzdata, six, pyarrow, numpy, python-dateutil, pandas, chdb
Successfully installed chdb-4.0.1 numpy-2.4.2 pandas-2.3.3 pyarrow-23.0.0 python-dateutil-2.9.0.post0 pytz-2025.2 six-1.17.0 tzdata-2025.3
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager, possibly rendering your system unusable. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv. Use the --root-user-action option if you know what you are doing and want to suppress this warning.
[notice] A new release of pip is available: 25.3 -> 26.0.1
[notice] To update, run: pip install --upgrade pip2.导入后就可以用chdb.query查询
root@DESKTOP-59T6U68:/# python3
Python 3.14.3 (main, Feb 4 2026, 20:08:31) [GCC 14.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import chdb
>>> res = chdb.query('select version()', 'Pretty'); print(res)
┏━━━━━━━━━━━┓
┃ version() ┃
┡━━━━━━━━━━━┩
1. │ 25.8.2.1 │
└───────────┘
>>> res = chdb.query('select * from file("/par/duck.parquet", Parquet)'); print(res)
"13522500"
>>> res = chdb.query('select * from file("/par/duck.parquet", Parquet)','Pretty'); print(res)
┏━━━━━━━━━━┓
┃ mpz_sum ┃
┡━━━━━━━━━━┩
1. │ 13522500 │
└──────────┘
>>>
>>> res = chdb.query('select * from file("/par/duck.parquet", Parquet)', 'JSON'); print(res)
{
"meta":
[
{
"name": "mpz_sum",
"type": "Nullable(String)"
}
],
"data":
[
{
"mpz_sum": "13522500"
}
],
"rows": 1,
"statistics":
{
"elapsed": 0.037387861,
"rows_read": 0,
"bytes_read": 0
}
}
>>> res = chdb.query('select * from file("/par/duck.parquet", Parquet)','PrettyCompact'); print(res)
┌─mpz_sum──┐
1. │ 13522500 │
└──────────┘上面查询了版本号和Parquet文件，query的第二个参数用来指定不同的格式，不加参数默认是无标题的字符串，加PrettyCompact参数才是clickhouse客户端默认的格式。
如果要查询带\r的tsv文件，需要设置参数input_format_tsv_crlf_end_of_line，clickhouse客户端中有两种方式，一种是单独用set命令设置，另一种是在查询语句中用SETTINGS子句。
:) set input_format_tsv_crlf_end_of_line=true;
SET input_format_tsv_crlf_end_of_line = true
Query id: 60a7f1df-aad9-41fc-b100-d2c507da7949
Ok.
0 rows in set. Elapsed: 0.009 sec.
:) select * from file('/mnt/c/d/data/cxy.tsv', Tsv) ;
SELECT *
FROM file('/mnt/c/d/data/cxy.tsv', Tsv)
Query id: 5246c40d-2915-412c-8f28-97912d88e14f
┌─id─┬─name────┬─language───┐
1. │ 1 │ Joe │ Java │
2. │ 2 │ Alice │ JavaScript │
3. │ 3 │ Leon │ C/C++ │
4. │ 4 │ William │ Java │
5. │ 5 │ James │ C/C++ │
6. │ 6 │ Enson │ C/C++ │
└────┴─────────┴────────────┘
6 rows in set. Elapsed: 0.067 sec.
:) set input_format_tsv_crlf_end_of_line=false;
SET input_format_tsv_crlf_end_of_line = false
Query id: 591cf022-de92-4165-80e1-9744b8bdf93c
Ok.
0 rows in set. Elapsed: 0.000 sec.
:) select * from file('/mnt/c/d/data/cxy.tsv', Tsv) ;
SELECT *
FROM file('/mnt/c/d/data/cxy.tsv', Tsv)
Query id: d56dd6fe-b217-4c0b-b3a0-344202ed0fd9
Elapsed: 0.071 sec.
Received exception:
Code: 117. DB::Exception:
You have carriage return (\r, 0x0D, ASCII 13) at end of first row.
It's like your input data has DOS/Windows style line separators, that are illegal in TabSeparated format. You must transform your file to Unix format.
But if you really need carriage return at end of string value of last column, you need to escape it as \r
or else enable setting 'input_format_tsv_crlf_end_of_line': (while reading header): (in file/uri /mnt/c/d/data/cxy.tsv): While executing ParallelParsingBlockInputFormat: While executing File. (INCORRECT_DATA)
:)
:) select * from file('/mnt/c/d/data/cxy.tsv', Tsv) settings input_format_tsv_crlf_end_of_line =true;
SELECT *
FROM file('/mnt/c/d/data/cxy.tsv', Tsv)
SETTINGS input_format_tsv_crlf_end_of_line = true
Query id: 6bb8ec95-c597-4716-aee3-b60a001c76f2
┌─id─┬─name────┬─language───┐
1. │ 1 │ Joe │ Java │
2. │ 2 │ Alice │ JavaScript │
3. │ 3 │ Leon │ C/C++ │
4. │ 4 │ William │ Java │
5. │ 5 │ James │ C/C++ │
6. │ 6 │ Enson │ C/C++ │
└────┴─────────┴────────────┘
6 rows in set. Elapsed: 0.008 sec.
:) \q
Bye.在python中只能用后一种
>>> import chdb
>> res = chdb.query('select * from file("/par/data/cxy.tsv", Tsv)','Pretty'); print(res)
Traceback (most recent call last):
File "<python-input-7>", line 1, in <module>
res = chdb.query('select * from file("/par/data/cxy.tsv", Tsv)','Pretty'); print(res)
File "/usr/local/lib/python3.14/site-packages/chdb/__init__.py", line 205, in query
res = conn.query(sql, output_format, params=params)
RuntimeError: Code: 636. DB::Exception: The table structure cannot be extracted from a Tsv format file. Error:
Code: 117. DB::Exception:
You have carriage return (\r, 0x0D, ASCII 13) at end of first row.
It's like your input data has DOS/Windows style line separators, that are illegal in TabSeparated format. You must transform your file to Unix format.
But if you really need carriage return at end of string value of last column, you need to escape it as \r
or else enable setting 'input_format_tsv_crlf_end_of_line'. (INCORRECT_DATA) (version 25.8.2.1).
You can specify the structure manually: (in file/uri /par/data/cxy.tsv). (CANNOT_EXTRACT_TABLE_STRUCTURE)
>>> res = chdb.query('select * from file("/par/data/cxy.tsv", Tsv) settings input_format_tsv_crlf_end_of_line=true','Pretty'); print(res)
┏━━━━┳━━━━━━━━━┳━━━━━━━━━━━━┓
┃ id ┃ name ┃ language ┃
┡━━━━╇━━━━━━━━━╇━━━━━━━━━━━━┩
1. │ 1 │ Joe │ Java │
├────┼─────────┼────────────┤
2. │ 2 │ Alice │ JavaScript │
├────┼─────────┼────────────┤
3. │ 3 │ Leon │ C/C++ │
├────┼─────────┼────────────┤
4. │ 4 │ William │ Java │
├────┼─────────┼────────────┤
5. │ 5 │ James │ C/C++ │
├────┼─────────┼────────────┤
6. │ 6 │ Enson │ C/C++ │
└────┴─────────┴────────────┘
>>>
>>> res = chdb.query('select * from file("/par/data/cxy.tsv", Tsv) settings input_format_tsv_crlf_end_of_line=true','PrettyCompact'); print(res)
┌─id─┬─name────┬─language───┐
1. │ 1 │ Joe │ Java │
2. │ 2 │ Alice │ JavaScript │
3. │ 3 │ Leon │ C/C++ │
4. │ 4 │ William │ Java │
5. │ 5 │ James │ C/C++ │
6. │ 6 │ Enson │ C/C++ │
└────┴─────────┴────────────┘
>>> chdb.query('select * from file("/par/data/cxy.tsv", Tsv) settings input_format_tsv_crlf_end_of_line=true','PrettyCompact')
┌─id─┬─name────┬─language───┐
1. │ 1 │ Joe │ Java │
2. │ 2 │ Alice │ JavaScript │
3. │ 3 │ Leon │ C/C++ │
4. │ 4 │ William │ Java │
5. │ 5 │ James │ C/C++ │
6. │ 6 │ Enson │ C/C++ │
└────┴─────────┴────────────┘查询结果可存入变量，然后用print()输出，也可以执行查询时直接输出。
到此这篇关于在python 3.14 容器中安装和使用chdb包的文章就介绍到这了,更多相关python安装和使用chdb包内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
您可能感兴趣的文章:
相关文章
在向量数据库技术快速发展的今天,Milvus作为开源领域的领军产品,正成为AI应用开发的重要基础设施,本章将深入讲解Python与Milvus向量数据库的整合实践,感兴趣的小伙伴可以了解下2025-05-05
这篇文章主要介绍了如何用python写个模板引擎，帮助大家更好的理解和使用python，感兴趣的朋友可以了解下2021-01-01
使用tf.keras.MaxPooling1D出现错误问题及解决
这篇文章主要介绍了使用tf.keras.MaxPooling1D出现错误问题及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-12-12
Qt框架凭借其跨平台能力和丰富的控件库,在桌面应用开发领域占据重要地位,当Python的简洁语法遇上Qt的成熟生态,便诞生了PyQt/PySide这两个黄金搭档,本文给大家介绍了Python3如何使用QT编写基础的对话框程序,需要的朋友可以参考下2025-06-06
今天小编就为大家分享一篇Django forms表单 select下拉框的传值实例。具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2019-07-07
这篇文章主要为大家详细介绍了python实现简易版学生成绩管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2020-06-06
这篇文章主要介绍了python基于Selenium的web自动化框架，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-07-07
这篇文章主要介绍了python 绘制斜率图进行对比分析的实例，帮助大家更好的理解和学习使用python，感兴趣的朋友可以了解下2021-03-03
下面小编就为大家带来一篇Python的IDEL增加清屏功能实例。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-06-06
基于Pyinstaller打包Python程序并压缩文件大小
这篇文章主要介绍了基于Pyinstaller打包Python程序并压缩文件大小,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-05-05
最新评论