FULLTEXTCATALOGPROPERTY (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Információt ad az SQL Server teljes szöveges katalógustulajdonságairól.

Transact-SQL szintaxis konvenciók

Szemantika

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')  

Arguments

Megjegyzés:

A következő tulajdonságokat eltávolítják az SQL Server jövőbeli kiadásában: LogSize és PopulateStatus. Kerüld ezeknek a tulajdonságoknak az új fejlesztési munkáiban, és tervezd meg azokat az alkalmazásokat módosítani, amelyek jelenleg bármelyiküket használják.

catalog_name
Egy kifejezés, amely tartalmazza a teljes szöveges katalógus nevét.

ingatlan
Egy kifejezés, amely tartalmazza a teljes szöveges katalógus tulajdonság nevét. A táblázat felsorolja a tulajdonságokat és leírásokat ad a visszaküldött információkról.

Ingatlan	Description
AccentSensitivity	Akcentusérzékenység beállítás. 0 = Akcentusérzéketlen 1 = Akcentusérzékeny
IndexSize	A teljes szöveges katalógus logikai mérete megabájtokban (MB). Tartalmazza a szemantikai kulcsszavak és dokumentumhasonlósági indexek méretét. További információért lásd a "Megjegyzések" (Megjegyzések) című rész ebben a témában.
ItemCount	Az indexelt elemek száma, beleértve az összes teljes szöveget, kulcskifejezést és dokumentumhasonlósági indexet egy katalógusban
LogSize	Csak visszafelé kompatibilis támogatás van. Mindig 0-t ad. A Microsoft Search Service teljes szöveges katalógusához tartozó hibanaplók egyesített készletének mérete, bájtokban.
MergeStatus	Jelzi, hogy folyamatban van-e master merge. 0 = a master merge nincs folyamatban 1 = Master merge folyamatban van
NépességBefejezésKora	A másodpercek közötti különbség az utolsó teljes szöveges indexpopuláció befejezése és 1990.01.01.01 00:00 között. Csak teljes és fokozatos crawl-okhoz frissítve. 0-t ad, ha nem alakult ki populáció.
PopulateStatus	0 = Alapjárat 1 = Teljes népesség folyamatban 2 = Megállítva 3 = Megfojtva 4 = Helyreállítás 5 = Leállás 6 = Folyamatban lévő növekvő populáció 7 = Épületindex 8 = A lemez tele van. Szüneteltetett. 9 = Változáskövetés
UniqueKeyCount	A teljes szöveges katalógusban található egyedi kulcsok száma.
ImportStatus	Jelzi, hogy a teljes szöveges katalógusot importálják-e. 0 = A teljes szöveges katalógus nem importálódik. 1 = A teljes szöveges katalógust importálják.

Visszatérési típusok

int

Exceptions

Hibából vagy ha a hívónak nincs engedélye az objektum megtekintésére, NULL-t ad vissza.

Az SQL Serverben a felhasználó csak a biztonsági eszközök metaadatait tekintheti meg. Ezek a biztonsági eszközök olyanok, amelyeket a felhasználó birtokol, vagy amelyekre engedélyt kapott. Ennek megfelelően a beépített funkciók, amelyek metaadatokat bocsátanak ki, mint például a FULLTEXTCATALOGPROPERTY, visszaadhatják a NULL-t, ha a felhasználónak nincs engedélye az objektumra. További információért lásd sp_help_fulltext_catalogs (Transact-SQL).

Megjegyzések

A FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') csak 4 vagy 6 státuszú fragmentumokat vizsgálja, ahogy azt a sys.fulltext_index_fragments-ben látható. Ezek a töredékek a logikai index részei. Ennek megfelelően az IndexSize tulajdonság csak a logikai indexméretet adja vissza.

Az indexegyesítés során azonban a tényleges index mérete kétszerese lehet a logikai méretének. Ahhoz, hogy megtaláljuk, milyen méretet fogyaszt el egy teljes szöveges index az összevonás során, használjuk a sp_spaceused system stored eljárást. Ez az eljárás az összes teljes szöveges indexhez tartozó töredéket vizsgálja.

A teljes szöveges populáció megbukhat. Meghibásíthat, ha korlátozod a teljes szöveges katalógusfájl növekedését, és nem hagysz elég helyet az összeolvasztáshoz. Ebben az esetben a FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') 0-t ad vissza, és a következő hiba jelenik meg a teljes szöveges naplóba:

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.

Fontos, hogy az alkalmazások ne várjanak szoros körben, hogy ellenőrizzék, hogy a PopulateStatus tulajdonság tétlenné váljon. A tétlenség azt jelzi, hogy a népesség megnőtt. Ez a próba elveszi a CPU ciklusokat az adatbázistól és a teljes szöveges keresési folyamatoktól, és időkorlátokat okoz. Általában jobb opció a táblaszinten a megfelelő PopulateStatus tulajdonságot ellenőrizni, a TableFullTextPopulateStatus a OBJECTPROPERTYEX rendszerfüggvényben. Ez és más új teljes szöveges tulajdonságok az OBJECTPROPERTYEX-ben részletesebb információkat nyújtanak a teljes szöveges indexező táblákról. További információ: OBJECTPROPERTYEX (Transact-SQL).

Példák

A következő példa adja vissza a teljes szöveges indexelt elemek számát egy teljes szöveges katalógusban, amelynek neve Cat_Desc.

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

Lásd még:

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Metaadatfüggvények (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)