跳到主要内容

L2_DISTANCE

描述

计算欧几里得空间中两点(向量值为坐标)之间的距离

语法

L2_DISTANCE(<array1>, <array2>)

参数

参数说明
<array1>第一个向量(向量值为坐标),输入数组的子类型支持:TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE,元素数量需与 array2 保持一致
<array2>第二个向量(向量值为坐标),输入数组的子类型支持:TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE,元素数量需与 array1 保持一致

返回值

返回欧几里得空间中两点(向量值为坐标)之间的距离,返回类型为 FLOAT

如果任一输入数组为 NULL,或包含 NULL 元素,函数会报错。

举例

SELECT L2_DISTANCE([4, 5], [6, 8]),L2_DISTANCE([3, 6], [4, 5]);
+-----------------------------+-----------------------------+
| l2_distance([4, 5], [6, 8]) | l2_distance([3, 6], [4, 5]) |
+-----------------------------+-----------------------------+
| 3.605551 | 1.414214 |
+-----------------------------+-----------------------------+

如果输入数组为 NULL,函数会报错:

SELECT L2_DISTANCE(NULL, [1, 2]);
ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]First argument for function l2_distance cannot be null

如果输入数组包含 NULL 元素,函数会报错:

SELECT L2_DISTANCE([1, NULL], [1, 2]);
ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]First argument for function l2_distance cannot have null