Documentation

Migrate data to InfluxDB Clustered

Limited availability

InfluxDB Clustered is currently only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Migrate data to InfluxDB Clustered powered by InfluxDB v3 from other InfluxDB instances powered by TSM including InfluxDB OSS 1.x, 2.x, InfluxDB Enterprise, and InfluxDB Cloud (TSM).

Should you migrate?

There are important things to consider with migrating to InfluxDB Clustered. 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 InfluxDB v3 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 Clustered lets you query your time series data with SQL. For more information about querying your data with SQL, see:

Do you want better InfluxQL performance?

Yes, you should migrate. One of the primary goals when designing the InfluxDB v3 storage engine was to enable performant implementations of both SQL and InfluxQL. When compared to querying InfluxDB powered by TSM (InfluxDB OSS 1.x, 2.x, and Enterprise), InfluxQL queries are more performant when querying InfluxDB powered by InfluxDB v3.

Are you reliant on Flux queries and Flux tasks?

You should not migrate. InfluxDB Clustered doesn’t support Flux.


Before you migrate

Before you migrate from InfluxDB 1.x or 2.x to InfluxDB Clustered, there are schema design practices supported by the TSM storage engine that are not supported in the InfluxDB v3 storage engine. Specifically, InfluxDB v3 enforces the following schema restrictions:

  • You can’t use duplicate names for tags and fields
  • By default, measurements can contain up to 250 columns where each column represents time, a field, or a tag.

For more information, see Schema restrictions.

If your schema does not adhere to these restrictions, you must update your schema before migrating to InfluxDB Clustered.


Data migration guides


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: