跳转到主要内容

InfluxDB客户端

项目描述

通常由社区成员开发和维护InfluxDB v1客户端库。对于InfluxDB 3.0用户,此库由轻量级的v3客户端库继承。对于InfluxDB 2.0用户,请参阅v2客户端库

如果仍有用户使用此 v1 客户端库,并且他们或其他人愿意至少保持其安全更新的话,请通过 社区论坛InfluxData Slack 联系。

InfluxDB-Python

https://travis-ci.org/influxdata/influxdb-python.svg?branch=master Documentation Status Coverage PyPI Status

InfluxDB-Python 是一个用于与 InfluxDB 交互的客户端。

注意:此库用于 InfluxDB 1.x。要连接到 InfluxDB 2.x 实例,请使用 influxdb-client-python 客户端。

此库的开发由以下人员维护:

GitHub ID

URL

@aviau

(https://github.com/aviau)

@xginn8

(https://github.com/xginn8)

@sebito91

(https://github.com/sebito91)

InfluxDB 是一个开源的分布式时序数据库,更多关于 InfluxDB 的信息请访问 https://docs.influxdb.org.cn/influxdb/latest

InfluxDB v1.1.0 之前的用户

此模块已在以下 InfluxDB 版本上进行了测试:v1.2.4、v1.3.9、v1.4.3、v1.5.4、v1.6.4 和 1.7.4。

仍在使用 InfluxDB v0.8.x 的用户可以通过导入 from influxdb.influxdb08 import InfluxDBClient 使用旧客户端。

安装

使用以下命令安装、升级和卸载 influxdb-python:

$ pip install influxdb
$ pip install --upgrade influxdb
$ pip uninstall influxdb

在 Debian/Ubuntu 上,您可以使用此命令安装:

$ sudo apt-get install python-influxdb

依赖项

influxdb-python 分发支持并已在 Python 2.7、3.5、3.6、3.7、PyPy 和 PyPy3 上进行了测试。

注意:目前尚未对 Python <3.5 进行测试。请参阅 .travis.yml

主要依赖项是

其他依赖项包括

文档

文档可在 https://influxdb-python.readthedocs.io/en/latest/ 获取。

要生成文档,您需要安装 Sphinx

可以通过运行以下命令生成文档:

$ tox -e docs

生成的文档可以在 docs/build/html/ 目录中找到。

示例

以下是一个基本示例(更多信息请参阅示例目录)

$ python

>>> from influxdb import InfluxDBClient

>>> json_body = [
    {
        "measurement": "cpu_load_short",
        "tags": {
            "host": "server01",
            "region": "us-west"
        },
        "time": "2009-11-10T23:00:00Z",
        "fields": {
            "value": 0.64
        }
    }
]

>>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example')

>>> client.create_database('example')

>>> client.write_points(json_body)

>>> result = client.query('select value from cpu_load_short;')

>>> print("Result: {0}".format(result))

测试

请确保您已通过以下命令安装了 tox:

$ pip install tox

要使用 Tox 测试 influxdb-python 的多个 Python 版本,您可以使用 Tox

$ tox

支持

有关 InfluxDB 的问题、疑问或反馈,请查看我们的社区页面:http://influxdb.com/community/

我们也在以下地方潜伏:

  • #influxdb 在 irc.freenode.net

  • #influxdb 在 gophers.slack.com

开发

所有开发都是在 Github 上完成的。使用 Issues 报告问题或提交贡献。

请注意,我们将尽快回答您的问题/问题/关注点。我们维护许多软件仓库,有时事情可能会被推迟。请不要介意,我们会尽力尽快回复!

源代码

源代码目前可在Github上获取: https://github.com/influxdata/influxdb-python

待办事项

待办事项/路线图可在Github问题跟踪器中找到: https://github.com/influxdata/influxdb-python/issues

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分发

influxdb-5.3.2.tar.gz (70.8 kB 查看哈希)

上传时间

构建分发

influxdb-5.3.2-py2.py3-none-any.whl (79.4 kB 查看哈希)

上传时间 Python 2 Python 3

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面