FAQ

管理

如何在密码中包含单引号？

在创建密码和发送身份验证请求时使用反斜杠（\）来转义单引号。

如何查看InfluxDB的版本？

有几种方法可以查看InfluxDB的版本：

在终端运行influxd version:

  1. $ influxd version
  3. InfluxDB ✨ v1.3.0 ✨ (git: master b7bb7e8359642b6e071735b50ae41f5eb343fd42)

curl路径/ping：

  1. $ curl -i 'http://localhost:8086/ping'
  3. HTTP/1.1 204 No Content
  4. Content-Type: application/json
  5. Request-Id: 1e08aeb6-fec0-11e6-8486-000000000000
  6. ✨ X-Influxdb-Version: 1.3.x ✨
  7. Date: Wed, 01 Mar 2017 20:46:17 GMT

运行InfluxDB的命令行：

  1. $ influx
  3. Connected to http://localhost:8086✨ version 1.3.x ✨  
  4. InfluxDB shell version: 1.3.x

在日志里查看HTTP返回结果：

  1. $ journald-ctl -u influxdb.service
  3. Mar 01 20:49:45 rk-api influxd[29560]: [httpd] 127.0.0.1 - - [01/Mar/2017:20:49:45 +0000] "POST /query?db=&epoch=ns&q=SHOW+DATABASES HTTP/1.1" 200 151 "-" ✨ "InfluxDBShell/1.3.x" ✨ 9a4371a1-fec0-11e6-84b6-000000000000 1709

怎样查看InfluxDB的日志？

在System V操作系统上，日志存储在/var/log/influxdb/下。在systemd操作系统上，可以使用journalctl访问日志。 使用journalctl -u influxdb查看日志或journalctl -u influxdb> influxd.log将日志打印到文本文件。使用systemd时，日志保留取决于系统的日记设置。

分片组的保留时间和保留策略之间的关系？

nfluxDB将数据存储在分片组中。一个分片组覆盖特定的时间间隔; InfluxDB通过查看相关保留策略（RP）的DURATION来确定时间间隔。下表列出了RP的DURATION和分片组的时间间隔之间的默认关系：

RP持续时间 分片组间隔
<2天 1小时
>= 2天，<= 6个月 1天
> 6个月 7天

用户还可以使用CREATE RETENTION POLICY和ALTER RETENTION POLICY语句配置分片组持续时间。使用SHOW RETENTION POLICY语句检查保留策略的分片组持续时间。

为什么在修改了RP之后数据没有被删除？

有几个因素可以解释为什么保留策略（RP）更改后数据可能不会立即丢失。

第一个也是最可能的原因是，默认情况下，InfluxDB每30分钟检查一次强制RP。可能需要等待下一次RP检查InfluxDB才能删除RP的新DURATION设置之外的数据。30分钟的间隔是可配置的。

其次，改变RP的DURATION和SHARD DURATION可能会导致意外的数据保留。InfluxDB将数据存储在包含特定RP和时间间隔的分片组中。当InfluxDB执行一个RP时，它会删除整个分片组，而不是单个数据点。InfluxDB不能拆分分片组。

如果RP的新DURATION小于旧的SHARD DURATION，并且InfluxDB正在将数据写入其中一个较旧的分片组，则系统将被迫将所有数据保留在该分片组中。即使该分片组中的某些数据不在新的DURATION中，也会发生这种情况。一旦所有的数据都在新的DURATION之外，InfluxDB将删除该分片组。系统将开始将数据写入新的分片组，这些分片组具有新的更短的SHARD DURATION，以防止写入不被期望的数据。

为什么InfluxDB无法在配置文件中解析微秒单位？

用于指定微秒持续时间单位的语法在配置设置，和写入，查询以及在InfluxDB命令行界面（CLI）中设置精度方面有所不同。 下表显示了每个类别支持的语法：

单位 配置文件 HTTP API写入 所有的查询 CLI精度命令行
u ❌ 👍 👍 👍
us 👍 ❌ ❌ ❌
µ ❌ ❌ 👍 ❌
µs 👍 ❌ ❌ ❌

如果配置选项指定u或μ语法，InfluxDB将无法启动并在日志中报告以下错误：

  1. run: parse config: time: unknown unit [µ|u] in duration [<integer>µ|<integer>u]

命令行

怎么让InfluxDB的CLI返回用户可读的时间戳?

当你第一次连CLI，可以指定rfc3339精度：

  1. $ influx -precision rfc3339

此外，如果你已经连接了CLI，则可以通过指令来指定：

  1. $ influx
  2. Connected to http://localhost:8086 version 0.xx.x
  3. InfluxDB shell 0.xx.x
  4. > precision rfc3339
  5. >

