本文及后续所有文章都以 21.7.3.14-2 做为版本讲解和入门学习

整形

固定长度的整型，包括 有符号 (+-) 整型或 无符号 (+) 整型。范围就是 -2^(n-1)~2 (n-1)-1，n 代表 位。
Int8 [-128 : 127] = byte(1) = 8bit
Int16 [-32768 : 32767] = short(2) = 16bit
Int32 [-2147483648 : 2147483648] = int(4) = 32bit
Int64 [-9223372036854775808 : 9223372036854775807] = long(8) = 64bit

无符号的整形范围是 0~2^(n-1)
UInt8 [0 : 255]
UInt16 [0 : 65535]
UInt32 [0 : 4294967295]
UInt64 [0 : 18446744073709551615]

浮点型

Float32 = float(4)
Float64 = double(8)

建议尽可能以整数形式存储数据。例如，将固定精度的数字转换为整数值，如时间用毫秒为单位表示，因为浮点型进行计算时可能引起四舍五入的误差。

该类型使用场景：一般数据值比较小，不涉及大量的统计计算，精度要求不高的时候。比如保存商品的重量。

布尔型

没有单独的类型来存储布尔值。可以使用 UInt8 类型，取值限制为 0 或 1。

Decimal 型

有符号的浮点数，可在加、减和乘法运算过程中保持精度。对于除法，最低有效数字会被丢弃（不舍入）。
Decimal32 (s)，相当于 Decimal (9-s,s)，有效位数为 1~9
Decimal64 (s)，相当于 Decimal (18-s,s)，有效位数为 1~18
Decimal128 (s)，相当于 Decimal (38-s,s)，有效位数为 1~38

比如：12345.456223 让保留两位小数，Decimal64 (2) = Decimal (18-2,2) = Decimal (16,2) 小数点前保留 16 位，小数点后保留 2 位，12345.45。

s 标识小数位，该类型使用场景： 一般金额字段、汇率、利率等字段为了保证小数点精度，都使用 Decimal 进行存储。

字符串

String

字符串可以任意长度的。它可以包含任意的字节集，包含空字节。

FixedString(N)

固定长度 N 的字符串，N 必须是严格的正自然数。当服务端读取长度小于 N 的字符串时候，通过在字符串末尾添加空字节来达到 N 字节长度。 当服务端读取长度大于 N 的字符串时候，将返回错误消息。

与 String 相比，极少会使用 FixedString，因为使用起来不是很方便。

该类型使用场景：名称、文字描述、字符型编码。 固定长度的可以保存一些定长的内容，比如一些编码，性别等但是考虑到一的变化风险，带来收益不够明显，所以定长字符串使用意义有限。

枚举类型

包括 Enum8 和 Enum16 类型。Enum 保存'string'= integer 的对应关系。
Enum8 用 'String'= Int8 对描述。
Enum16 用 'String'= Int16 对描述。

例如：创建一个带有一个枚举 Enum8 ('hello' = 1, 'world' = 2) 类型的列，并插入数据

# 创建表
CREATE TABLE t_enum (
    x Enum8('hello' = 1, 'world' = 2)
) ENGINE = TinyLog;
# 插入数据
INSERT INTO t_enum VALUES ('hello'), ('world'), ('hello');

这个 x 列只能存储类型定义中列出的值：'hello' 或 'world'，如果尝试保存任何其他值，ClickHouse 抛出异常。

 insert into t_enum values('a')

如果需要看到对应行的数值，则必须将 Enum 值转换为整数类型。

 SELECT CAST(x, 'Int8') FROM t_enum;

该类型使用场景：对一些状态、类型的字段算是一种空间优化，也算是一种数据约束。但是实际使用中往往因为一些数据内容的变化增加一定的维护成本，甚至是数据丢失问题。所以谨慎使用。

时间类型

目前 ClickHouse 有三种时间类型

• Date 接受 年 - 月 - 日 的字符串比如 ‘2019-12-16’
• Datetime 接受 年 - 月 - 日 时：分: 秒 的字符串比如 ‘2019-12-16 20:50:10’
• Datetime64 接受 年 - 月 - 日 时：分: 秒。亚秒 的字符串比如‘2019-12-16 20:50:10.66’

