数值类型

TiDB 支持 MySQL 所有的数值类型,按照精度可以分为:

整数类型

TiDB 支持 MySQL 所有的整数类型,包括 INTEGER/INTTINYINTSMALLINTMEDIUMINT 以及 BIGINT,完整信息参考这篇文档。

字段说明:

语法元素说明
M类型显示宽度,可选
UNSIGNED无符号数,如果不加这个标识,则为有符号数
ZEROFILL补零标识,如果有这个标识,TiDB 会自动给类型增加 UNSIGNED 标识,但是没有做补零的操作

类型定义

BIT 类型

比特值类型。M 表示比特位的长度,取值范围从 1 到 64,其默认值是 1。

  1. BIT[(M)]

BOOLEAN 类型

布尔类型,别名为 BOOL,和 TINYINT(1) 等价。零值被认为是 False,非零值认为是 True。在 TiDB 内部,True 存储为 1False 存储为 0

  1. BOOLEAN

TINYINT 类型

TINYINT 类型。有符号数的范围是 [-128, 127]。无符号数的范围是 [0, 255]

  1. TINYINT[(M)] [UNSIGNED] [ZEROFILL]

SMALLINT 类型

SMALLINT 类型。有符号数的范围是 [-32768, 32767]。无符号数的范围是 [0, 65535]

  1. SMALLINT[(M)] [UNSIGNED] [ZEROFILL]

MEDIUMINT 类型

MEDIUMINT 类型。有符号数的范围是 [-8388608, 8388607]。无符号数的范围是 [0, 16777215]

  1. MEDIUMINT[(M)] [UNSIGNED] [ZEROFILL]

INTEGER 类型

INTEGER 类型,别名 INT。有符号数的范围是 [-2147483648, 2147483647]。无符号数的范围是 [0, 4294967295]

  1. INT[(M)] [UNSIGNED] [ZEROFILL]

或者:

  1. INTEGER[(M)] [UNSIGNED] [ZEROFILL]

BIGINT 类型

BIGINT 类型。有符号数的范围是 [-9223372036854775808, 9223372036854775807]。无符号数的范围是 [0, 18446744073709551615]

  1. BIGINT[(M)] [UNSIGNED] [ZEROFILL]

存储空间以及取值范围

每种类型对存储空间的需求以及最大/最小值如下表所示:

类型存储空间最小值(有符号/无符号)最大值(有符号/无符号)
TINYINT1-128 / 0127 / 255
SMALLINT2-32768 / 032767 / 65535
MEDIUMINT3-8388608 / 08388607 / 16777215
INT4-2147483648 / 02147483647 / 4294967295
BIGINT8-9223372036854775808 / 09223372036854775807 / 18446744073709551615

浮点类型

TiDB 支持 MySQL 所有的浮点类型,包括 FLOATDOUBLE,完整信息参考这篇文档。

字段说明:

语法元素说明
M小数总位数
D小数点后位数
UNSIGNED无符号数,如果不加这个标识,则为有符号数
ZEROFILL补零标识,如果有这个标识,TiDB 会自动给类型增加 UNSIGNED 标识

类型定义

FLOAT 类型

单精度浮点数。允许的值范围为 -2^128 ~ +2^128,也即 -3.402823466E+38 到 -1.175494351E-38、0 和 1.175494351E-38 到 3.402823466E+38。这些是基于 IEEE 标准的理论限制。实际的范围根据硬件或操作系统的不同可能稍微小些。

FLOAT(p) 类型中,p 表示精度(以位数表示)。只使用该值来确定是否结果列的数据类型为 FLOATDOUBLE。如果 p 为从 0 到 24,数据类型变为没有 M 或 D 值的 FLOAT。如果 p 为从 25 到 53,数据类型变为没有 M 或 D 值的 DOUBLE。结果列范围与本节前面描述的单精度 FLOAT 或双精度 DOUBLE 数据类型相同。

  1. FLOAT[(M,D)] [UNSIGNED] [ZEROFILL]
  2. FLOAT(p) [UNSIGNED] [ZEROFILL]

数值类型 - 图1

注意

  • 与在 MySQL 中一样,FLOAT 数据类型用于存储近似值。对于类似货币的精确值,建议使用 DECIMAL 类型。
  • 在 TiDB 中,FLOAT 数据类型默认的精度是 8 位,这与 MySQL 不同。在 MySQL 中,FLOAT 数据类型默认的精度是 6 位。例如,同时往 MySQL 和 TiDB 中类型为 FLOAT 的列中插入数据 1234567891.23456789。在 MySQL 中查询对应的值,将会得到结果 1234570001.23457。而在 TiDB 中查询对应的值,将会得到 1234567901.2345679

DOUBLE 类型

双精度浮点数,别名为 DOUBLE PRECISION。允许的值范围为:-2^1024 ~ +2^1024,也即是 -1.7976931348623157E+308 到 -2.2250738585072014E-308、0 和 2.2250738585072014E-308 到 1.7976931348623157E+308。这些是基于 IEEE 标准的理论限制。实际的范围根据硬件或操作系统的不同可能稍微小些。

  1. DOUBLE[(M,D)] [UNSIGNED] [ZEROFILL]
  2. DOUBLE PRECISION [(M,D)] [UNSIGNED] [ZEROFILL], REAL[(M,D)] [UNSIGNED] [ZEROFILL]

数值类型 - 图2

警告

与在 MySQL 中一样,DOUBLE 数据类型存储近似值。对于货币之类的精确值,建议使用 DECIMAL 类型。

数值类型 - 图3

注意

当 TiDB 将用科学计数法表示的双精度浮点数转换到 CHAR 类型时,其结果在显示上与 MySQL 不一致,详情参见 Cast 函数和操作符

存储空间

每种类型对存储空间的需求如下表所示:

类型存储空间
FLOAT4
FLOAT(p)如果 0 <= p <= 24 为 4 个字节,如果 25 <= p <= 53 为 8 个字节
DOUBLE8

定点类型

TiDB 支持 MySQL 所有的定点类型,包括 DECIMALNUMERIC,完整信息参考这篇文档。

字段说明:

语法元素说明
M小数总位数
D小数点后位数
UNSIGNED无符号数,如果不加这个标识,则为有符号数
ZEROFILL补零标识,如果有这个标识,TiDB 会自动给类型增加 UNSIGNED 标识

类型定义

DECIMAL 类型

定点数,别名为 NUMERIC。M 是小数位数(精度)的总数,D 是小数点(标度)后面的位数。小数点和 -(负数)符号不包括在 M 中。如果 D 是 0,则值没有小数点或分数部分。如果 D 被省略,默认是 0。如果 M 被省略,默认是 10。

  1. DECIMAL[(M[,D])] [UNSIGNED] [ZEROFILL]
  2. NUMERIC[(M[,D])] [UNSIGNED] [ZEROFILL]