IntroxDB客户端
influxdb的Python项目详细描述
infloxdb python是与InfluxDB交互的客户端。
此库的开发由以下人员维护:
Github ID | URL |
---|---|
@aviau | (https://github.com/aviau) |
@xginn8 | (https://github.com/xginn8) |
@sebito91 | (https://github.com/sebito91) |
infloxdb是一个开源的分布式时间序列数据库,请在https://docs.influxdata.com/influxdb/latest上找到有关InfluxDB的更多信息
涌入v1.1.0之前的xdb用户
该模块使用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来使用旧客户端。
安装
使用以下命令安装、升级和卸载infuxdb python:
$ pip install influxdb $ pip install --upgrade influxdb $ pip uninstall influxdb
在debian/ubuntu上,您可以使用以下命令安装它:
$ sudo apt-get install python-influxdb
依赖关系
infloxdb python发行版在python 2.7、3.5、3.6、3.7、pypypy和pypy3上受支持和测试。
注意:python<;3.5目前未经测试。见.travis.yml。
主要依赖项是:
- 请求:人类http库(http://docs.python-requests.org/)
其他依赖项是:
- pandas:用于从数据帧写入和读取数据帧(http://pandas.pydata.org/)
- sphinx:创建和管理文档的工具(http://sphinx-doc.org/)
- nose:自动发现测试(http://nose.readthedocs.org/en/latest/)
- mock:模拟测试(https://pypi.python.org/pypi/mock)
文档
文档可在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))
支架
有关InfluxDB的问题、问题或反馈,请查看 我们的社区页面:http://influxdb.com/community/。
我们还潜伏在以下方面:
- #irc.freenode.net上的infloxdb
- #gophers.slack.com上的infloxDB
开发
所有开发都在Github上完成。使用Issues报告 问题或提交稿件。
请注意,我们将尽快回答您的问题。我们有很多 软件存储库有时可能会被推到backburner。请不要生气, 我们会尽最大努力尽快回复!
源代码
源代码当前在github上可用:https://github.com/influxdata/influxdb-python
待办事项
todo/roadmap可以在github bug tracker中找到:https://github.com/influxdata/influxdb-python/issues