infi.clickhouse_orm 使用教程

最新推荐文章于 2024-09-16 08:00:09 发布

祁泉望Ernestine

最新推荐文章于 2024-09-16 08:00:09 发布

阅读量874

点赞数 21

本文链接：https://blog.csdn.net/gitblog_01026/article/details/142292695

版权

infi.clickhouse_orm 使用教程

infi.clickhouse_orm A Python library for working with the ClickHouse database (https://clickhouse.yandex/) 项目地址: https://gitcode.com/gh_mirrors/in/infi.clickhouse_orm

1. 项目介绍

infi.clickhouse_orm 是一个用于与 ClickHouse 数据库进行交互的 Python 库。ClickHouse 是一个高性能的列式数据库管理系统，特别适合于实时分析和大数据处理。infi.clickhouse_orm 提供了一个简单的 ORM（对象关系映射）层，使得开发者可以通过定义模型类来操作 ClickHouse 数据库，而无需直接编写 SQL 语句。

2. 项目快速启动

2.1 安装

首先，你需要安装 infi.clickhouse_orm。你可以通过 pip 来安装：

pip install infi.clickhouse-orm

2.2 连接数据库

接下来，你需要连接到 ClickHouse 数据库。以下是一个简单的示例：

from infi.clickhouse_orm import Database, Model, DateTimeField, UInt16Field, Float32Field, Memory

# 定义模型类
class CPUStats(Model):
    timestamp = DateTimeField()
    cpu_id = UInt16Field()
    cpu_percent = Float32Field()
    engine = Memory()

# 连接到数据库
db = Database('demo')

# 创建表
db.create_table(CPUStats)

2.3 插入数据

你可以通过实例化模型类并调用 insert 方法来插入数据：

import psutil
import time
from datetime import datetime

# 收集 CPU 使用率数据
while True:
    time.sleep(1)
    stats = psutil.cpu_percent(percpu=True)
    timestamp = datetime.now()
    db.insert([
        CPUStats(timestamp=timestamp, cpu_id=cpu_id, cpu_percent=cpu_percent)
        for cpu_id, cpu_percent in enumerate(stats)
    ])

2.4 查询数据

你可以使用查询构建器或直接使用 SQL 来查询数据：

# 查询 CPU 1 的使用率
queryset = CPUStats.objects_in(db)
total = queryset.filter(CPUStats.cpu_id == 1).count()
busy = queryset.filter(CPUStats.cpu_id == 1, CPUStats.cpu_percent > 95).count()
print('CPU 1 was busy {:.2f}% of the time'.format(busy * 100.0 / total))