Compartir a través de

  • Artículo

FULLTEXTCATALOGPROPERTY (Transact-SQL)

Devuelve información acerca de las propiedades de catálogo de texto completo.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')

Argumentos

Nota

Se quitarán las propiedades siguientes de una versión futura de SQL Server: LogSize y PopulateStatus. Evite el uso de estas propiedades en nuevos trabajos de desarrollo y piense en modificar las aplicaciones que las usan actualmente.

  • catalog_name
    Es una expresión que contiene el nombre del catálogo de texto completo.

  • property
    Es una expresión que contiene el nombre de la propiedad del catálogo de texto completo. La tabla presenta las propiedades y proporciona descripciones de la información que se devuelve.

    Propiedad

    Descripción

    AccentSensitivity

    Opción de distinción de acentos.

    0 = No distinguir acentos

    1 = Distinguir acentos

    IndexSize

    Tamaño lógico del catálogo de texto completo en megabytes (MB).

    Para obtener más información, vea la sección "Notas" más adelante en este tema.

    ItemCount

    Número de elementos de texto completo indizados que contiene actualmente el catálogo de texto completo.

    LogSize

    Se admite únicamente por compatibilidad con versiones anteriores. Siempre devuelve 0.

    Tamaño, en bytes, del conjunto combinado de los registros de errores asociados a un catálogo de texto completo de los servicios de Microsoft Search.

    MergeStatus

    Si hay una mezcla maestra en curso.

    0 = La mezcla principal no está en curso.

    1 = La mezcla principal está en curso.

    PopulateCompletionAge

    Diferencia, en segundos, entre la terminación del último rellenado del índice de texto completo y 01/01/1990 00:00:00.

    Sólo se actualiza para rastreos completos e incrementales. Devuelve 0 si no se ha producido ningún rellenado.

    PopulateStatus

    0 = Inactivo

    1 = Rellenado completo en curso

    2 = En pausa

    3 = Acelerado

    4 = En recuperación

    5 = Apagado

    6 = Rellenado incremental en curso

    7 = Generación del índice

    8 = El disco está lleno. En pausa.

    9 = Seguimiento de cambios

    UniqueKeyCount

    Número de claves únicas en el catálogo de texto completo.

    ImportStatus

    Si se va a importar el catálogo de texto completo.

    0 = Si no se va a importar el catálogo de texto completo.

    1 = Si se va a importar el catálogo de texto completo.

Tipos de valor devueltos

int

Excepciones

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.

En SQL Server 2008, un usuario solo puede ver los metadatos de los elementos protegibles que posea o para los que se le haya concedido permiso. Esto significa que las funciones integradas de emisión de metadatos, como FULLTEXTCATALOGPROPERTY, pueden devolver NULL si el usuario no tiene ningún permiso para el objeto. Para obtener más información, vea Configuración de visibilidad de los metadatos y Solucionar problemas de visibilidad de los metadatos.

Comentarios

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'IndexSize') solo mira en fragmentos con el estado 4 ó 6, según se muestra en sys.fulltext_index_fragments. Estos fragmentos forman parte del índice lógico. Por lo tanto, la propiedad IndexSize solo devuelve el tamaño del índice de lógico. Sin embargo, durante una mezcla de índice, el tamaño de índice real podría ser el doble de su tamaño lógico. Para encontrar el tamaño real que está utilizando un índice de texto completo durante una mezcla, use el procedimiento almacenado del sistema sp_spaceused. Ese procedimiento mira en todos los fragmentos asociados a un índice de texto completo.

Es importante que las aplicaciones no entren en bucles de espera; para ello, compruebe si la propiedad PopulateStatus indica inactividad (indicando que el rellenado se ha completado) porque esto quita muchos ciclos de la CPU a la base de datos y a los procesos de búsqueda de texto completo, y provoca tiempos de espera. Además, siempre es recomendable comprobar la propiedad PopulateStatus correspondiente a nivel de tabla, TableFullTextPopulateStatus, de la función del sistema OBJECTPROPERTYEX. Ésta y otras nuevas propiedades de texto completo en OBJECTPROPERTYEX proporcionan información más detallada sobre las tablas de indización de texto completo. Para obtener más información, vea OBJECTPROPERTYEX (Transact-SQL).

Ejemplos

En el ejemplo siguiente se devuelve el número de elementos de texto completo indizados que se encuentran en el catálogo de texto completo Cat_Desc.

USE AdventureWorks2008R2;
GO
SELECT fulltextcatalogproperty('Cat_Desc', 'ItemCount');
GO