ALTER SEARCH PROPERTY LIST (Transact-SQL)

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

Belirli bir arama özelliğini belirlenen arama özellik listesine ekler veya çıkarır.

Syntax

ALTER SEARCH PROPERTY LIST list_name  
{  
   ADD 'property_name'  
     WITH   
      (   
          PROPERTY_SET_GUID = 'property_set_guid'  
        , PROPERTY_INT_ID = property_int_id  
      [ , PROPERTY_DESCRIPTION = 'property_description' ]  
      )  
 | DROP 'property_name'   
}  
;

Arguments

list_name
Mülk listesinin adı değiştiriliyor mu? list_name bir tanımlayıcıdır.

Mevcut mülk listelerinin isimlerini görmek için sys.registered_search_property_lists katalog görünümünü aşağıdaki gibi kullanın:

SELECT name FROM sys.registered_search_property_lists;

ADD
list_name tarafından belirtilen özellik listesine belirli bir arama özelliği ekler. Mülk, arama mülk listesi için kayıtlıdır. Yeni eklenen özelliklerin mülk araması için kullanılabilmesinden önce, ilgili tam metin indeks veya indeksler yeniden doldurulmalıdır. Daha fazla bilgi için bkz ALTER FULLTEXT INDEX . (Transact-SQL).

Uyarı

Belirli bir arama özelliğini arama özelliği listesine eklemek için, onun özellik kümesi GUID (property_set_guid) ve property int ID'sini (property_int_id) sağlamalısınız. Daha fazla bilgi için, bu konunun ilerleyen bölümlerinde "Property Set GUIDS ve Tanımlayıcıların Edinilmesi" bölümüne bakınız.

property_name
Tam metin sorgularında özelliği tanımlamak için kullanılacak adı belirtir. property_name özellik kümesi içindeki özelliği benzersiz şekilde tanımlamalıdır. Özellik adı iç boşluklar içerebilir. property_name maksimum uzunluğu 256 karakterdir. Bu isim, Yazar veya Ev Adresi gibi kullanıcı dostu bir isim olabilir ya da System.Author veya System.Contact.HomeAddress gibi Windows kanonik adı olabilir.

Geliştiriciler, CONTAINS predikatında mülkü tanımlamak için property_name için belirttiğiniz değeri kullanmaları gerekecek. Bu nedenle, bir özellik eklerken, belirtilen özellik kümesi GUID (property_set_guid) ve özellik tanımlayıcısı (property_int_id) tarafından tanımlanan özelliği anlamlı şekilde temsil eden bir değer belirtmek önemlidir. Mülk isimleri hakkında daha fazla bilgi için, bu konunun ilerleyen bölümlerinde "Açıklamalar" bölümüne bakınız.

Mevcut veritabanının arama özellik listesinde mevcut olan mülklerin isimlerini görmek için sys.registered_search_properties katalog görünümünü aşağıdaki gibi kullanın:

SELECT property_name FROM sys.registered_search_properties;

PROPERTY_SET_GUID ='property_set_guid'
Özelliğin ait olduğu özellik kümesinin tanımlayıcısını belirtir. Bu, küresel olarak benzersiz bir tanımlayıcıdır (GUID). Bu değeri elde etme hakkında bilgi için, bu konunun ilerleyen bölümlerinde "Açıklamalar" bölümüne bakınız.

Mevcut veritabanının arama özellik listesinde bulunan herhangi bir özelliğin GUID özellik kümesini görüntülemek için sys.registered_search_properties katalog görünümünü aşağıdaki gibi kullanın:

SELECT property_set_guid FROM sys.registered_search_properties;

PROPERTY_INT_ID =property_int_id
Özellik kümesi içindeki özelliği tanımlayan tam sayı belirtir. Bu değeri elde etme hakkında bilgi için "Açıklamalar" bölümüne bakınız.

Mevcut veritabanının arama özellik listesinde var olan herhangi bir özelliğin tamsayı tanımlayıcısını görmek için, sys.registered_search_properties katalog görünümünü aşağıdaki gibi kullanın:

SELECT property_int_id FROM sys.registered_search_properties;

Uyarı

Belirli bir property_set_guid ve property_int_id kombinasyonu, arama mülk listesinde benzersiz olmalıdır. Mevcut bir kombinasyonu eklemeye çalışırsanız, işlem ALTER SEARCH PROPERTY LIST başarısız olur ve hata çıkarır. Bu, belirli bir özellik için sadece bir isim tanımlayabileceğiniz anlamına gelir.

PROPERTY_DESCRIPTION ='property_description'
Özelliğin kullanıcı tanımlı bir tanımını belirtir. property_description , 512 karaktere kadar bir dizidir. Bu seçenek isteğe bağlıdır.

DROP
Belirtilen özellik, list_name tarafından belirtilen özellik listesinden çıkarılır. Bir mülkü düşürmek onu kayddan kaldırır ve artık aranamaz.

Remarks

Her tam metin indeksin yalnızca bir arama özelliği listesi olabilir.

