본문으로 건너뛰기
최종 수정: 에

L2_DISTANCE_APPROXIMATE

설명​

l2_distance의 근사 버전입니다. 해당 배열 컬럼에 ann 인덱스가 생성되어 있으면 이 함수의 결과를 인덱스에서 가져올 수 있습니다.

구문​

L2_DISTANCE_APPROXIMATE(<array1>, <array2>)

매개변수​

매개변수설명
<array1>첫 번째 벡터입니다(벡터 값은 좌표를 나타냅니다). 입력 배열의 하위 타입은 TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE이며, 요소 수는 array2와 같아야 합니다.
<array2>두 번째 벡터입니다(벡터 값은 좌표를 나타냅니다). 입력 배열의 하위 타입은 TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE을 지원하며, 요소 수는 array1과 같아야 합니다.

반환 값​

유클리드 공간에서 두 점 사이의 거리를 반환합니다(벡터 값은 좌표를 나타냅니다). 반환 타입은 FLOAT입니다.

입력 배열 중 하나라도 NULL이거나 NULL 요소를 포함하면 함수가 오류를 반환합니다.

예제​

CREATE TABLE sift_1M (
  id int NOT NULL,
  embedding array<float>  NOT NULL  COMMENT "",
  INDEX ann_index (embedding) USING ANN PROPERTIES(
      "index_type"="hnsw",
      "metric_type"="l2_distance",
      "dim"="128",
      "quantizer"="flat"
  )
) ENGINE=OLAP
DUPLICATE KEY(id) COMMENT "OLAP"
DISTRIBUTED BY HASH(id) BUCKETS 1
PROPERTIES (
  "replication_num" = "1"
);
INSERT INTO sift_1M
SELECT *
FROM S3(
  "uri" = "https://selectdb-customers-tools-bj.oss-cn-beijing.aliyuncs.com/sift_database.tsv",
  "format" = "csv");

ann 인덱스로 가속할 수 있는 ann topn 검색을 수행합니다.

SELECT id,
       L2_distance_approximate(embedding,
[0,11,77,24,3,0,0,0,28,70,125,8,0,0,0,0,44,35,50,45,9,0,0,0,4,0,4,56,18,0,3,9,16,17,59,10,10,8,57,57,100,105,125,41,1,0,6,92,8,14,73,125,29,7,0,5,0,0,8,124,66,6,3,1,63,5,0,1,49,32,17,35,125,21,0,3,2,12,6,109,21,0,0,35,74,125,14,23,0,0,6,50,25,70,64,7,59,18,7,16,22,5,0,1,125,23,1,0,7,30,14,32,4,0,2,2,59,125,19,4,0,0,2,1,6,53,33,2]
) AS distance
FROM   sift_1M
ORDER  BY distance
LIMIT  10

결과

+--------+----------+
| id     | distance |
+--------+----------+
| 178811 | 210.1595 |
| 177646 | 217.0161 |
| 181997 | 218.5406 |
| 181605 | 219.2989 |
| 821938 | 221.7228 |
| 807785 | 226.7135 |
| 716433 | 227.3148 |
| 358802 | 230.7314 |
| 803100 | 230.9112 |
| 866737 | 231.6441 |
+--------+----------+
10 rows in set (0.08 sec)

입력 배열이 NULL이면 함수가 오류를 반환합니다.

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

입력 배열에 NULL 요소가 포함되어 있으면 함수가 오류를 반환합니다.

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