FULLTEXTCATALOGPROPERTY (Transact-SQL)FULLTEXTCATALOGPROPERTY (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Devuelve información acerca de las propiedades de catálogo de texto completo de SQL Server 2017SQL Server 2017.Returns information about full-text catalog properties in SQL Server 2017SQL Server 2017.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

  
FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')  

ArgumentosArguments

Nota

Las propiedades siguientes se quitarán en una versión futura de SQL ServerSQL Server: LogSize y PopulateStatus.The following properties will be removed in a future release of SQL ServerSQL Server: LogSize and PopulateStatus. Evite el uso de estas propiedades en nuevos trabajos de desarrollo y piense en modificar las aplicaciones que las usan actualmente.Avoid using these properties in new development work, and plan to modify applications that currently use any of them.

catalog_namecatalog_name
Es una expresión que contiene el nombre del catálogo de texto completo.Is an expression containing the name of the full-text catalog.

propertyproperty
Es una expresión que contiene el nombre de la propiedad del catálogo de texto completo.Is an expression containing the name of the full-text catalog property. La tabla presenta las propiedades y proporciona descripciones de la información que se devuelve.The table lists the properties and provides descriptions of the information returned.

PropiedadProperty DescripciónDescription
AccentSensitivityAccentSensitivity Opción de distinción de acentos.Accent-sensitivity setting.

0 = No distinguir acentos0 = Accent insensitive

1 = Distinguir acentos1 = Accent sensitive
IndexSizeIndexSize Tamaño lógico del catálogo de texto completo en megabytes (MB).Logical size of the full-text catalog in megabytes (MB). Incluye el tamaño de los índices semánticos de similitud de documentos y frases clave.Includes the size of semantic key phrase and document similarity indexes.

Para obtener más información, vea la sección "Comentarios" más adelante en este tema.For more information, see "Remarks," later in this topic.
ItemCountItemCount Número de elementos indexados, lo que incluye todos los índices de similitud de documentos, frases clave y texto completo en un catálogoNumber of indexed items including all full-text, keyphrase, and document similarity indexes in a catalog
LogSizeLogSize Se admite únicamente por compatibilidad con versiones anteriores.Supported for backward compatibility only. Siempre devuelve 0.Always returns 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 MicrosoftMicrosoft Search.Size, in bytes, of the combined set of error logs associated with a MicrosoftMicrosoft Search Service full-text catalog.
MergeStatusMergeStatus Indica si hay en curso una combinación maestra.Indicates whether a master merge is in progress.

0 = la combinación maestra no está en curso0 = master merge isn't in progress

1 = la combinación maestra está en curso.1 = master merge is in progress
PopulateCompletionAgePopulateCompletionAge Diferencia, en segundos, entre la terminación del último rellenado del índice de texto completo y 01/01/1990 00:00:00.The difference in seconds between the completion of the last full-text index population and 01/01/1990 00:00:00.

Solo se actualiza para rastreos completos e incrementales.Only updated for full and incremental crawls. Devuelve 0 si no se ha producido ningún rellenado.Returns 0 if no population has occurred.
PopulateStatusPopulateStatus 0 = Inactivo0 = Idle

1 = Rellenado completo en curso1 = Full population in progress

2 = En pausa2 = Paused

3 = Acelerado3 = Throttled

4 = En recuperación4 = Recovering

5 = Apagado5 = Shutdown

6 = Rellenado incremental en curso6 = Incremental population in progress

7 = Generación del índice7 = Building index

8 = El disco está lleno.8 = Disk is full. En pausa.Paused.

9 = Seguimiento de cambios9 = Change tracking
UniqueKeyCountUniqueKeyCount Número de claves únicas en el catálogo de texto completo.Number of unique keys in the full-text catalog.
ImportStatusImportStatus Indica si se va a importar el catálogo de texto completo.Indicates whether the full-text catalog is being imported.

0 = no se va a importar el catálogo de texto completo.0 = The full-text catalog isn't being imported.

1 = Si se va a importar el catálogo de texto completo.1 = The full-text catalog is being imported.

Tipos devueltosReturn Types

intint

ExcepcionesExceptions

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.Returns NULL on error or if a caller doesn't have permission to view the object.

En SQL Server 2017SQL Server 2017, un usuario solo puede ver los metadatos de elementos protegibles.In SQL Server 2017SQL Server 2017, a user can only view the metadata of securables. Estos elementos protegibles son los que posee el usuario o para los que se le ha concedido permiso.These securables are ones that the user owns or on which the user has been granted permission. Como tales, las funciones integradas que emiten metadatos, como FULLTEXTCATALOGPROPERTY, pueden devolver NULL si el usuario no tiene permisos sobre el objeto.As such, built-in functions that emit metadata, such as FULLTEXTCATALOGPROPERTY, may return NULL if the user doesn't have any permission on the object. Para más información, vea sp_help_fulltext_catalogs (Transact-SQL).For more information, see sp_help_fulltext_catalogs (Transact-SQL).

NotasRemarks

FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') solo examina fragmentos con el estado 4 o 6, como se muestra en sys.fulltext_index_fragments.FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') looks at only fragments with status 4 or 6 as shown in sys.fulltext_index_fragments. Estos fragmentos forman parte del índice lógico.These fragments are part of the logical index. Por lo tanto, la propiedad IndexSize solo devuelve el tamaño del índice lógico.As such, the IndexSize property returns only the logical index size.

