Sdílet prostřednictvím


Funkce vector_search

Platí pro: zaškrtnutí označeného ano Databricks SQL

Důležité

Tato funkce je ve verzi Public Preview.

Tato vector_search() funkce umožňuje dotazovat se na index Služby vektoru AI v systému Sql.

Požadavky

Syntaxe

vector_search(index, query, num_results)

Argumenty

Všechny argumenty musí být předány názvem, například vector_search(index => indexName, query => queryText).

  • index: Konstanta STRING , plně kvalifikovaný název existujícího indexu vektorového vyhledávání ve stejném pracovním prostoru pro vyvolání. Definer musí mít u indexu oprávnění Vybrat.
  • query: Výraz STRING , řetězec, který se má vyhledat v indexu.
  • num_results (volitelné): Celočíselná konstanta, maximální počet záznamů, které se mají vrátit. Výchozí hodnota je 10.

Návraty

Tabulka nejvyšších odpovídajících záznamů z indexu Zahrnou se všechny sloupce indexu.

Příklady

Vyhledejte podobné produkty podle názvu pomocí indexu skladových položek produktu.


SELECT * FROM VECTOR_SEARCH(index => "main.db.my_index", query => "iphone", num_results => 2)
ID Název produktu
10 iPhone
20 iPhone SE

Následující příklad vyhledá více termínů najednou pomocí poddotazů LATERAL.


SELECT
  query_txt,
  query_id,
  search.*
FROM
  query_table,
  LATERAL(
SELECT * FROM VECTOR_SEARCH(index => "main.db.my_index", query => query_txt, num_results => 2)
  ) as search
query_txt query_id search.id search.product_name
iphone 1 10 iPhone 10
iphone 0 20 iPhone SE
pixel 8 2 30 Pixel 8
pixel 8 2 40 Pixel 8a

Omezení

Během verze Preview platí následující omezení:

  • Dotazy na typy indexů DIRECT_ACCESS nejsou podporovány.
  • Indexy s embedding_vector_columns nejsou podporovány.
  • Vstupní parametry filters_json nebo columns nejsou podporovány.
  • Vektorové vyhledávání s num_results více než 100 se nepodporuje.
  • Uživatelé, kteří nemají přístup ke čtení ke zdrojové tabulce, nemohou použít vector_search().
  • vector_search nelze použít s koncovými body obsluhující modely pomocí zřízených rozhraní API modelu foundation.