日期类型，用两个字节存储，表示从 1970-01-01 (无符号) 到当前的日期值。还有很多数据结构，可以参考官方文档：https://clickhouse.yandex/docs/zh/data_types/

数组

Array (T)：由 T 类型元素组成的数组。
T 可以是任意类型，包含数组类型。 但不推荐使用多维数组，ClickHouse 对多维数组的支持有限。例如，不能在 MergeTree 表中存储多维数组。

第一种创建数组的方式，as x，把数组起一个变量， toTypeName (x) 并打印出 x 变量的类型

 SELECT array(1, 2) AS x, toTypeName(x) ;

第二种创建数组的方式

SELECT \[1, 2\] AS x, toTypeName(x);

注意数字的元素只能是相同类型的，又是数字又是字符的话会报错。

Map

Map (key, value) 数据类型存储 键：值 对，key 键，可以是 字符串、整数、LowCardinality 或 FixedString 类型，value 值，可以是字符串 (String)、整数 (Integer)、数组 (Array)、LowCardinality 或 FixedString 类型。

具体使用

# 创建一个表
CREATE TABLE table_map (a Map(String, UInt64)) ENGINE=Memory;
# 插入数据
INSERT INTO table_map VALUES ({'key1':1, 'key2':10}), ({'key1':2,'key2':20}), ({'key1':3,'key2':30});
# 查询
SELECT a\['key2'\] FROM table_map;
┌─arrayElement(a, 'key2')─┐
│                      10 │
│                      20 │
│                      30 │
└─────────────────────────┘

可以把元组转换为 Map

SELECT CAST((\[1, 2, 3\], \['Ready', 'Steady', 'Go'\]), 'Map(UInt8, String)') AS map;
┌─map───────────────────────────┐
│ {1:'Ready',2:'Steady',3:'Go'} │
└───────────────────────────────┘

可以列出 Map 的所有 key 和 所有 value 值

# 创建表
CREATE TABLE t_map (`a` Map(String, UInt64)) ENGINE = Memory;
# 插入数据
INSERT INTO t_map VALUES (map('key1', 1, 'key2', 2, 'key3', 3));
# 查询所有键
SELECT a.keys FROM t_map;
┌─a.keys─────────────────┐
│ \['key1','key2','key3'\] │
└────────────────────────┘
# 查询所有值
SELECT a.values FROM t_map;
┌─a.values─┐
│ \[1,2,3\]  │
└──────────┘

UUID

通用唯一标识符 (UUID) 是一个 16 字节的数字，用于标识记录。
UUID 类型值的示例如下:

61f0c404-5cb3-11e7-907b-a6006ad3dba0

如果在插入新记录时未指定 UUID 列的值，则 UUID 值将用零填充:

00000000-0000-0000-0000-000000000000

要生成 UUID 值，ClickHouse 提供了 generateuidv4 函数。

具体使用

# 创建一个表
CREATE TABLE t_uuid (x UUID, y String) ENGINE=TinyLog
# 插入数据生产随机UUID
INSERT INTO t_uuid SELECT generateUUIDv4(), 'Example 1'
# 查询
SELECT * FROM t_uuid
┌────────────────────────────────────x─┬─y─────────┐
│ 417ddc5d-e556-4d27-95dd-a34d84e46a50 │ Example 1 │
└──────────────────────────────────────┴───────────┘
# 不插入UUID值
INSERT INTO t_uuid (y) VALUES ('Example 2')
# 查询
SELECT * FROM t_uuid
┌────────────────────────────────────x─┬─y─────────┐
│ 417ddc5d-e556-4d27-95dd-a34d84e46a50 │ Example 1 │
│ 00000000-0000-0000-0000-000000000000 │ Example 2 │
└──────────────────────────────────────┴───────────┘

注意：UUID 数据类型只支持 字符串，该数据类型也支持 min，max，count 函数，但不支持 abs 或聚合函数 (sum，avg) 等。