influxio

CI Coverage Status Documentation License Downloads per month

Supported Python versions Status Package version

» Documentation | Changelog | PyPI | Issues | Source code | License

About

Import and export data into/from InfluxDB, for humans and machines.

Features

  • Capable: Connect to the InfluxDB HTTP API, or read from an InfluxDB TSM data directory directly.

  • Concise: All features are available through a single powerful primitive, influxio copy.

  • Polyglot: Support I/O operations between InfluxDB, any SQL database supported by SQLAlchemy, file formats supported by pandas/Dask, and the native InfluxDB line protocol (ILP), on both import and export directions.

  • Versatile: Use it as a command-line program, pipeline element, or as a library within your own applications.

Synopsis

# Export from API to database.
influxio copy \
    "http://example:token@localhost:8086/testdrive/demo" \
    "sqlite://export.sqlite?table=demo"

# Export from data directory to line protocol format.
influxio copy \
    "file:///path/to/influxdb/engine?bucket-id=372d1908eab801a6&measurement=demo" \
    "file://export.lp"

Documentation

Please visit the README document to learn what you can do with the influxio package. Effectively, it is all about the influxio copy primitive, which accepts a range of variants on its SOURCE and TARGET arguments, in URL formats.

Development

Contributions are very much welcome. Please visit the Development documentation to learn about how to spin up a sandbox environment on your workstation, or create a ticket to report a bug or share an idea about a possible feature.