Sin embargo, durante una mezcla de índice, el tamaño de índice real podría ser el doble de su tamaño lógico.During an index merge, however, the actual index size might be double its logical size. Para encontrar el tamaño real que está usando un índice de texto completo durante una combinación, use el procedimiento almacenado del sistema sp_spaceused.To find the actual size that is being consumed by a full-text index during a merge, use the sp_spaceused system stored procedure. Ese procedimiento mira en todos los fragmentos asociados a un índice de texto completo.That procedure looks at all fragments associated with a full-text index.

El rellenado de texto completo puede producir un errorThe full-text population may fail. si restringe el crecimiento del archivo de catálogo de texto completo y no permite suficiente espacio para el proceso de combinación.It may fail if you restrict the growth of the full-text catalog file and don't allow enough space for the merge process. En este caso, FULLTEXTCATALOGPROPERTY ("catalog_name','IndexSize") devuelve 0 y se escribe el siguiente error en el regidtro de texto completo:In this case, FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') returns 0 and the following error is written to the full-text log:

Error: 30059, Severity: 16, State: 1. A fatal error occurred during a full-text population and caused the population to be cancelled. Population type is: FULL; database name is FTS_Test (id: 13); catalog name is t1_cat (id: 5); table name t1 (id: 2105058535). Fix the errors that are logged in the full-text crawl log. Then, resume the population. The basic Transact-SQL syntax for this is: ALTER FULLTEXT INDEX ON table_name RESUME POPULATION.

Es importante que las aplicaciones no experimenten bucles de espera; para ello, compruebe si la propiedad PopulateStatus indica inactividad.It's important that applications don't wait in a tight loop, checking for the PopulateStatus property to become idle. Esto significaría que el rellenado se ha completado.Becoming idle indicates that population has completed. Esta comprobación excluye los ciclos de CPU de la base de datos y los procesos de búsqueda de texto completo, y provoca tiempos de espera.This check takes CPU cycles away from the database and full-text search processes, and causes timeouts. Normalmente, es mejor comprobar la propiedad PopulateStatus en el nivel de tabla, TableFullTextPopulateStatus, de la función del sistema OBJECTPROPERTYEX.It's usually a better option to check the corresponding PopulateStatus property at the table level, TableFullTextPopulateStatus in the OBJECTPROPERTYEX system function. É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.This and other new full-text properties in OBJECTPROPERTYEX provide more granular information about full-text indexing tables. Para obtener más información, vea OBJECTPROPERTYEX (Transact-SQL).For more information, see OBJECTPROPERTYEX (Transact-SQL).

EjemplosExamples

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.The following example returns the number of full-text indexed items in a full-text catalog named Cat_Desc.

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

Consulte tambiénSee Also

FULLTEXTSERVICEPROPERTY (Transact-SQL) FULLTEXTSERVICEPROPERTY (Transact-SQL)
Metadata Functions (Transact-SQL) [Funciones de metadatos (Transact-SQL)]Metadata Functions (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)sp_help_fulltext_catalogs (Transact-SQL)