sys.dm_fts_index_keywords (Transact-SQL)

Статья
08/21/2023

Область применения: SQL Server

Возвращает сведения о содержимом полнотекстового индекса для указанной таблицы.

sys.dm_fts_index_keywords — это динамическая функция управления.

Примечание.

Чтобы просмотреть сведения о полнотекстовом индексе нижнего уровня, используйте sys.dm_fts_index_keywords_by_document динамическую функцию управления на уровне документа.

Синтаксис

  
sys.dm_fts_index_keywords( DB_ID('database_name'), OBJECT_ID('table_name') )

Аргументы

db_id('database_name')
Вызов функции DB_ID(). Эта функция принимает имя базы данных и возвращает идентификатор базы данных, который sys.dm_fts_index_keywords используется для поиска указанной базы данных. Если аргумент database_name не указан, возвращается идентификатор текущей базы данных.

object_id('table_name')
Вызов функции OBJECT_ID(). Эта функция принимает имя таблицы и возвращает идентификатор таблицы, содержащей полнотекстовый индекс для проверки.

Возвращаемая таблица

Имя столбца	Тип данных	Description
keyword	nvarchar(4000)	Шестнадцатеричное представление ключевого слова, которое хранится в полнотекстовом индексе. Примечание. OxFF представляет специальный символ, указывающий конец файла или набора данных.
display_term	nvarchar(4000)	Ключевое слово в понятном формате. Этот формат является производным от шестнадцатеричного формата. Примечание. Значение display_term для OxFF — END OF FILE.
column_id	int	Идентификатор столбца, содержащий данное ключевое слово, индексированное полнотекстовым индексом.
document_count	int	Число документов или строк, содержащих текущий термин.

Замечания

Информация, возвращаемая sys.dm_fts_index_keywords , полезна для обнаружения следующих сведений, помимо прочего:

является ли ключевое слово частью полнотекстового индекса;
сколько документов или строк содержат данное ключевое слово;
какое ключевое слово наиболее часто встречается в полнотекстовом индексе:
- document_count каждого keyword_value по сравнению с общим document_count, числом документов 0xFF.
- Как правило, наиболее часто встречающиеся ключевые слова пригодны для объявления в качестве стоп-слов.

Примечание.

Document_count, возвращенные sys.dm_fts_index_keywords, могут быть менее точными для определенного документа, чем количество, возвращаемое sys.dm_fts_index_keywords_by_document или запросОМ CONTAINS. Согласно проведенной оценке, эта возможная неточность не превышает 1%. Эта неточность может возникать, так как document_id может считаться дважды, когда она продолжается по нескольким строкам в фрагменте индекса или когда она отображается более одного раза в одной строке. Чтобы получить более точное количество для определенного документа, используйте sys.dm_fts_index_keywords_by_document или запрос CONTAINS .

Разрешения

Необходимо членство в предопределенной роли сервера sysadmin .

Примеры

А. Отображение содержимого полнотекстового индекса высокого уровня

В следующем примере отображаются сведения о высокоуровневом содержимом полнотекстового индекса в таблице HumanResources.JobCandidate.

SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2022'), object_id('HumanResources.JobCandidate'))  
GO

См. также

Полнотекстовый поиск и динамические административные представления и функции семантического поиска (Transact-SQL)
Компонент Full-text Search
sys.dm_fts_index_keywords_by_document (Transact-SQL)

Поделиться через