semanticsimilaritytable (Transact-SQL)

2025-07-25

Zwraca tabelę zero, jeden lub więcej wierszy dla dokumentów, których zawartość w określonych kolumnach jest semantycznie podobna do określonego dokumentu.

Do tej funkcji zestawu wierszy można odwoływać się w FROM klauzuli instrukcji SELECT , takiej jak zwykła nazwa tabeli.

Transact-SQL konwencje składni

Syntax

SEMANTICSIMILARITYTABLE
    (
      table
      , { column | (column_list) | * }
      , source_key
    )

Arguments

tabela

Nazwa tabeli z włączonym indeksowaniem pełnotekstowym i semantycznym.

Ta nazwa może być od jednej do czterech części, ale nazwa serwera zdalnego nie jest dozwolona.

column

Nazwa indeksowanej kolumny, dla której powinny zostać zwrócone wyniki. Kolumna musi mieć włączoną indeksowanie semantyczne.

column_list

Wskazuje kilka kolumn rozdzielonych przecinkami i ujętych w nawiasy. Wszystkie kolumny muszą mieć włączone indeksowanie semantyczne.

*

Wskazuje, że uwzględniono wszystkie kolumny z włączonym indeksowaniem semantycznym.

source_key

Unikatowy klucz dla wiersza w celu żądania wyników dla określonego wiersza.

Klucz jest niejawnie konwertowany na typ unikatowego klucza pełnotekstowego w tabeli źródłowej, jeśli jest to możliwe. Klucz można określić jako stałą lub zmienną, ale nie może być wyrażeniem ani wynikiem podzapytania skalarnego.

Table returned

W poniższej tabeli opisano informacje o podobnych lub powiązanych dokumentach zwracanych przez tę funkcję zestawu wierszy.

Dopasowane dokumenty są zwracane dla poszczególnych kolumn, jeśli wyniki są żądane z więcej niż jednej kolumny.

Column name	Typ	Description
`source_column_id` ¹	int	Identyfikator kolumny, z której dokument źródłowy został użyty do znalezienia podobnych dokumentów.
`matched_column_id` ¹	int	Identyfikator kolumny, z której znaleziono podobny dokument.
`matched_document_key`	`*` Ten klucz odpowiada typowi unikatowego klucza w tabeli źródłowej.	Unikatowy klucz wyodrębniania pełnotekstowego i semantycznego dokumentu lub wiersza, który został znaleziony, jest podobny do określonego dokumentu w zapytaniu.
`score`	real	Względna wartość podobieństwa dla tego dokumentu w relacji ze wszystkimi innymi podobnymi dokumentami. Wartość jest wartością ułamkową dziesiętną w zakresie [0,0, 1,0], gdzie wyższy wynik reprezentuje bliższe dopasowanie, a 1,0 jest idealnym wynikiem.

¹ Zobacz funkcje COL_NAME i COLUMNPROPERTY , aby uzyskać szczegółowe informacje na temat pobierania nazwy kolumny z column_id i na odwrót.

Remarks

Aby uzyskać więcej informacji, zobacz Znajdowanie podobnych i powiązanych dokumentów za pomocą wyszukiwania semantycznego.

Limitations

Nie można wykonywać zapytań dotyczących kolumn dla podobnych dokumentów. Funkcja SEMANTICSIMILARITYTABLE pobiera tylko podobne dokumenty z tej samej kolumny co kolumna źródłowa, która jest identyfikowana przez argument source_key .

Metadata

Aby uzyskać informacje i stan wyodrębniania i populacji semantycznej podobieństwa, wykonaj zapytanie dotyczące następujących dynamicznych widoków zarządzania:

Permissions

Wymaga SELECT uprawnień w tabeli podstawowej, na której utworzono indeksy pełnotekstowe i semantyczne.

Examples

Poniższy przykład pobiera 10 najlepszych kandydatów, którzy są podobni do określonego kandydata z HumanResources.JobCandidate tabeli w przykładowej AdventureWorks2022 bazie danych.

SELECT TOP (10) KEY_TBL.matched_document_key AS Candidate_ID
FROM SEMANTICSIMILARITYTABLE (HumanResources.JobCandidate, Resume, @CandidateID) AS KEY_TBL
ORDER BY KEY_TBL.score DESC;