FULLTEXTCATALOGPROPERTY (Transact-SQL)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Returnerar information om fulltextkatalogegenskaper i SQL Server.

Transact-SQL syntaxkonventioner

Syntax

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')  

Arguments

Anmärkning

Följande egenskaper kommer att tas bort i en framtida version av SQL Server: LogSize och PopulateStatus. Undvik att använda dessa egenskaper i nyutvecklat arbete och planera att modifiera applikationer som för närvarande använder någon av dem.

catalog_name
Är ett uttryck som innehåller namnet på fulltextkatalogen.

egenskap
Är ett uttryck som innehåller namnet på fulltextkatalogens egenskap. Tabellen listar egenskaperna och ger beskrivningar av den information som returneras.

Fastighet	Description
AccentSensitivitet	Inställning för accentkänslighet. 0 = Accent okänslig 1 = Accentkänslig
IndexSize	Logisk storlek på fulltextkatalogen i megabyte (MB). Inkluderar storleken på semantiska nyckelfras- och dokumentlikhetsindex. För mer information, se "Anmärkningar" senare i detta ämne.
ItemCount	Antal indexerade poster inklusive alla fulltext-, nyckelfras- och dokumentlikhetsindex i en katalog
LogSize	Stöds endast för bakåtkompatibilitet. Returnerar alltid 0. Storlek, i bytes, av den sammanlagda uppsättningen felloggar kopplade till en fulltextkatalog för Microsoft Search Service.
MergeStatus	Indikerar om en master-sammanslagning pågår. 0 = mastersammanslagning pågår inte 1 = huvudsammanslagning pågår
BefolkaFullbordandeålder	Skillnaden i sekunder mellan slutförandet av den senaste fulltextindexpopulationen och 01/01/1990 00:00:00. Endast uppdaterad för fullständiga och inkrementella genomsökningar. Ger 0 om ingen population har förekommit.
Befolkningsstatus	0 = Viloläge 1 = Fullständig population under utveckling 2 = Pausad 3 = Strypad 4 = Återhämtar sig 5 = Nedstängning 6 = Inkrementell population under utveckling 7 = Byggnadsindex 8 = Disken är full. Pausad. 9 = Ändringsspårning
UniqueKeyCount	Antal unika nycklar i fulltextkatalogen.
ImportStatus	Anger om fulltextkatalogen importeras. 0 = Fulltextkatalogen importeras inte. 1 = Fulltextkatalogen importeras.

Returtyper

int

Exceptions

Returnerar NULL vid fel eller om en anropare inte har behörighet att visa objektet.

I SQL Server kan en användare endast se metadata för värdepappersfiler. Dessa securables är sådana som användaren äger eller som användaren har fått tillstånd till. Därför kan inbyggda funktioner som genererar metadata, såsom FULLTEXTCATALOGPROPERTY, returnera NULL om användaren inte har någon behörighet på objektet. För mer information, se sp_help_fulltext_catalogs (Transact-SQL).

Anmärkningar

FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') tittar endast på fragment med status 4 eller 6 som visas i sys.fulltext_index_fragments. Dessa fragment är en del av det logiska indexet. Därför returnerar egenskapen IndexSize endast den logiska indexstorleken.

Vid en indexsammanslagning kan dock den faktiska indexstorleken vara dubbelt så stor som den logiska storleken. För att hitta den faktiska storleken som förbrukas av ett fulltextindex under en sammanslagning, använd proceduren sp_spaceused systemlagred. Den proceduren tittar på alla fragment som är kopplade till ett fulltextindex.

Fulltextpopulationen kan misslyckas. Det kan misslyckas om du begränsar tillväxten av fulltextkatalogfilen och inte tillåter tillräckligt med utrymme för sammanslagningsprocessen. I detta fall returnerar FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') 0 och följande fel skrivs till fulltextloggen:

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.

Det är viktigt att applikationer inte väntar i en stram loop och kontrollerar att egenskapen PopulateStatus ska bli inaktiv. Att bli inaktiv indikerar att befolkningen har minskat. Denna kontroll tar CPU-cykler bort från databasen och fulltextsökningsprocesserna, och orsakar timeouts. Det är vanligtvis ett bättre alternativ att kontrollera motsvarande egenskap PopulateStatus på tabellnivå, TableFullTextPopulateStatus i systemfunktionen OBJECTPROPERTYEX. Denna och andra nya fulltextegenskaper i OBJECTPROPERTYEX ger mer detaljerad information om fulltextindexeringstabeller. Mer information finns i OBJECTPROPERTYEX (Transact-SQL).

Examples

Följande exempel återger antalet fulltextindexerade objekt i en fulltextkatalog med namnet Cat_Desc.

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

Se även

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Metadata functions (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)