Bagikan melalui

vector_sumFungsi agregasi

Berlaku untuk:check ditandai ya Databricks Runtime 18.1 ke atas

Menghitung jumlah vektor yang bijaksana dalam agregat. Mengembalikan vektor di mana setiap elemen adalah jumlah elemen yang sesuai di semua vektor input.

Sintaksis

vector_sum(vectors) [FILTER ( WHERE cond ) ]

Argumen

  • vektor: Kolom ARRAY<FLOAT> ekspresi yang mewakili vektor. Semua vektor harus memiliki dimensi yang sama.
  • cond: Ekspresi boolean opsional yang memfilter baris yang digunakan untuk agregasi.

Pengembalian Barang

Nilai ARRAY<FLOAT> dengan dimensi yang sama dengan vektor input. Setiap elemen dalam hasil adalah jumlah elemen yang sesuai di semua vektor input.

NULL nilai dan non-vektorNULL yang NULL berisi elemen diabaikan dalam agregasi. Mengembalikan NULL jika semua nilai dalam grup tidak valid (NULL atau non-vektorNULL dengan NULL elemen). Mengembalikan array [] kosong jika semua vektor input kosong.

Catatan

  • Hanya ARRAY<FLOAT> didukung; jenis lain seperti ARRAY<DOUBLE> atau ARRAY<DECIMAL> menimbulkan kesalahan.
  • Semua vektor input harus memiliki dimensi yang sama; jika tidak, fungsi akan meningkatkan VECTOR_DIMENSION_MISMATCH.
  • Non-vektorNULL yang berisi NULL elemen diperlakukan sebagai NULL.

Kondisi kesalahan

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