Funkce vector_search
Platí pro: 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
- Tato funkce není k dispozici v klasických skladech SQL.
- Další informace najdete na stránce s cenami SQL služby Databricks.
- Tato funkce je k dispozici v oblastech, kde je podporováno hledání vektorů typu Puzzle AI.
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
: KonstantaSTRING
, 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ýrazSTRING
, ř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
nebocolumns
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.