Documentation

Migrate data to the InfluxDB IOx storage engine

Migrate data to InfluxDB Cloud backed by InfluxDB IOx from other InfluxDB instances backed by TSM including InfluxDB OSS 1.x, 2.x, InfluxDB Enterprise, and InfluxDB Cloud.

Should you migrate?

There are important things to consider with migrating to InfluxDB Cloud backed by InfluxDB IOx. The following questions will help guide your decision to migrate.

Are you currently limited by series cardinality?

Yes, you should migrate. Series cardinality is a major limiting factor with the InfluxDB TSM storage engine. The more unique series in your data, the less performant your database. The IOx storage engine supports near limitless series cardinality and is without question, the better solution for high series cardinality workloads.

Do you want to use SQL to query your data?

Yes, you should migrate. InfluxDB Cloud backed by InfluxDB IOx lets you query your time series data with SQL. For more information about querying your data with SQL, see:

Do you depend on a specific cloud provider or region?

You should maybe migrate. InfluxDB Cloud instances backed by InfluxDB IOx are available from the following providers:

  • Amazon Web Services (AWS)
    • US East (Virginia)
    • EU Frankfurt

If your deployment requires other cloud providers or regions, you may need to wait until the IOx storage engine is available in a region that meets your requirements. We are currently working to make InfluxDB IOx available on more providers and in more regions around the world.

Are you reliant on Flux queries and Flux tasks?

You should maybe migrate. Flux queries are less performant against the IOx storage engine. Flux is optimized to work with the TSM storage engine, but these optimizations do not apply to the on-disk structure of InfluxDB IOx.

To maintain performant Flux queries against the IOx storage engine, you need to update Flux queries to use a mixture of both SQL and Flux—SQL to query the base dataset and Flux to perform other transformations that SQL does not support. For information about using SQL and Flux together for performant queries, see Use Flux and SQL to query data.


Data migration guides


Was this page helpful?

Thank you for your feedback!


Linux Package Signing Key Rotation

All signed InfluxData Linux packages have been resigned with an updated key. If using Linux, you may need to update your package configuration to continue to download and verify InfluxData software packages.

For more information, see the Linux Package Signing Key Rotation blog post.

InfluxDB Cloud backed by InfluxDB IOx

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by IOx, this is the correct documentation.

If powered by TSM, see the TSM-based InfluxDB Cloud documentation.

InfluxDB Cloud backed by InfluxDB TSM

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine which enables nearly unlimited series cardinality and SQL query support. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by TSM, this is the correct documentation.

If powered by IOx, see the IOx-based InfluxDB Cloud documentation.

State of the InfluxDB Cloud (IOx) documentation

The new documentation for InfluxDB Cloud backed by InfluxDB IOx is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.