FULLTEXTCATALOGPROPERTY (Transact-SQL)

platí pro: SQL Server Azure SQL DatabaseAzure SQL Managed Instance

Vrací informace o vlastnostech plnotextového katalogu v SQL Serveru.

Transact-SQL konvence syntaxe

Syntaxe

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')  

Arguments

Poznámka:

Následující vlastnosti budou odstraněny v budoucím vydání SQL Serveru: LogSize a PopulateStatus. Vyhněte se používání těchto vlastností v novém vývoji a plánujte upravovat aplikace, které je již používají.

catalog_name
Je výraz obsahující název katalogu s plným textem.

vlastnost
Je výraz obsahující název vlastnosti katalogu s plným textem. Tabulka uvádí vlastnosti a popisuje vrácené informace.

Vlastnictví	Description
AccentSensitivity	Nastavení citlivosti na přízvuk. 0 = Necitlivý přízvuk 1 = Citlivý na přízvuk
IndexSize	Logická velikost katalogu plného textu v megabajtech (MB). Zahrnuje velikost indexů sémantických klíčových frází a podobností dokumentů. Pro více informací viz "Poznámky" později v tomto tématu.
ItemCount	Počet indexovaných položek včetně všech indexů podobnosti plného textu, klíčových frází a dokumentů v katalogu
LogSize	Podporováno pouze pro zpětnou kompatibilitu. Vždy vrací 0. Velikost v bajtech kombinované sady chybových logů spojených s katalogem plnotextového Microsoft Search Service.
MergeStatus	Označuje, zda probíhá hlavní sloučení. 0 = Master merge není v procesu 1 = probíhá hlavní slučování
PopulateCompletionAge	Rozdíl v sekundách mezi dokončením poslední populace indexu plného textu a 01/01/1990 00:00:00. Aktualizováno jen pro plné a postupné procházení. Vrátí 0, pokud nedošlo k žádné populaci.
PopulateStatus	0 = Nečinnost 1 = Plná populace v procesu 2 = Pozastaveno 3 = Omezeno 4 = Obnova 5 = Vypnutí 6 = Postupná populace v procesu 7 = Index budovy 8 = Disk je plný. Pozastaveno. 9 = Sledování změn
UniqueKeyCount	Počet unikátních klíčů v katalogu s plným textem.
ImportStatus	Označuje, zda je katalog s plným textem importován. 0 = Katalog s plným textem není importován. 1 = Katalog s plným textem je importován.

Návratové typy

int

Exceptions

Vrací NULL při chybě nebo pokud volající nemá oprávnění objekt vidět.

V SQL Serveru může uživatel zobrazit pouze metadata securables. Tyto zabezpečené jsou ty, které uživatel vlastní nebo na které mu bylo uděleno oprávnění. Vestavěné funkce, které generují metadata, například FULLTEXTCATALOGPROPERTY, mohou vrátit NULL, pokud uživatel nemá žádné oprávnění k objektu. Pro více informací viz sp_help_fulltext_catalogs (Transact-SQL).

Poznámky

FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') se dívá pouze na fragmenty se stavem 4 nebo 6, jak je ukázáno v sys.fulltext_index_fragments. Tyto fragmenty jsou součástí logického indexu. Vlastnost IndexSize tedy vrací pouze velikost logického indexu.

Při sloučení indexu však může být skutečná velikost indexu dvojnásobná oproti logické. Pro zjištění skutečné velikosti, kterou během sloučení spotřebovává fulltextový index, použijte proceduru sp_spaceused systemově uložené. Tento postup se zaměřuje na všechny fragmenty spojené s indexem plného textu.

Populace plného textu může selhat. Může selhat, pokud omezíte růst souboru s plnotextovým katalogem a nenecháte dostatek místa pro proces sloučení. V tomto případě FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') vrátí 0 a do logu plného textu se zaznamená následující chyba:

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.

Je důležité, aby aplikace nečekali v úzké smyčce a nekontrolovali, zda vlastnost PopulateStatus nepřestane fungovat. Nečinnost znamená, že populace skončila. Tato kontrola odvádí CPU cykly od databázového a fulltextového vyhledávání a způsobuje timeouty. Obvykle je lepší zkontrolovat odpovídající vlastnost PopulateStatus na úrovni tabulky, TableFullTextPopulateStatus v systémové funkciji OBJECTPROPERTYEX. Tato a další nové vlastnosti plnotextového textu v OBJECTPROPERTYEX poskytují podrobnější informace o tabulkách indexování plného textu. Další informace naleznete v tématu OBJECTPROPERTYEX (Transact-SQL).

Examples

Následující příklad vrací počet indexovaných položek v plnotextovém katalogu s názvem Cat_Desc.

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

Viz také

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Funkce metadat (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)