sys.dm_fts_index_keywords (Transact-SQL)
Devuelve información sobre el contenido de un índice de texto completo para la tabla especificada.
sys.dm_fts_index_keywords es una función de administración dinámica.
Nota
Para ver la información de índices de texto completo de nivel inferior, utilice la función de administración dinámica sys.dm_fts_index_keywords_by_document en el nivel de documento.
Sintaxis
sys.dm_fts_index_keywords( DB_ID('database_name'), OBJECT_ID('table_name'))
Argumentos
db_id('database_name')
Llamada a la función DB_ID(). Esta función acepta un nombre de base de datos y devuelve el identificador de base de datos, que sys.dm_fts_index_keywords utiliza para buscar la base de datos especificada. Si se omite el parámetro database_name, se devuelve el identificador de base de datos actual.object_id('table_name')
Llamada a la función OBJECT_ID(). Esta función acepta un nombre de tabla y devuelve el identificador de la tabla que contiene el índice de texto completo que se va a inspeccionar.
Tabla devuelta
Nombre de columna |
Tipo de datos |
Descripción |
---|---|---|
keyword |
nvarchar(4000) |
Representación hexadecimal de la palabra clave que se almacena dentro del índice de texto completo.
Nota
OxFF representa el carácter especial que indica el final de un archivo o conjunto de datos.
|
display_term |
nvarchar(4000) |
Formato legible de la palabra clave. Este formato se deriva del formato hexadecimal.
Nota
El valor de display_term para OxFF es "END OF FILE".
|
column_id |
int |
Identificador de la columna en que la palabra clave actual forma parte del índice de texto completo. |
document_count |
int |
Número de documentos o filas que contienen el término actual. |
Comentarios
La información que devuelve sys.dm_fts_index_keywords es útil para averiguar lo siguiente, entre otras cosas:
Si una palabra clave forma parte del índice de texto completo.
Cuántos documentos o filas contienen una palabra clave determinada.
La palabra clave más común en el índice de texto completo:
document_count de cada keyword_value comparado con el document_count total, el recuento de documentos de 0xFF.
Normalmente, es probable que las palabras clave comunes sean adecuadas para declararlas como palabras irrelevantes.
Nota
El document_count que devuelve sys.dm_fts_index_keywords puede ser menos preciso para un documento específico que el contador que devuelve sys.dm_fts_index_keywords_by_document o una consulta CONTAINS. Se calcula que esta posible imprecisión es menor de un uno por ciento. Esta imprecisión puede ocurrir porque un document_id puede contarse dos veces cuando continúa a través de más de una fila en el fragmento de índice o cuando aparece más de una vez en la misma fila. Para obtener un recuento más preciso para un documento concreto, use sys.dm_fts_index_keywords_by_document o una consulta CONTAINS.
Permisos
Requiere los permisos CREATE FULLTEXT CATALOG y el permiso SELECT en las columnas cubiertas por el índice de texto completo.
Ejemplos
A. Mostrar el contenido del índice de texto completo de alto nivel
En el ejemplo siguiente se muestra información sobre el contenido de alto nivel del índice de texto completo en la tabla HumanResources.JobCandidate de la base de datos de ejemplo AdventureWorks2008R2. .
SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2008R2'), object_id('HumanResources.JobCandidate'))
GO