Share via


FULLTEXTCATALOGPROPERTY (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Geeft informatie terug over de eigenschappen van de full-text catalogus in SQL Server.

Transact-SQL syntaxis-conventies

Syntaxis

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')  

Arguments

Opmerking

De volgende eigenschappen zullen in een toekomstige release van SQL Server worden verwijderd: LogSize en PopulateStatus. Vermijd het gebruik van deze eigenschappen in nieuw ontwikkelingswerk en plan om applicaties aan te passen die er momenteel een van gebruiken.

catalog_name
Is een uitdrukking die de naam van de volledige tekstcatalogus bevat.

eigenschap
Is een expressie die de naam bevat van de volledige tekstcataloguseigenschap. De tabel geeft een overzicht van de eigenschappen en geeft beschrijvingen van de teruggegeven informatie.

Vastgoed Description
AccentSensitiviteit Instelling voor accentgevoeligheid.

0 = Accent ongevoelig

1 = Accentgevoelig
IndexSize Logische grootte van de full-text catalogus in megabytes (MB). Bevat de grootte van semantische sleutelwoorden en documentovereenkomstindexen.

Voor meer informatie, zie "Opmerkingen," later in dit onderwerp.
ItemCount Aantal geïndexeerde items, inclusief alle full-text, keyphrase- en documentovereenkomstindexen in een catalogus
LogSize Alleen ondersteund voor achterwaartse compatibiliteit. Geeft altijd 0 terug.

Grootte, in bytes, van de gecombineerde set foutlogboeken die gekoppeld zijn aan een Microsoft Search Service full-text catalogus.
MergeStatus Geeft aan of er een master merge gaande is.

0 = master merge is niet in uitvoering

1 = master merge is in uitvoering
PopulateCompletionAge Het verschil in seconden tussen de voltooiing van de laatste full-text indexpopulatie en 01/01/1990 00:00:00.

Alleen bijgewerkt voor volledige en incrementele crawls. Geeft 0 terug als er geen populatie is voorgekomen.
Bevolkingsstatus 0 = Stationair

1 = Volledige populatie in uitvoering

2 = Gepauzeerd

3 = Afgeremd

4 = Herstellen

5 = Sluiting

6 = Incrementele populatie in uitvoering

7 = Bouwindex

8 = Schijf is vol. Onderbroken.

9 = Wijzigingstracking
UniqueKeyCount Aantal unieke sleutels in de full-text catalogus.
ImportStatus Geeft aan of de volledige tekstcatalogus wordt geïmporteerd.

0 = De volledige tekstcatalogus wordt niet geïmporteerd.

1 = De volledige tekstcatalogus wordt geïmporteerd.

Retourtypen

int

Exceptions

Geeft NULL terug bij een fout of als een aanroeper geen toestemming heeft om het object te bekijken.

In SQL Server kan een gebruiker alleen de metadata van securables bekijken. Deze securables zijn eigendommen die de gebruiker bezit of waarvoor de gebruiker toestemming heeft gekregen. Als zodanig kunnen ingebouwde functies die metadata verzenden, zoals FULLTEXTCATALOGPROPERTY, NULL teruggeven als de gebruiker geen toestemming heeft voor het object. Voor meer informatie, zie sp_help_fulltext_catalogs (Transact-SQL).

Opmerkingen

FULLTEXTCATALOGPROPERTY ('catalog_name', 'IndexSize') bekijkt alleen fragmenten met status 4 of 6 zoals weergegeven in sys.fulltext_index_fragments. Deze fragmenten maken deel uit van de logische index. Als zodanig geeft de eigenschap IndexSize alleen de logische indexgrootte terug.

Tijdens een indexfusie kan de werkelijke indexgrootte echter het dubbele zijn van de logische grootte. Om de daadwerkelijke grootte te vinden die tijdens een merge door een full-text index wordt verbruikt, gebruik je de procedure sp_spaceused system stored procedure. Die procedure bekijkt alle fragmenten die bij een full-text index horen.

De volledige tekst populatie kan falen. Het kan falen als je de groei van het full-text catalogusbestand beperkt en niet genoeg ruimte toestaat voor het samenvoegproces. In dit geval geeft FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') 0 terug en wordt de volgende foutmelding in het full-text logboek geschreven:

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.

Het is belangrijk dat applicaties niet in een strakke lus wachten om te controleren of de PopulateStatus-eigenschap inactief raakt. Inactief worden betekent dat de bevolking is gegroeid. Deze controle haalt CPU-cycli weg van de database- en full-text zoekprocessen en veroorzaakt time-outs. Het is meestal een betere optie om de bijbehorende PopulateStatus-eigenschap op tabelniveau, TableFullTextPopulateStatus , in de systeemfunctie OBJECTPROPERTYEX te controleren. Deze en andere nieuwe full-text eigenschappen in OBJECTPROPERTYEX bieden meer gedetailleerde informatie over full-text indexeringstabellen. Zie OBJECTPROPERTYEX (Transact-SQL) voor meer informatie.

Voorbeelden

Het volgende voorbeeld geeft het aantal full-text geïndexeerde items terug in een full-text catalogus genaamd Cat_Desc.

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

Zie ook

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Metagegevensfuncties (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)