sys.dm_fts_index_keywords (Transact-SQL)
Возвращает сведения о содержимом полнотекстового индекса для указанной таблицы.
sys.dm_fts_index_keywords — функция динамического управления.
.gif "Примечание") Примечание |
|---|
Чтобы просмотреть данные полнотекстового индекса нижнего уровня, используйте функцию динамического управления 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(). Эта функция принимает имя таблицы и возвращает идентификатор таблицы, содержащей полнотекстовый индекс для проверки.
Возвращенная таблица
Имя столбца |
Тип данных |
Описание |
|---|---|---|
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. |
Разрешения
Необходимы разрешения CREATE FULLTEXT CATALOG и разрешение SELECT на столбцы, включенные в полнотекстовый индекс.
Примеры
А. Отображение содержимого полнотекстового индекса высокого уровня
В следующем примере отображаются сведения о содержимом полнотекстового индекса высокого уровня в таблице HumanResources.JobCandidate образца базы данных AdventureWorks2008R2. .
SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2008R2'), object_id('HumanResources.JobCandidate'))
GO