InfluxDB的命令行接口（influx）是用作HTTP API的交互shell，使用influx命令可以写入数据（手动写入或从文件写入）、交互查询数据、以及以不同格式查看查询输出。
启动influx
如果你从安装包管理工具安装了InfluxDB，那么influx命令（CLI）被安装在了/usr/bin/influx(或者/usr/local/bin/influx OS X系统下)。
使用CLI接口，需要首先启动influxd数据库服务然后在终端中启动influx命令，如果成功启动shell并且连接到了InfluxDB节点，将有如下输出内容：
$ influx
Connected to http://localhost:8086 version 1.4.x
InfluxDB shell 1.4.x
提示: CLI和InfluxDB版本需要一致，否则会导致查询解析错误。
现在你可以在终端中输入influxQL查询语句了，可以使用help命令得到一个可用命令的列表，使用Ctrl+C来中止一个长时间运行的InfluxQL查询。
Influx 参数
influx命令启动时可以指定一些参数，使用$ influx --help可以列出这些参数，如下是这些参数的简要说明，在本部分的最后我们提供了-execute,-format, -import三个参数的详细信息。
-compressed
配合-import命令使用，表示导入文件是被压缩的。
-consistency 'any|one|quorum|all'
设置数据一致性层次
-database 'database name'
连接的数据库名
-execute 'command'
指定执行的命令
-format 'json|csv|column'
指定server端返回的数据格式。 参考format
-host 'host name'
指定连接的host，默认连接的是localhost-import
从文件导入数据或者从文件导入已有的数据库，参考import.
-password 'password'
连接服务器的密码，如果留空(-password '')将会提示输入密码，或者，设置CLI的环境变量INFLUX_PASSWORD
-path
指定导入文件的路径（配合-import使用）。
-port 'port #'
指定连接的端口，默认情况下， InfluxDB使用8086端口。
-pps
配合-import使用，指定每秒允许导入的points数量，默认情况下pps为0不限制导入速度。
-precision 'rfc3339|h|m|s|ms|u|ns'
指定时间戳的格式／精度：rfc3339(格式是YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ)，或者是h(小时)，m（分钟），s（秒），ms（毫秒），u(微秒)，ns（纳秒）。
默认的精度是纳秒。
提示:设置精度为
rfc3339(-precision rfc3339)只 在-execute选项的时候有效, 但是在-import选项的时候无效，所有其他的精度 (例如h,m,s,ms,u, 和ns) 在-execute和-import选项的时候都有效。
-pretty
json数据格式打开pretty显示
-ssl
使用https请求。
-username 'username'
指定连接的用户名，或者设置CLI的环境变量INFLUX_USERNAME-version
显示influx的版本信息并退出。
使用-execute直接执行influxQL命令
执行查询无需指定数据库：
$ influx -execute 'SHOW DATABASES'
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates
执行查询需指定数据库，并且指定时间戳精度：
$ influx -execute 'SELECT * FROM "h2o_feet" LIMIT 3' -database="NOAA_water_database" -precision=rfc3339
name: h2o_feet
--------------
time level description location water_level
2015-08-18T00:00:00Z below 3 feet santa_monica 2.064
2015-08-18T00:00:00Z between 6 and 9 feet coyote_creek 8.12
2015-08-18T00:06:00Z between 6 and 9 feet coyote_creek 8.005
使用-format指定server 端返回的数据格式
默认的数据格式是列式：
$ influx -format=column
[...]
> SHOW DATABASES
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates
使用csv格式：
$ influx -format=csv
[...]
> SHOW DATABASES
name,name
databases,NOAA_water_database
databases,_internal
databases,telegraf
databases,pirates
使用json格式：
$ influx -format=json
[...]
> SHOW DATABASES
{"results":[{"series":[{"name":"databases","columns":["name"],"values":[["NOAA_water_database"],["_internal"],["telegraf"],["pirates"]]}]}]}
使用 json格式并打开-pretty输出选项
$ influx -format=json -pretty
[...]
> SHOW DATABASES
{
"results": [
{
"series": [
{
"name": "databases",
"columns": [
"name"
],
"values": [
[
"NOAA_water_database"
],
[
"_internal"
],
[
"telegraf"
],
[
"pirates"
]
]
}
]
}
]
}
使用-import从文件导入数据
导入文件有两个部分：
- DDL（数据描述语言）：包含创建数据库和管理保留策略的influxQL语句，如果你的数据库和保留策略已经存在，那么导入文件可以省略这部分。
- DML（数据操作语言）：列出数据库、保留策略以及包含的数据（以行协议表示）
例如：
文件（datarrr.txt）
# DDL
CREATE DATABASE pirates
CREATE RETENTION POLICY oneday ON pirates DURATION 1d REPLICATION 1
# DML
# CONTEXT-DATABASE: pirates
# CONTEXT-RETENTION-POLICY: oneday
treasures,captain_id=dread_pirate_roberts value=801 1439856000
treasures,captain_id=flint value=29 1439856000
treasures,captain_id=sparrow value=38 1439856000
treasures,captain_id=tetra value=47 1439856000
treasures,captain_id=crunch value=109 1439858880
导入命令：
$influx -import -path=datarrr.txt -precision=s
导入结果：
2015/12/22 12:25:06 Processed 2 commands
2015/12/22 12:25:06 Processed 5 inserts
2015/12/22 12:25:06 Failed 0 inserts
提示:对于大量的数据集导入，influxdb每10万个point输出一次状态信息，例如
2015/08/21 14:48:01 Processed 3100000 lines. Time elapsed: 56.740578415s. Points per second (PPS): 54634
关于-import参数需要记住的事情：
- 允许使用-pps参数设置每秒钟导入数据的限制，默认情况下pps是0并且不限制导入的速率。
- 导入.gz的文件，只需要在命令中执行-compressed参数
- 在数据文件中需要包含时间戳，如果没有指定时间，influxdb将分配一个相同的时间戳，这将导致意外的数据覆盖行为。
- 如果你的数据文件超过5000条（points），有必要将文件切分成多个来进行批量导入，我们建议分批导入5000-10000个点。更小的导入量和更多的http请求将导致次优性能。默认情况下http请求的超时时间是5秒，influxdb在超时时将会重试但不会确认是否正确写入。
influx 命令
在CLI中输入help可以获取部分可用命令列表。
命令