以下文档由
system.functions 系统表自动生成。dotProduct
引入版本:v21.11.0 计算两个向量 (大小相等的元组或数组) 的点积 (标量积) 。 返回对应元素乘积的总和。 语法scalarProduct
参数
返回值
返回两个向量的点积。两个 BFloat16 数组会以 Float32 类型累加并返回 Float32。(U)Int* 或 Float* 或 Decimal
示例
基本用法
Query
Response
flattenTuple
引入版本:v22.6.0 将具名的嵌套 Tuple 展平。 返回的 Tuple 的元素为输入 Tuple 的路径。 语法input— 要展平的带名称嵌套元组。Tuple(n1 T1[, n2 T2, ... ])
Tuple(T)
示例
使用示例
Query
Response
tuple
首次引入于:v1.1.0 将输入参数分组后返回一个元组。 对于类型为 T1、T2、… 的列 C1、C2、…,如果这些列的名称唯一且可视为不带引号的标识符,则返回一个包含这些列的命名 Tuple(C1 T1, C2 T2, …) 类型元组;否则返回 Tuple(T1, T2, …)。执行该函数没有额外开销。 元组通常用作 IN 运算符参数的中间值,或用于创建 lambda 函数的形式参数列表。元组不能写入表。 该函数实现了运算符(x, y, ...)。
语法
- 无。
Query
Response
tupleConcat
引入版本:v23.8.0 将作为参数传入的元组合并在一起。 语法tupleN— 任意数量的 Tuple 类型的参数。Tuple(T)
Tuple(T)
示例
使用示例
Query
Response
tupleDivide
引入版本:v21.11.0 计算两个或多个大小相同的Tuple按元素逐一相除的结果,按从左到右的顺序进行。除以零将返回
inf。t1— 第一个输入 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 一个或多个额外的输入 Tuple。所有 Tuple 的大小必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
两个 Tuple
Query
Response
Query
Response
tupleDivideByNumber
首次引入版本:v21.11.0 返回一个 Tuple,其中所有元素都除以同一个数。除以零将返回
inf。tuple— 待相除的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)number— 除数。(U)Int*或Float*或Decimal
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
tupleElement
Introduced in: v1.1.0 按索引或名称从Tuple中提取元素。 按索引访问时,应使用从 1 开始的数字索引。 按名称访问时,可将元素名称作为字符串传入 (仅适用于命名Tuple) 。 支持负索引。在这种情况下,将选择对应的元素,并从末尾开始计数。例如,tuple.-1 表示Tuple中的最后一个元素。
可选的第三个参数用于指定默认值;当访问的元素不存在时,将返回该值,而不是抛出异常。
所有参数都必须是常量。
此函数没有运行时开销,并实现了运算符 x.index 和 x.name。
Syntax
tuple— Tuple或Tuple数组。Tuple(T)或Array(Tuple(T))index— 列索引,从 1 开始计数。const UInt8/16/32/64name— 元素名称。const Stringdefault_value— 当索引越界或元素不存在时返回的默认值。Any
Any
示例
索引访问
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
自 v21.1.0 引入 返回两个大小相同的 Tuple 之间的 Hamming 距离。
语法
UInt8/16/32/64
示例
使用示例
Query
Response
Query
Response
tupleIntDiv
引入版本:v23.8.0 对两个或多个大小相同的Tuple按从左到右的顺序逐元素执行整数除法。返回由各商值组成的Tuple。 如果任一Tuple包含非整数元素,则会先将每个非整数被除数或除数舍入为最接近的整数,再计算结果。 除以 0 会抛出异常。 语法t1— 第一个输入 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 一个或多个额外的输入 Tuple。所有 Tuple 的大小必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
两个 Tuple
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
引入版本:v23.8.0 对由分子组成的 Tuple 按给定分母执行整数除法,并返回由商组成的 Tuple。 如果任一输入参数包含非整数元素,则会先将每个非整数分子或除数舍入为最接近的整数,再计算结果。 除以 0 时会抛出错误。 语法tuple_num— 由分子值组成的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)div— 除数。(U)Int*或Float*或Decimal
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
Query
Response
tupleIntDivOrZero
引入版本:v23.8.0 与tupleIntDiv 类似,对两个或多个大小相同的 Tuple 按从左到右的顺序逐元素执行整数除法。
如果发生除以 0,则该元素返回 0,而不是抛出异常。
如果任一 Tuple 包含非整数元素,则会先将每个非整数被除数或除数舍入为最接近的整数,再计算结果。
语法
t1— 第一个输入 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 一个或多个后续输入 Tuple。所有 Tuple 的大小必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
除数为 0 时
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
引入版本:v23.8.0 与tupleIntDivByNumber 类似,它对一个由多个分子组成的元组和给定分母执行整数除法,并返回由各个商组成的元组。
当除数为零时,它不会抛出错误,而是返回商为零。
如果元组或 div 包含非整数元素,则会先将每个非整数分子或除数舍入到最接近的整数,再计算结果。
语法
tuple_num— 由分子值组成的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)div— 除数值。(U)Int*或Float*或Decimal
0 时,对应的商为 0。Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
Query
Response
tupleMinus
引入版本:v21.11.0 计算两个或多个大小相同的 Tuple 的逐元素差值,按从左到右的顺序进行。 语法vectorDifference
参数
t1— 第一个输入 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 一个或多个后续输入 Tuple。所有 Tuple 的大小都必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
两个 Tuple
Query
Response
Query
Response
tupleModulo
引入版本:v23.8.0 返回一个由两个或多个大小相同的元组按从左到右顺序逐元素相除所得余数组成的元组。 语法t1— 第一个输入 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 另外一个或多个输入 Tuple。所有 Tuple 的大小必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
两个 Tuple
Query
Response
Query
Response
tupleModuloByNumber
在 v23.8.0 中引入 返回一个 tuple,其中包含将给定除数分别对 tuple 中各元素进行求模 (取余) 运算后的结果。 语法tuple_num— 由分子元素组成的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)div— 除数。(U)Int*或Float*或Decimal
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
tupleMultiply
首次引入版本:v21.11.0 计算两个或多个大小相同的 Tuple 的逐元素乘积。 语法t1— 第一个输入 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 一个或多个其他输入 Tuple。所有 Tuple 的大小必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
两个 Tuple
Query
Response
Query
Response
tupleMultiplyByNumber
自 v21.11.0 引入 返回一个 Tuple,其中所有元素都乘以一个数值。 语法tuple— 要相乘的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)number— 乘数。(U)Int*或Float*或Decimal
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
tupleNames
引入版本:v24.8.0 将元组转换为列名数组。对于形如Tuple(a T, b T, ...) 的元组,它会返回一个字符串数组,表示该元组中已命名列的名称。如果元组元素没有显式名称,则会使用它们的索引作为列名。
语法
- 无。
Query
Response
tupleNegate
Introduced in:v21.11.0 计算 Tuple 元素的相反数。 Syntaxt— 要取负的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
tuplePlus
引入版本:v21.11.0 计算两个或多个大小相同的Tuple中对应元素之和。 语法vectorSum
参数
t1— 第一个输入Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)t2, ..., tN— 一个或多个额外的输入Tuple。所有Tuple的大小必须相同。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
两个Tuple
Query
Response
Query
Response
tuplePositiveModuloByNumber
引入版本:v26.4.0 返回一个 Tuple 与给定除数做除法运算后所得正模 (余数) 组成的 Tuple。 与 tupleModuloByNumber 不同,结果始终为非负。 语法tuple_num— 由分子值组成的 Tuple。Tuple((U)Int*)或Tuple(Float*)或Tuple(Decimal)div— 除数。(U)Int*或Float*或Decimal
Tuple((U)Int*) 或 Tuple(Float*) 或 Tuple(Decimal)
示例
基本用法
Query
Response
tupleToNameValuePairs
引入版本:v21.9.0 将 Tuple 转换为由(name, value) 对组成的 Array。
例如,Tuple Tuple(n1 T1, n2 T2, ...) 会转换为 Array(Tuple('n1', T1), Tuple('n2', T2), ...)。
Tuple 中的所有值都必须是相同的类型。
语法
tuple— 包含任意类型值的命名元组。Tuple(n1 T1[, n2 T2, ...])
(name, value) 对组成的数组。Array(Tuple(String, T))
示例
命名元组
Query
Response
Query
Response
untuple
在调用位置对 tuple 的元素执行语法替换。 结果列名取决于具体实现,并且可能发生变化。不要在untuple 之后假定特定的列名。
语法
EXCEPT 表达式,从查询结果中排除某些列。
参数
x—tuple函数、列,或元素组成的元组。Tuple。
- 无。
Tuple 类型的列用作 untuple 函数参数的示例:
Query
Response
EXCEPT 表达式的示例:
Query
Response