Time-Series Database (TSDB) Tutorials and Guides

The tutorials and guides in this section are aimed at helping users of the Iguazio Data Science Platform (“the platform”) to implement and work with time-series databases (TSDBs) by using the Iguazio V3IO TSDB library (“V3IO TSDB”). This library exposes a high-performance API for creating, updating, querying, and deleting time series databases, and comes with a complementary command-line interface (CLI) tool (tsdbctl) to simplify the use of this API. V3IO TSDB was developed by Iguazio as an open-source project. You can find the full V3IO TSDB source code in the public V3IO TSDB GitHub repository. For a seamless integration with the platform, the V3IO TSDB CLI is pre-deployed as part of the default platform installation.

As an alternative to the TSDB CLI, you can also use the V3IO Frames TSDB API or use serverless TSDB Nuclio functions to ingest TSDB data and submit TSDB queries. TSDB Nuclio functions can be used from the dashboard’s Projects page, Docker, Git, or Jupyter Notebook; for more information, see the documentation in the v3io/tsdb-nuclio GitHub repository and the examples in the platform’s tutorial Jupyter notebooks, which are available as part of the platform’s Jupyter Notebook service.

To use a Nuclio function to ingest data into a recreated TSDB table — i.e., a table that’s created in the same path as a previously deleted TSDB table — note that it’s not enough to suspend the ingestion into the table while it’s being deleted and recreated; you must restart the function before ingesting data into to the newly created table.

For restrictions related to the platform’s TSDB support, refer to the Software Specifications and Restrictions.