FULLTEXTCATALOGPROPERTY (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen Örneği

SQL Server'daki tam metin katalog özellikleri hakkında bilgi döndürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')  

Arguments

Uyarı

SQL Server'ın gelecekteki bir sürümünde aşağıdaki özellikler kaldırılacaktır: LogSize ve PopulateStatus. Bu özellikleri yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bunlardan herhangi birini kullanan uygulamaları değiştirmeyi planlayın.

catalog_name
Tam metin kataloğunun adını içeren bir ifadedir.

özellik
Tam metin katalog özelliğinin adını içeren bir ifadedir. Tablo özellikleri listeliyor ve geri gönderilen bilgilerin açıklamalarını sunar.

Mülkiyet	Description
AccentSensitivity	Aksan hassasiyeti ayarı. 0 = Aksan duyarsızlığı 1 = Aksan hassasiyeti
IndexSize	Tam metin kataloğunun mantıksal boyutu megabayt (MB) cinsinden. Anlamsal anahtar ifadelerin ve belge benzerlik indekslerinin boyutunu içerir. Daha fazla bilgi için, bu konunun ilerleyen bölümlerinde "Açıklamalar" bölümüne bakınız.
ItemCount	Katalogdaki tüm tam metin, anahtar ifade ve belge benzerlik indekslerini içeren indekslenen öğelerin sayısı
LogSize	Sadece geriye dönük uyumluluk için destekleniyor. Her zaman 0 döner. Microsoft Arama Servisi tam metin kataloğuyla ilişkili hata kayıtlarının birleşik setinin bayt cinsinden boyutu.
MergeStatus	Ana birleşme olup olmadığını gösterir. 0 = ana birleşme devam etmiyor 1 = ana birleşme devam ediyor
NüfusTamamlama Yaşı	Son tam metin indeks nüfusunun tamamlanması ile 01/01/1990 00:00:00 arasındaki saniye farkı. Sadece tam ve kademeli taramalar için güncelleniyor. Popülasyon oluşmadıysa 0 döner.
Nüfus Durumu	0 = Boşta 1 = Tam nüfus devam ediyor 2 = Duraklatıldı 3 = Kısılmış 4 = İyileşme 5 = Kapatma 6 = Artan nüfus devam ediyor 7 = Bina indeksi 8 = Disk dolu. Duraklatıldı. 9 = Değişim izleme
UniqueKeyCount	Tam metin katalogdaki benzersiz anahtar sayısı.
ImportStatus	Tam metin kataloğun içe aktarılıp aktarılmadığını gösterir. 0 = Tam metin katalog içe aktarılmıyor. 1 = Tam metin katalog içe aktarılıyor.

Dönüş Türleri

int

Exceptions

Hata durumunda veya arayan kişinin nesneyi görüntüleme izni yoksa NULL döndürür.

SQL Server'da bir kullanıcı yalnızca güvenliklerin meta verilerini görebilir. Bu güvenlikler, kullanıcının sahip olduğu veya kullanıcıya izin verilmiş olanlardır. Bu nedenle, meta veri yayan FULLTEXTCATALOGPROPERTY gibi yerleşik fonksiyonlar, kullanıcının nesne üzerinde herhangi bir izni yoksa NULL döndürebilir. Daha fazla bilgi için sp_help_fulltext_catalogs (Transact-SQL) bölümüne bakınız.

Açıklamalar

FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize'), sys.fulltext_index_fragments'de gösterildiği gibi sadece 4 veya 6 statüsüne sahip parçalara bakar. Bu parçalar mantıksal indeksin bir parçasıdır. Bu nedenle, IndexSize özelliği yalnızca mantıksal indeks boyutunu döndürür.

Ancak bir endeks birleştirme sırasında gerçek endeks boyutu mantıksal boyutunun iki katı olabilir. Birleştirme sırasında tam metin indeksinin tükettiği gerçek boyutu bulmak için sp_spaceused sistem depolanmış prosedürünü kullanın. Bu prosedür, tam metin indeksiyle ilişkili tüm parçaları inceler.

Tam metin popülasyonu başarısız olabilir. Tam metin katalog dosyasının büyümesini kısıtlarsanız ve birleştirme süreci için yeterli alan tanımıyorsanız arızalanabilir. Bu durumda, FULLTEXTCATALOGPROPERTY ('catalog_name','IndexSize') 0 döndürür ve tam metin günlüğüne aşağıdaki hata yazılır:

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.

Uygulamaların, PopulateStatus özelliğinin boşta kalıp kalmadığını kontrol etmek için sıkı bir döngüde beklememesi önemlidir. Boş kalmak, nüfusun tamamlandığını gösterir. Bu kontrol, CPU döngülerini veritabanından ve tam metin arama süreçlerinden uzaklaştırır ve zaman aşımına neden olur. Genellikle tablo düzeyinde ilgili PopulateStatus özelliğini, OBJECTPROPERTYEX sistem fonksiyonunda TableFullTextPopulateStatus olarak kontrol etmek daha iyi bir seçenektir. OBJECTPROPERTYEX'teki bu ve diğer yeni tam metin özellikleri, tam metin indeksleme tabloları hakkında daha ayrıntılı bilgiler sağlar. Daha fazla bilgi için bkz . OBJECTPROPERTYEX (Transact-SQL).

Örnekler

Aşağıdaki örnek, tam metin katalogda tam metin indekslenmiş öğelerin sayısını döndürür Cat_Desc.

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

Ayrıca Bkz.

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Meta Veri İşlevleri (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)