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:
- Length: Maximum 64 characters
- Allowed characters: Alphanumeric characters (a-z, A-Z, 0-9), underscore (
_
), dash (-
), and forward-slash (/
) - Prohibited characters: Cannot contain whitespace, punctuation, or other special characters
- Starting character: Should start with a letter or number and should not start with underscore (
_
) - Case sensitivity: Database names are case-sensitive
Underscore prefix reserved for system use
Names starting with an underscore (_
) may be reserved for InfluxDB system use.
While InfluxDB 3 Core might not explicitly reject these names, using them risks
conflicts with current or future system features and may result in
unexpected behavior or data loss.
Valid database name examples
mydb
sensor_data
prod-metrics
logs/application
webserver123
Invalid database name examples
my database # Contains whitespace
sensor.data # Contains period
app@server # Contains special character
_internal # Starts with underscore (reserved)
very_long_database_name_that_exceeds_sixty_four_character_limit # Too long
For comprehensive information about naming restrictions for all InfluxDB identifiers, see Naming restrictions and conventions.
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, where databases have a retention period, but retention policies are no longer part of the data model. Because InfluxQL uses the 1.x data model, a 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.