类别：

Vector functions、聚合函数

VECTOR_MAX

在汇总中计算 向量 的按元素最大值。返回一个向量，其中每个元素是所有输入向量中对应元素的最大值。

另请参阅：

VECTOR_SUM , VECTOR_MIN , VECTOR_AVG , MAX, 向量嵌入

语法

VECTOR_MAX( <vector_column> )
Copy

实参

vector_column

包含 VECTOR 值的列。列中的所有向量必须具有相同的元素类型和维度。

返回

返回一个与输入向量具有相同元素类型和维度的 VECTOR 值。结果向量中的每个元素都是所有输入向量中对应元素的最大值。

使用说明

  • 聚合中会忽略 NULL 值。

  • 如果组中的所有值均为 NULL，则函数返回 NULL。

  • 列中的所有输入向量必须具有相同的维度和元素类型。

  • 向量函数的优化方式可能会降低浮点精度。此函数的结果误差幅度高达 1e-4。

示例

此示例演示计算向量的按元素最大值：

CREATE OR REPLACE TABLE vector_data (
  id INT,
  category VARCHAR,
  embedding VECTOR(FLOAT, 3)
);

INSERT INTO vector_data
SELECT 1, 'A', [1.5, 8.0, 3.2]::VECTOR(FLOAT, 3)
UNION ALL SELECT 2, 'A', [4.1, 2.5, 6.7]::VECTOR(FLOAT, 3)
UNION ALL SELECT 3, 'B', [2.0, 1.0, 4.0]::VECTOR(FLOAT, 3)
UNION ALL SELECT 4, 'B', [3.0, 2.0, 1.0]::VECTOR(FLOAT, 3);

-- Compute maximum for each category
SELECT category, VECTOR_MAX(embedding) AS max_vector
  FROM vector_data
  GROUP BY category
  ORDER BY category;
Copy
+----------+------------------+
| CATEGORY | MAX_VECTOR       |
+----------+------------------+
| A        | [4.1, 8.0, 6.7] |
| B        | [3.0, 2.0, 4.0] |
+----------+------------------+

此示例显示标量聚合（无 GROUPBY）：

SELECT VECTOR_MAX(embedding) AS overall_max
  FROM vector_data;
Copy
+------------------+
| OVERALL_MAX      |
+------------------+
| [4.1, 8.0, 6.7]  |
+------------------+
语言: 中文