Belirli bir arama özelliği üzerinde sorgulama yapmayı mümkün etmek için, onu tam metin indeksindeki arama özellik listesine eklemeli ve ardından indeksi yeniden doldurmalısınız.

Bir özellik belirlerken, PROPERTY_SET_GUID, PROPERTY_INT_ID ve PROPERTY_DESCRIPTION cümlelerini herhangi bir sırayla, parantez içinde virgülle ayrılmış bir liste olarak düzenleyebilirsiniz, örneğin:

ALTER SEARCH PROPERTY LIST CVitaProperties  
ADD 'System.Author'   
WITH (   
      PROPERTY_DESCRIPTION = 'Author or authors of a given document.',  
      PROPERTY_SET_GUID   = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9',   
      PROPERTY_INT_ID = 4   
      );

Uyarı

Bu örnek, Windows Vista'da tanıtılan kanonik özellik isimleri kavramına benzer System.Authorolan özellik adını kullanır (Windows kanonik adı).

Mülk Değerlerinin Elde Edilmesi

Tam metin arama, arama özelliğini GUID ve özellik tam sayı ID'si kullanarak tam metin indeksine eşler. Microsoft tarafından tanımlanmış özellikler için bunları nasıl elde edeceğinize dair bilgi için, Search Properties için Özellik Kümesi GUID'lerini ve Özellik Tamsayı ID'lerini Bul bölümüne bakınız. Bağımsız bir yazılım satıcısı (ISV) tarafından tanımlanan özellikler hakkında bilgi için söz konusu satıcının belgelerine bakın.

Eklenen Özelliklerin Aranabilir Hale Getirilmesi

Arama özelliğini arama özelliği listesine eklemek özelliği kaydeder. Yeni eklenen bir özellik, CONTAINS sorgularında hemen belirtilebilir. Ancak, yeni eklenen bir özellik üzerindeki özellik kapsamlı tam metin sorguları, ilgili tam metin indeks yeniden doldurulana kadar belgeleri döndürmez. Örneğin, yeni eklenen bir özellik new_search_property üzerindeki aşağıdaki özellik kapsamlı sorgu, hedef tablo (table_name) ile ilişkili tam metin indeks yeniden doldurulana kadar hiçbir belge döndürmez:

SELECT column_name  
FROM table_name  
WHERE CONTAINS( PROPERTY( column_name, 'new_search_property' ), 
               'contains_search_condition');  
GO

Tam bir popülasyon başlatmak için aşağıdaki ALTER FULLTEXT INDEX (Transact-SQL) ifadesini kullanın:

USE database_name;  
GO  
ALTER FULLTEXT INDEX ON table_name START FULL POPULATION;  
GO

Uyarı

Bir mülk listeden çıkarıldıktan sonra yeniden nüfuslandırma gerekmez, çünkü sadece arama mülk listesinde kalan mülkler tam metin sorgulama için kullanılabilir.

Bir mülk listesi oluşturmak için

Bir mülk listesini bırakmak için

Tam metin indeksinde bir özellik listesini eklemek veya kaldırmak için

Bir nüfusu tam metin bir indekste çalıştırmak

Permissions

Mülk listesinde CONTROL izni gerekiyor.

Examples

A. Bir özellik ekleme

Aşağıdaki örnek, . adlı bir özellik listesine Titlebirkaç özellik-Author, Tags, ve DocumentPropertyList-ekler.

Uyarı

Özellik listesi oluşturan DocumentPropertyList bir örnek için bkzCREATE SEARCH PROPERTY LIST. (Transact-SQL).

ALTER SEARCH PROPERTY LIST DocumentPropertyList  
   ADD 'Title'   
   WITH ( PROPERTY_SET_GUID = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', PROPERTY_INT_ID = 2,   
      PROPERTY_DESCRIPTION = 'System.Title - Title of the item.' );  
  
ALTER SEARCH PROPERTY LIST DocumentPropertyList   
    ADD 'Author'  
   WITH ( PROPERTY_SET_GUID = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', PROPERTY_INT_ID = 4,   
      PROPERTY_DESCRIPTION = 'System.Author - Author or authors of the item.' );  
  
ALTER SEARCH PROPERTY LIST DocumentPropertyList   
    ADD 'Tags'  
   WITH ( PROPERTY_SET_GUID = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', PROPERTY_INT_ID = 5,   
      PROPERTY_DESCRIPTION = 
          'System.Keywords - Set of keywords (also known as tags) assigned to the item.' );

Uyarı

Belirli bir arama özellik listesini, özellik kapsamlı sorgular için kullanmadan önce tam metin bir indeksle ilişkilendirmeniz gerekir. Bunu yapmak için bir ALTER FULLTEXT INDEX ifade kullanın ve maddeyi SETSEARCH PROPERTY LIST belirtin.

B. Bir mülkü düşürmek

Aşağıdaki örnek bu Comments özelliği özellik listesinden DocumentPropertyList çıkarır.

ALTER SEARCH PROPERTY LIST DocumentPropertyList  
DROP 'Comments' ;

İlgili içerik

  • Last updated on