--- title: influxdb3 import upload description: The influxdb3 import upload command uploads one or more Parquet files into an InfluxDB 3 Enterprise database and table. url: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/import/upload/ estimated_tokens: 1777 product: InfluxDB 3 Enterprise version: enterprise publisher: InfluxData canonical: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/import/upload/ date: '2026-07-08T14:40:21+00:00' lastmod: '2026-07-08T14:40:21+00:00' --- The `influxdb3 import upload` command uploads one or more Parquet files into an existing InfluxDB 3 Enterprise database and table. Each file becomes a separate import job. Imported data is written to your object storage and becomes queryable after the compactor processes it. ## Usage ```bash influxdb3 import upload [OPTIONS] [PATH] ``` ## Arguments |Argument| Description | |--------|----------------------------------------------------------------------------------------------------------------------------------------------| |`[PATH]`|Path to a Parquet file or a directory. If a directory, all `*.parquet` files are processed recursively and one import job is created per file.| ## Options |Option| | Description | Default | Environment variable | |------|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|-------------------------| | | `--host ` | Host URL of the InfluxDB 3 Enterprise server |`http://127.0.0.1:8181`| `INFLUXDB3_HOST_URL` | | |`--token ` | Authentication token | | `INFLUXDB3_AUTH_TOKEN` | | |`--database `| Target database name | |`INFLUXDB3_DATABASE_NAME`| | | `--table ` | Target table name | | | | | `--column ` |Map a Parquet column to an InfluxDB type: `:`. Supported types: `i64`, `u64`, `f64`, `bool`, `string`, `time`, `tag`. Can be specified multiple times. Unmapped columns default to field values.| | | | | `--tls-ca ` | Path to a custom TLS certificate authority | | `INFLUXDB3_TLS_CA` | | | `--tls-no-verify` | Disable TLS certificate verification (not recommended in production) | |`INFLUXDB3_TLS_NO_VERIFY`| | `-h` | `--help` | Print help information | | | | | `--help-all` | Print detailed help information | | | ## Column type mapping The `--column` option maps Parquet columns to InfluxDB data types. Specify the option multiple times to map multiple columns. Unmapped columns default to field values. | Type | Description | |--------|-----------------------------| | `i64` | Signed 64-bit integer field | | `u64` |Unsigned 64-bit integer field| | `f64` | 64-bit float field | | `bool` | Boolean field | |`string`| String field | | `time` | Timestamp column | | `tag` | Tag column | ## Examples In the examples below, replace the following: * `DATABASE_NAME`: the name of the target database * `TABLE_NAME`: the name of the target table * `AUTH_TOKEN`: your authentication token ### Upload a single Parquet file ```bash influxdb3 import upload \ --host http://localhost:8181 \ --token AUTH_TOKEN \ --database DATABASE_NAME \ --table TABLE_NAME \ /path/to/data.parquet ``` ### Upload all Parquet files in a directory ```bash influxdb3 import upload \ --host http://localhost:8181 \ --token AUTH_TOKEN \ --database DATABASE_NAME \ --table TABLE_NAME \ /path/to/parquet-directory/ ``` ### Upload with column type mapping ```bash influxdb3 import upload \ --host http://localhost:8181 \ --token AUTH_TOKEN \ --database DATABASE_NAME \ --table TABLE_NAME \ --column timestamp:time \ --column host:tag \ --column cpu_usage:f64 \ /path/to/metrics.parquet ``` #### Related * [Import data](/influxdb3/enterprise/admin/import-data/) | Argument | Description | | --- | --- | | Argument | Description | | [PATH] | Path to a Parquet file or a directory. If a directory, all *.parquet files are processed recursively and one import job is created per file. | | Option | | Description | Default | Environment variable | | --- | --- | --- | --- | --- | | Option | | Description | Default | Environment variable | | | --host | Host URL of the InfluxDB 3 Enterprise server | http://127.0.0.1:8181 | INFLUXDB3_HOST_URL | | | --token | Authentication token | | INFLUXDB3_AUTH_TOKEN | | | --database | Target database name | | INFLUXDB3_DATABASE_NAME | | | --table
| Target table name | | | | | --column | Map a Parquet column to an InfluxDB type: : . Supported types: i64 , u64 , f64 , bool , string , time , tag . Can be specified multiple times. Unmapped columns default to field values. | | | | | --tls-ca | Path to a custom TLS certificate authority | | INFLUXDB3_TLS_CA | | | --tls-no-verify | Disable TLS certificate verification (not recommended in production) | | INFLUXDB3_TLS_NO_VERIFY | | -h | --help | Print help information | | | | | --help-all | Print detailed help information | | | | Type | Description | | --- | --- | | Type | Description | | i64 | Signed 64-bit integer field | | u64 | Unsigned 64-bit integer field | | f64 | 64-bit float field | | bool | Boolean field | | string | String field | | time | Timestamp column | | tag | Tag column |