Create a database
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 admin token
influxdb3 create database DATABASE_NAME
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
Database naming examples
| v1 Database name | v1 Retention Policy name | New database name |
|---|---|---|
| db | rp | db/rp |
| telegraf | autogen | telegraf/autogen |
| webmetrics | 1w-downsampled | webmetrics/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!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Core and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.