故障排除 InfluxQL 错误

了解如何故障排除和修复常见的 InfluxQL 错误。

• 错误：需要数据库名称
• 解析查询错误：在 … 找到 …，期望标识符在 …
• 解析查询错误：不支持混合聚合和非聚合查询
• 无效操作：时间和 *influxql.VarRef 不兼容

错误：需要数据库名称

error: database name required

原因

当某些 SHOW 查询 未在查询或查询请求中指定 数据库 时，会发生 database name required 错误。

例如，以下 SHOW 查询未指定数据库，并假设在 /query API 请求中未指定 db

SHOW MEASUREMENTS

解决方案

要解决此错误，可以通过以下方式之一在查询请求中指定数据库：

• 在 SHOW 语句中包含一个 ON 子句，指定要查询的数据库

  SHOW MEASUREMENTS ON 
  DATABASE_NAME
  

• 如果使用 InfluxDB v1 查询 API，在请求中包含 db 查询参数

  curl --get https://cluster-host.com/query \
    --header "Authorization: Bearer 
  DATABASE_TOKEN
  " \
    --data-urlencode "db=
  DATABASE_NAME
  " \
    --data-urlencode "q=SHOW MEASUREMENTS"
  

相关： InfluxQL SHOW 语句，使用 InfluxQL 探索模式

解析查询错误：在 … 找到 …，期望标识符在 …

error parsing query: found EXAMPLE, expected identifier at line 1, char 14

原因

当 InfluxDB 预期查询中存在一个标识符但未找到时，会引发此错误。标识符是引用数据库名称、保留策略名称、度量名称、字段键和标签键的标记。

此错误通常由以下原因之一引起

• 缺少所需的标识符
• 使用字符串字面量而不是标识符
• 将 InfluxQL 关键字用作未引用的标识符

缺少所需的标识符

某些 InfluxQL 语句和子句需要标识符来识别数据库、度量、标签或字段。如果语句缺少所需的标识符，则查询将返回 expected identifier 错误。

例如，以下查询省略了 FROM 子句中的度量名称

SELECT * FROM WHERE color = 'blue'

解决方案

更新查询以在 FROM 子句中包含预期的标识符，以标识要查询的度量

SELECT * FROM measurement_name WHERE color = 'blue'

使用字符串字面量而不是标识符

InfluxQL 中，字符串字面量用单引号（''）括起来，而字符序列用双引号（""）括起来时被视为标识符。如果您使用单引号来括起来标识符，则标识符将被解析为字符串字面量，并返回 expected identifier 错误。

例如，以下查询将度量名称用单引号括起来

SELECT * FROM 'measurement-name' WHERE color = 'blue'

导致以下错误

error parsing query: found measurement-name, expected identifier at line 1, char 14

解决方案

将单引号标识符更新为使用双引号，以便它们被解析为标识符而不是字符串字面量。

SELECT * FROM "measurement-name" WHERE color = 'blue'

将 InfluxQL 关键字用作未引用的标识符

InfluxQL 关键字 是保留在 InfluxQL 语法中用于特定功能的字符序列。可以使用关键字作为标识符，但标识符必须用双引号（""）括起来。

SELECT duration FROM runs

返回以下错误

error parsing query: found DURATION, expected identifier, string, number, bool at line 1, char 8

解决方案

当用作标识符时，双引号 InfluxQL 关键字

SELECT "duration" FROM runs

相关： InfluxQL 关键字，查询语言文档

解析查询错误：不支持混合聚合和非聚合查询

error parsing query: mixing aggregate and non-aggregate queries is not supported

原因

当 SELECT 语句包含一个 聚合函数 和一个独立的 字段键 或 标签键 时，会发生 mixing aggregate and non-aggregate 错误。

聚合函数为每个组和列返回一个计算值，并且没有明显的单个值可以返回给任何未聚合的字段或标签。

例如，以下示例查询从 home 度量查询两个字段–temp 和 hum。但是，它只将聚合函数 MEAN 应用于 temp 字段。

SELECT MEAN(temp), hum FROM home

解决方案

为了修复此错误，将聚合或选择函数应用于查询的每个字段

SELECT MEAN(temp), MAX(hum) FROM home

相关： InfluxQL 函数，使用 InfluxQL 聚合数据

无效操作：时间和 *influxql.VarRef 不兼容

invalid operation: time and *influxql.VarRef are not compatible

原因

当查询中的日期时间字符串使用双引号括起来时，会发生 time and *influxql.VarRef are not compatible 错误。日期时间字符串应格式化为字符串字面量，并用单引号（''）括起来。

例如

SELECT temp
FROM home
WHERE
  time >= "2022-01-01T08:00:00Z"
  AND time <= "2022-01-01T00:20:00Z"

返回以下错误

invalid operation: time and *influxql.VarRef are not compatible

解决方案

要修复错误，请将 RFC3339 时间戳用单引号括起来而不是双引号。

SELECT temp
FROM home
WHERE
  time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T00:20:00Z'

相关： 在时间范围内查询数据，WHERE 子句–时间范围，InfluxQL 时间语法