tencent cloud

文档反馈

ClickHouse SQL 语法参考

最后更新时间:2024-01-19 16:45:30

    数据类型

    ClickHouse 支持整数、浮点数、字符型、日期、枚举值、数组等多种数据类型。

    类型列表

    类别
    名称
    类型标识
    数据范围或描述
    整数
    单字节整数
    Int8
    [-128,127]
    双字节整数
    Int16
    [-32768,32767]
    四字节整数
    Int32
    [-2147483648,2147483647]
    八字节整数
    Int64
    [-9223372036854775808,9223372036854775807]
    无符号单字节整数
    UInt8
    [ 0,255]
    无符号双字节整数
    UInt16
    [ 0,65535]
    无符号四字节整数
    UInt32
    [ 0,4294967295]
    无符号八字节整数
    UInt64
    [ 0,18446744073709551615]
    浮点数
    单精度浮点数
    Float32
    浮点数有效数字6 - 7位
    双精度浮点数
    Float64
    浮点数有效数字15 - 16位
    自定义浮点
    Decimal32(S)
    浮点数有效数字 S,S 取值范围[1,9]
    Decimal64(S)
    浮点数有效数字 S,S 取值范围[10,18]
    Decimal128(S)
    浮点数有效数字 S,S 取值范围[19,38]
    字符型
    任意长度字符
    String
    不限定字符串长度
    固定长度字符
    FixedString(N)
    固定长度的字符串
    唯一标识 UUID 类型
    UUID
    通过内置函数 generateUUIDv4 生成唯一的标志符
    时间类型
    日期类型
    Date
    存储年月日时间,格式 yyyy-MM-dd
    时间戳类型(秒级)
    DateTime(timezone)
    Unix 时间戳,精确到秒
    时间戳类型(自定义)
    DateTime(precision, timezone)
    可以指定时间精度
    枚举类型
    单字节枚举
    Enum8
    取值范围为[-128,127],共256个值
    双字节枚举
    Enum16
    取值范围为[-32768,32767],共65536个值
    数组类型
    数组类型
    Array(T)
    表示由 T 类型组成的数组类型,不推荐使用嵌套数组
    
    说明:
    
    可以使用 UInt8 来存储布尔类型,将取值限制为0或1。

    使用举例

    枚举类型应用

    存储某站点用户的性别信息。
    CREATE TABLE user (uid Int16, name String, gender Enum('male'=1, 'female'=2)) ENGINE=Memory;
    INSERT INTO user VALUES (1, 'Gary', 'male'), (2, 'Jaco', 'female');
    # 查询数据SELECT * FROM user;
    
    ┌─uid─┬─name─┬─gender─┐
    1 │ Gary │ male │
    2 │ Jaco │ female │
    └─────┴──────┴────────┘
    # 使用CAST函数查询枚举整数值SELECT uid, name, CAST(gender, 'Int8') FROM user;
    
    ┌─uid─┬─name─┬─CAST(gender, 'Int8')─┐
    1 │ Gary │ 1
    2 │ Jaco │ 2
    └─────┴──────┴──────────────────────┘

    数组类型应用

    某站点记录每天登录用户的 ID,用来分析活跃用户。
    CREATE TABLE userloginlog (logindate Date, uids Array(String)) ENGINE=TinyLog;
    INSERT INTO userloginlog VALUES ('2020-01-02', ['Gary', 'Jaco']), ('2020-02-03', ['Jaco', 'Sammie']);
    # 查询结果SELECT * FROM userloginlog;
    
    ┌──logindate─┬─uids──────────────┐
    2020-01-02 │ ['Gary','Jaco']
    2020-02-03 │ ['Jaco','Sammie']
    └────────────┴───────────────────┘

    创建数据库或表

    ClickHouse 使用 CREATE 语句来完成数据库或表的创建。
    CREATE DATABASE [IF NOT EXISTS] db_name [ON CLUSTER cluster] [ENGINE = engine(...)]
    CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
    (
    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1] [compression_codec] [TTL expr1],
    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2] [compression_codec] [TTL expr2],
    ...
    ) ENGINE = engine
    数据库和表都支持本地和分布式两种,分布式方式的创建有以下两种方法:
    在每台 clickhouse-server 所在机器上都执行创建语句。
    在集群的任意一个机器上使用 ON CLUSTER 语句创建库表,命令执行成功时当前 V-cluster 的各节点库表均创建成功。
    当使用 clickhouse-client 进行查询时,若在 A 机上查询 B 机的本地表则会报错“Table xxx doesn't exist..”。若希望集群内的所有机器都能查询某张表,推荐使用分布式表。
    相关官方文档 CREATE Queries

    查询

    ClickHouse 使用 SELECT 语句来完成数据查询。
    SELECT [DISTINCT] expr_list
    [FROM [db.]table | (subquery) | table_function] [FINAL]
    [SAMPLE sample_coeff]
    [GLOBAL] [ANY|ALL] [INNER|LEFT|RIGHT|FULL|CROSS] [OUTER] JOIN (subquery)|table USING columns_list
    [PREWHERE expr]
    [WHERE expr]
    [GROUP BY expr_list] [WITH TOTALS]
    [HAVING expr]
    [ORDER BY expr_list]
    [LIMIT [offset_value, ]n BY columns]
    [LIMIT [n, ]m]
    [UNION ALL ...]
    [INTO OUTFILE filename]
    [FORMAT format]
    相关官方文档 SELECT Queries Syntax

    批量写入

    ClickHouse 使用 INSERT INTO 语句来完成数据写入。
    INSERT INTO [db.]table [(c1, c2, c3)] VALUES (v11, v12, v13), (v21, v22, v23), ...
    INSERT INTO [db.]table [(c1, c2, c3)] SELECT ...
    相关官方文档 INSERT

    删除数据

    ClickHouse 使用 DROP 或 TRUNCATE 语句来完成数据删除。
    说明:
    DROP 删除元数据和数据,TRUNCATE 只删除数据。
    DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster]DROP [TEMPORARY] TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]
    TRUNCATE TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]

    修改表结构

    ClickHouse 使用 ALTER 语句来完成表结构修改。
    # 对表的列操作
    ALTER TABLE [db].name [ON CLUSTER cluster] ADD COLUMN [IF NOT EXISTS] name [type] [default_expr] [codec] [AFTER name_after]ALTER TABLE [db].name [ON CLUSTER cluster] DROP COLUMN [IF EXISTS] nameALTER TABLE [db].name [ON CLUSTER cluster] CLEAR COLUMN [IF EXISTS] name IN PARTITION partition_nameALTER TABLE [db].name [ON CLUSTER cluster] COMMENT COLUMN [IF EXISTS] name 'comment'ALTER TABLE [db].name [ON CLUSTER cluster] MODIFY COLUMN [IF EXISTS] name [type] [default_expr] [TTL]
    
    # 对表的分区操作
    ALTER TABLE table_name DETACH PARTITION partition_exprALTER TABLE table_name DROP PARTITION partition_exprALTER TABLE table_name CLEAR INDEX index_name IN PARTITION partition_expr
    
    # 对表的属性操作
    ALTER TABLE table-name MODIFY TTL ttl-expression
    相关官方文档 ALTER

    查看信息

    SHOW 语句

    展现数据库、处理列表、表、字典等信息。
    SHOW DATABASES [INTO OUTFILE filename] [FORMAT format]SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]SHOW [TEMPORARY] TABLES [{FROM | IN} <db>] [LIKE '<pattern>' | WHERE expr] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
    相关官方文档 SHOW Queries

    DESCRIBE 语句

    查看表的元数据信息。
    DESC|DESCRIBE TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]

    函数

    ClickHouse 函数有两种类型:常规函数和聚合函数,区别是常规函数可以通过一行数据产生结果,聚合函数则需要一组数据来产生结果。

    常规函数

    算数函数

    数据表中各字段参与数学计算函数。
    函数名称
    用途
    使用场景
    plus(a, b), a + b
    计算两个字段的和
    plus(table.field1, table.field2)
    minus(a, b), a - b
    计算两个字段的差
    minus(table.field1, table.field2)
    multiply(a, b), a * b
    计算两个字段的积
    multiply(table.field1, table.field2)
    divide(a, b), a / b
    计算两个字段的商
    divide(table.field1, table.field2)
    modulo(a, b), a % b
    计算两个字段的余数
    modulo(table.field1, table.field2)
    abs(a)
    取绝对值
    abs(table.field1)
    negate(a)
    取相反数
    negate(table.field1)

    比较函数

    函数名称
    用途
    使用场景
    =, ==
    判断是否相等
    table.field1 = value
    !=, <>
    判断是否不相等
    table.field1 != value
    >
    判断是否大于
    table.field1 > value
    >=
    判断是否大于等于
    table.field1 >= value
    <
    判断是否小于
    table.field1 < value
    <=
    判断是否小于等于
    table.field1 <= value

    逻辑运算函数

    函数名称
    用途
    使用场景
    AND
    两个条件都必须满足
    -
    OR
    两个条件满足其中之一
    -
    NOT
    取条件判断的相反
    -

    类型转换函数

    转换函数可能会溢出,溢出后的数字与 C 语言中数据类型保持一致。
    函数名称
    用途
    使用场景
    toInt(8|16|32|64)
    将字符型转化为整数型
    toInt8('128') 结果为-127
    toUInt(8|16|32|64)
    将字符型转化为无符号整数型
    toUInt8('128') 结果为128
    toInt(8|16|32|64)OrZero
    将整数字符型转化为整数型,异常时返回0
    toInt8OrZero('a') 结果为0
    toUInt(8|16|32|64)OrZero
    将整数字符型转化为整数型,异常时返回0
    toUInt8OrZero('a') 结果为0
    toInt(8|16|32|64)OrNull
    将整数字符型转化为整数型,异常时返回 NULL
    toInt8OrNull('a') 结果为 NULL
    toUInt(8|16|32|64)OrNull
    将整数字符型转化为整数型,异常时返回 NULL
    toUInt8OrNull('a') 结果为 NULL
    浮点数类型或日期类型也有上述类似的函数。
    相关官方文档 Type Conversion Functions

    日期函数

    字符串函数

    UUID

    相关官方文档 Functions for working with UUID

    JSON 处理函数

    相关官方文档 Functions for working with JSON

    聚合函数

    函数名称
    用途
    使用场景
    count
    统计行数或者非 NULL 值个数
    count(expr)、COUNT(DISTINCT expr)、count()、count(*)
    返回第一个遇到的值,结果不确定
    any(column)
    基于 heavy hitters 算法,返回经常出现的值。通常结果不确定
    anyHeavy(column)
    返回最后一个遇到的值,结果不确定
    anyLast(column)
    按位与
    groupBitAnd(expr)
    按位或
    groupBitOr(expr)
    按位异或
    groupBitXor(expr)
    求基数(cardinality)
    groupBitmap(expr)
    求最小值
    min(column)
    求最大值
    max(x)
    返回 val 最小值行的 arg 的值
    argMin(c1, c2)
    返回 val 最大值行的 arg 的值
    argMax(c1, c2)
    求和
    sum(x)
    求和,结果溢出则返回错误
    sumWithOverflow(x)
    用于数组类型,对相同 key 的 value 求和,返回两个数组的 tuple,第一个为排序后的 key,第二个为对应 key 的 value 之和
    -
    偏度
    skewPop(expr)
    skewSamp(expr)
    峰度
    kurtPop(expr)
    kurtSamp(expr)
    对 uid 分组的时间序列对应时间点求和,求和前缺失的时间点线性插值
    -
    对 uid 分组的时间序列对应时间点的变化率求和
    -
    求平均值
    -
    计算不同值的近似个数
    uniq(x[, ...])
    计算不同值的近似个数,相比 uniq 消耗的内存更少,精度更高,但是性能稍差
    uniqCombined(HLL_precision)(x[, ...])、uniqCombined(x[, ...])
    uniqCombined 的 64bit 版本,结果溢出的可能性降低
    -
    计算不同值的近似个数,不建议使用。请用 uniq、uniqCombined
    -
    计算不同值的精确个数
    uniqExact(x[, ...])
    返回 x 取值的数组,数组大小可由 max_size 指定
    -
    在数组的指定位置 position 插入值 value
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -

    字典

    一个字典是一个映射(key -> attributes),能够作为函数被用于查询,相比引用(reference)表JOIN的方式更简单和高效。
    数据字典有两种,一个是内置字典,另一个是外置字典。

    内置字典

    ClickHouse 支持一种 内置字典 geobase,支持的函数可参考 Functions for working with Yandex.Metrica dictionaries

    外置字典

    ClickHouse 可以从多个数据源添加 外置字典,支持的数据源可参考 Sources Of External Dictionaries
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持