一个非admin用户怎么在InfluxDB的CLI下USE一个数据库？

在v1.3之前的版本中，非admin用户是不能在CLI执行USE <database_name>的查询的，即使拥有这个数据库的READ或/和Write权限。

从1.3开始，非admin用户也可以执行USE <database_name>的查询只要拥有这个数据库的READ或/和Write权限。如果非admin使用USE一个数据库，但是没有权限时，系统会返回一个错误：

  1. ERR: Database <database_name> doesn't exist. Run SHOW DATABASES for a list of existing databases.

注意：非admin用户执行SHOW DATABASES，只返回有权限的数据库。

在InfluxDB的CLI下，如何写入一个非默认的retention policy？

使用语法INSERT INTO [<database>.]<retention_policy> <line_protocol>可以在CLI下把数据写入非DEFAULT的retention policy里面。（如果使用HTTP来写入数据的话，可以通过参数db和rp来指定数据库和retention policy）。

例如：

  1. > INSERT INTO one_day mortality bool=true
  2. Using retention policy one_day
  3. > SELECT * FROM "mydb"."one_day"."mortality"
  4. name: mortality
  5. ---------------
  6. time                             bool
  7. 2016-09-13T22:29:43.229530864Z   true

注意如果要查询出非DEFAULT的retention policy，需要指定完整的measurement路径：

  1. "<database>"."<retention_policy>"."<measurement>"

怎么取消一个长期运行的查询？

在CLI下，你可以用Ctrl+C来取消执行的查询。对于其他的长时间运行的查询，你可以先使用SHOW QUERIES列出来，然后使用KILL QUERY来停止对应的查询。

为什么不能查询布尔型的field value？

对于写和读，接受布尔型的数据的语法不一样。

布尔语法 写 读
t,f 👍 ❌
T,F 👍 ❌
true,false 👍 👍
True,False 👍 👍
TRUE,FALSE 👍 👍

例如，SELECT * FROM "hamlet" WHERE "bool"=True返回所有bool的值为TRUE的，但是SELECT * FROM "hamlet" WHERE "bool"=T什么都不会返回。Github Issue #3939

InfluxDB怎么处理不同shard里面的字段类型冲突？

字段的值类型可以是浮点，整数，字符串和布尔型。字段的类型在同一个shard里面是一致的，但是在不同的shard里面可以不一样。

SELECT语句

如果所有值都具有相同的类型，SELECT语句会返回所有字段值。如果字段的值类型在不同的shard里面不一样，InfluxDB首先执行正常操作并将所有值返回为出现在下面的列表的第一个类型：浮点，整数，字符串和布尔型。

如果你的数据字段的值类型不符，使用语法<field_key>::<type>查询不同的数据类型。

例子

measurementjust_my_type有一个字段叫作my_field。my_field在四个不同shard里面有四个不同的类型分别为（浮点，整数，字符串和布尔型）。

SELECT*只返回浮点数和整数字段值。注意InfluxDB在返回时把整数转化为了浮点类型。

  1. SELECT * FROM just_my_type
  3. name: just_my_type
  4. ------------------
  5. time                            my_field
  6. 2016-06-03T15:45:00Z      9.87034
  7. 2016-06-03T16:45:00Z      7

SELECT<field_key>::<type>[…]返回所有值类型。我们可以在InfluxDB列名里增加自己的列输出的值类型。在可能的情况下，InfluxDB字段值会转到另一个类型；它把整数7在第一列中转化为了浮点数，而且把9.879034在第二列中转化为了整数。InfluxDB不能把浮点或整数转化为字符串或布尔值。

  1. SELECT "my_field"::float,"my_field"::integer,"my_field"::string,"my_field"::boolean FROM just_my_type
  3. name: just_my_type
  4. ------------------
  5. time                           my_field     my_field_1     my_field_2         my_field_3
  6. 2016-06-03T15:45:00Z     9.87034      9
  7. 2016-06-03T16:45:00Z     7            7
  8. 2016-06-03T17:45:00Z                                 a string
  9. 2016-06-03T18:45:00Z                                                    true

SHOW FIELD KEYS查询

SHOW FIELD KEYS会返回相关field在不同的shard里面的每种类型。

measurementjust_my_type有一个字段叫作my_field。my_field在四个不同shard里面有四个不同的类型分别为（浮点，整数，字符串和布尔型）。SHOW FIELD KEYS返回所有四种数据类型：

  1. > SHOW FIELD KEYS
  3. name: just_my_type
  4. fieldKey   fieldType
  5. --------   ---------
  6. my_field   float
  7. my_field   string
  8. my_field   integer
  9. my_field   boolean

InfluxDB可以存储的最大最小整数是什么？