InfluxDB client
Project description
InfluxDB-Python is a client for interacting with InfluxDB.
InfluxDB is an open-source distributed time series database, find more about InfluxDB at http://influxdb.com/
InfluxDB v0.9.0
InfluxDB v0.9.0 brings many changes to the influxDB api. v0.9.0 users may use the 0.9.0_support branch. Keep in mind that this is a development branch and may break. When v0.9.0 is released, we will merge the 0.9.0_support branch to master and push it to pypi.
You may install it from pip with the following command:
$ pip install https://github.com/influxdb/influxdb-python/archive/0.9.0_support.zip
Installation
Install, upgrade and uninstall InfluxDB-Python with these commands:
$ pip install influxdb $ pip install --upgrade influxdb $ pip uninstall influxdb
On Debian/Ubuntu, you can install it with this command:
$ sudo apt-get install python-influxdb
Dependencies
The InfluxDB-Python distribution is supported and tested on Python 2.7, 3.2, 3.3, 3.4, PyPy and PyPy3.
Main dependency is:
Requests: HTTP library for human beings (http://docs.python-requests.org/)
Additional dependencies are:
pandas: for writing from and reading to DataFrames (http://pandas.pydata.org/)
Sphinx: Tool to create and manage the documentation (http://sphinx-doc.org/)
Nose: to auto-discover tests (http://nose.readthedocs.org/en/latest/)
Mock: to mock tests (https://pypi-hypernode.com/pypi/mock)
Documentation
InfluxDB-Python documentation is available at http://influxdb-python.readthedocs.org
You will need Sphinx installed to generate the documentation.
The documentation can be generated by running:
$ tox -e docs
Generated documentation can be found in the docs/build/html/ directory.
Examples
Here’s a basic example (for more see the examples directory):
$ python
>>> from influxdb import InfluxDBClient
>>> json_body = [{
"points": [
["1", 1, 1.0],
["2", 2, 2.0]
],
"name": "foo",
"columns": ["column_one", "column_two", "column_three"]
}]
>>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example')
>>> client.create_database('example')
>>> client.write_points(json_body)
>>> result = client.query('select column_one from foo;')
>>> print("Result: {0}".format(result))
Testing
Make sure you have tox by running the following:
$ pip install tox
To test influxdb-python with multiple version of Python, you can use Tox:
$ tox
Support
For issues with, questions about, or feedback for InfluxDB, please look into our community page: http://influxdb.com/community/.
Development
All development is done on Github. Use Issues to report problems or submit contributions.
Source code
The source code is currently available on Github: https://github.com/influxdb/influxdb-python
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file influxdb-0.4.0.tar.gz.
File metadata
- Download URL: influxdb-0.4.0.tar.gz
- Upload date:
- Size: 17.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c7fe869b075f2b1568812adc6b96075855aecbda2d83c9a6d23893cb84b9a5fa |
|
| MD5 | 454e3784b0aab3e47bafa53c541ec632 |
|
| BLAKE2b-256 | e3699be8613b9f4bede13c6609bad7256360ee999e41f955c7b157a19d25833a |
