Documentation

InfluxDB 3 Core

Create a database

InfluxDB 3 Core is in Public Beta

InfluxDB 3 Core is in public beta and available for testing and feedback, but is not meant for production use yet. Both the product and this documentation are works in progress. We welcome and encourage your input about your experience with the beta and invite you to join our public channels for updates and to share feedback.

Beta expectations and recommendations

Use the influxdb3 create database command to create a database in InfluxDB 3 Core. Provide the following:

  • Database name (see Database naming restrictions)

  • InfluxDB 3 Core authorization token

    While in beta, InfluxDB 3 Core does not require an authorization token.

influxdb3 create database 
DATABASE_NAME
  • Copy
  • Fill window

Database naming restrictions

Database names must adhere to the following naming restrictions:

  • Alphanumeric characters
  • Dashes (-), underscores (_), and forward slashes (/) are allowed
  • Must start with a letter or number
  • Maximum length of 64 characters

InfluxQL DBRP naming convention

In InfluxDB 1.x, data is stored in databases and retention policies. In InfluxDB 3 Core, databases and retention policies have been merged into databases; retention policies are no longer part of the data model. Because InfluxQL uses the 1.x data model, to support InfluxQL queries the use databases and retention policies, an InfluxDB 3 Core database must be mapped to a v1 database and retention policy (DBRP) to be queryable with InfluxQL.

When naming a database that you want to query with InfluxQL, use the following naming convention to automatically map v1 DBRP combinations to an InfluxDB 3 Core database:

database_name/retention_policy_name
  • Copy
  • Fill window
Database naming examples
v1 Database namev1 Retention Policy nameNew database name
dbrpdb/rp
telegrafautogentelegraf/autogen
webmetrics1w-downsampledwebmetrics/1w-downsampled

Database limit

Maximum number of databases: 5

For more information about InfluxDB 3 Core database, table, and column limits, see Database, table, and column limits.

Was this page helpful?

Thank you for your feedback!

© 2025 InfluxData, Inc.

What is your InfluxDB 3 Core URL?

Customize your InfluxDB 3 Core URL and we’ll update code examples for you.

Default
Custom

For more information, see InfluxDB Cloud regions or InfluxDB OSS URLs.

Thank you for your feedback!

Let us know what we can do better:

Thank you!

No thanks

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.

Read more

InfluxDB 3 Core and Enterprise are now in Beta

InfluxDB 3 Core and Enterprise are now available for beta testing, available under MIT or Apache 2 license.

InfluxDB 3 Core is a high-speed, recent-data engine that collects and processes data in real-time, while persisting it to local disk or object storage. InfluxDB 3 Enterprise is a commercial product that builds on Core’s foundation, adding high availability, read replicas, enhanced security, and data compaction for faster queries. A free tier of InfluxDB 3 Enterprise will also be available for at-home, non-commercial use for hobbyists to get the full historical time series database set of capabilities.

For more information, check out:

Ask AI