Back to Influxdb

Shell

content/shared/influxdb-v2/reference/cli/influx/v1/shell.md

latest2.1 KB
Original Source

The influx v1 shell subcommand starts an InfluxQL shell (REPL).

{{% note %}}

Set up database and retention policy (DBRP) mapping

InfluxQL queries require a database and retention policy to query data. In InfluxDB {{% current-version %}}, databases and retention policies have been combined and replaced with buckets. To use the InfluxQL to query an InfluxDB {{% current-version %}} bucket, first map your DBRP combinations to an appropriate bucket. For more information, see Query data with InfluxQL.

{{% /note %}}

Usage

sh
influx v1 shell [flags]

Flags

FlagDescriptionInput type{{< cli/mapped >}}
-c--active-configConfig name to use for commandstringINFLUX_ACTIVE_CONFIG
--configs-pathPath to the influx CLI configurations (default: ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
--hostHTTP address of InfluxDBstringINFLUX_HOST
--http-debugInspect communication with InfluxDB servers.
-o--orgOrganization name (mutually exclusive with --org-id)stringINFLUX_ORG
--org-idOrganization ID (mutually exclusive with --org)stringINFLUX_ORG_ID
--skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
-t--tokenAPI tokenstringINFLUX_TOKEN

Examples

{{< cli/influx-creds-note >}}

Start an InfluxQL shell
sh
influx v1 shell