vector_sum összesítő függvény

A következőre vonatkozik: yes Databricks Runtime 18.1 vagy újabb jelöléssel

A vektorok elemalapú összegét számítja ki az összesítésben. Egy vektort ad vissza, amelyben minden elem az összes bemeneti vektor megfelelő elemeinek összege.

Szemantika

vector_sum(vectors) [FILTER ( WHERE cond ) ]

Arguments

  • vektorok: Vektorokat képviselő kifejezések oszlopa ARRAY<FLOAT> . Minden vektornak azonos dimenzióval kell rendelkeznie.
  • cond: Nem kötelező logikai kifejezés, amely az összesítéshez használt sorokat szűri.

Visszatérítések

Olyan ARRAY<FLOAT> érték, amelynek dimenziója megegyezik a bemeneti vektorokkal. Az eredmény minden eleme az összes bemeneti vektor megfelelő elemeinek összege.

NULLaz elemeket tartalmazó NULL értékek és nemNULL vektorok figyelmen kívül lesznek hagyva az összesítésben. Visszaadja NULL , ha a csoport összes értéke érvénytelen (NULL vagy nemNULL vektorok elemekkel NULL ). Üres tömböt [] ad vissza, ha az összes bemeneti vektor üres.

Jegyzetek

  • Csak ARRAY<FLOAT> a támogatott; más típusok, például ARRAY<DOUBLE>ARRAY<DECIMAL> a hiba felmerülése.
  • Minden bemeneti vektornak azonos dimenzióval kell rendelkeznie; ellenkező esetben a függvény VECTOR_DIMENSION_MISMATCH.
  • Az elemeket NULL tartalmazó nemNULL vektorok a következőképpen lesznek kezelveNULL.

Gyakori hibafeltételek

Examples

-- Element-wise sum per category (with GROUP BY)
> SELECT category, vector_sum(embedding) AS sum_vector
    FROM vector_data
    GROUP BY category
    ORDER BY category;
  category: A, sum_vector: [5.0, 7.0, 9.0]
  category: B, sum_vector: [5.0, 3.0, 5.0]

-- Scalar aggregation (without GROUP BY)
> SELECT vector_sum(embedding) AS total_sum FROM vector_data;
  total_sum: [10.0, 10.0, 14.0]
  • Last updated on