FULLTEXTCATALOGPROPERTY (Transact-SQL)

  • Artículo

Actualizado: 17 de julio de 2006

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

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

Sintaxis

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')

Argumentos

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

  • property
    Es una expresión que contiene el nombre de la propiedad del catálogo de texto. 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, en megabytes (MB), del catálogo de texto.

    ItemCount

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

    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 de los servicios de Microsoft Search.

    MergeStatus

    Mezcla principal 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 llenado del índice de texto 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 llenado.

    PopulateStatus

    0 = Inactivo

    1 = Llenado completo en curso

    2 = En pausa

    3 = Acelerado

    4 = En recuperación 5 = Apagado

    6 = Llenado 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.

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 2005, un usuario sólo puede ver los metadatos de asegurables 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.

Notas

Es importante que las aplicaciones no entren en bucles de espera; para ello, compruebe si la propiedad PopulateStatus indica inactividad (indicando que el llenado ha concluido) porque esto quita muchos ciclos de la CPU a la base de datos y a los procesos de búsqueda de texto, 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 en OBJECTPROPERTYEX proporcionan información más detallada sobre las tablas de indización de texto. Para obtener más información, vea OBJECTPROPERTYEX (Transact-SQL).

Ejemplos

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

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

Vea también

Referencia

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Funciones de metadatos (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

17 de julio de 2006
Contenido nuevo:
  • Se ha agregado la sección Excepciones.