influxdb3 create database
The influxdb3 create database command creates a new database in your InfluxDB 3 Core instance.
Provide a database name and, optionally, specify connection settings and authentication credentials using flags or environment variables.
Usage
influxdb3 create database [OPTIONS] <DATABASE_NAME>
Arguments
DATABASE_NAME: The name of the database to create. Valid database names are alphanumeric and start with a letter or number. Dashes (-) and underscores (_) are allowed.
You can also set the database name using the INFLUXDB3_DATABASE_NAME environment variable.
Options
| Option | Description | |
|---|---|---|
-H | --host | Host URL of the running InfluxDB 3 Core server (default is http://127.0.0.1:8181) |
--retention-period | Database retention period (duration value, for example: 30d, 24h, 1h) | |
--token | Authentication token | |
--tls-ca | Path to a custom TLS certificate authority (for testing or self-signed certificates) | |
-h | --help | Print help information |
--help-all | Print detailed help information |
Option environment variables
You can use the following environment variables instead of providing CLI options directly:
| Environment Variable | Option |
|---|---|
INFLUXDB3_HOST_URL | --host |
INFLUXDB3_AUTH_TOKEN | --token |
Examples
The following examples show how to create a database.
In your commands replace the following:
DATABASE_NAME: Database nameAUTH_TOKEN: Authentication token
Create a database (default)
Creates a database using settings from environment variables and defaults.
influxdb3 create database DATABASE_NAME
Create a database with an authentication token
Creates a database using the specified arguments. Flags override their associated environment variables.
influxdb3 create database --token AUTH_TOKEN DATABASE_NAME
Create a database with a retention period
Creates a database with a specific retention period.
influxdb3 create database --retention-period 30d DATABASE_NAME
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.