SQL 数据类型

InfluxDB Cloud Serverless使用Apache Arrow DataFusion实现的SQL。 数据类型定义了可以存储在表列中的值的类型。 在InfluxDB的SQL实现中，度量被结构化为一个表， 标签、字段和时间戳被显示为列。

SQL 和 Arrow 数据类型

在SQL中，每个列、表达式和参数都有一个数据类型。 数据类型是一个属性，用于指定对象可以保存的数据类型。 DataFusion使用Arrow类型系统进行查询执行。 所有SQL类型都映射到Arrow数据类型。

SQL和Arrow数据类型在查询执行期间以及在查询结果中返回数据的方式中发挥着重要作用。

SELECT
  '99'::BIGINT,
  '2019-09-18T00:00:00Z'::timestamp

• 字符串类型
• 数值类型
  • 整数
  • 无符号整数
  • 浮点数
• 日期和时间数据类型
  • 时间戳
  • 时间间隔
• 布尔类型
• 不支持的SQL类型
• 与参数兼容的数据类型

字符串类型

示例字符串字面量

'abcdefghijk'
'time'
'h2o_temperature'

数字类型

支持以下数值类型：

整数

InfluxDB SQL支持64位有符号整数：

最小有符号整数: -9223372036854775808 最大有符号整数: 9223372036854775807

示例整数字面量

234
-446
5

无符号整数

InfluxDB SQL 支持 64 位无符号整数：

最小无符号整数: 0 最大无符号整数: 18446744073709551615

示例无符号整数字面量

无符号整数文字由转换为BIGINT UNSIGNED类型的整数组成：

234::BIGINT UNSIGNED
458374893::BIGINT UNSIGNED
5::BIGINT UNSIGNED

浮动数

InfluxDB SQL 支持 64 位双精度浮点值。 浮点数可以是小数点、小数整数或小数分数。

示例浮点字面量

23.8
-446.89
5.00
0.033

日期和时间数据类型

InfluxDB SQL 支持以下日期/时间数据类型：

时间戳

时间类型是使用纳秒精度表示的单个时间点。

支持以下日期和时间格式：

YYYY-MM-DDT00:00:00.000Z
YYYY-MM-DDT00:00:00.000-00:00
YYYY-MM-DD 00:00:00.000-00:00
YYYY-MM-DDT00:00:00Z
YYYY-MM-DD 00:00:00.000
YYYY-MM-DD 00:00:00

示例时间戳字面量

'2023-01-02T03:04:06.000Z'
'2023-01-02T03:04:06.000-00:00'
'2023-01-02 03:04:06.000-00:00'
'2023-01-02T03:04:06Z'
'2023-01-02 03:04:06.000'
'2023-01-02 03:04:06'

时间间隔

INTERVAL 数据类型可以与以下精度一起使用：

• 纳秒
• 微秒
• 毫秒
• 第二
• 分钟
• 小时
• 天
• 周
• 月份
• 年份
• 世纪

示例区间文字

INTERVAL '10 minutes'
INTERVAL '1 year'
INTERVAL '2 days 1 hour 31 minutes'

布尔类型

布尔值存储 TRUE 或 FALSE 值。

布尔字面值示例

true
TRUE
false
FALSE

不支持的SQL类型

以下SQL类型当前不被支持：

• UUID
• 二进制大对象
• CLOB
• 二进制
• 变长二进制
• 注册类
• nvarchar
• 自定义
• 数组
• 枚举
• 设置
• 日期时间
• 字节数组

与参数兼容的数据类型

有关可以由参数替代的数据类型的信息，请参阅如何 使用带参数的SQL查询。