ALTER SEARCH PROPERTY LIST (Transact-SQL)

list_name

Nome dell'elenco di proprietà da modificare. list_name è un identificatore.

Per visualizzare i nomi degli elenchi delle proprietà esistenti, utilizzare la vista del catalogo sys.registered_search_property_lists, come illustrato di seguito:

Copia

SELECT name FROM sys.registered_search_property_lists;

ADD

Aggiunge una proprietà di ricerca specificata all'elenco delle proprietà specificato da list_name. La proprietà è registrata per l'elenco delle proprietà di ricerca. Prima di utilizzare le proprietà appena aggiunte per la ricerca di proprietà, è necessario ripopolare l'indice o gli indici full-text associati. Per ulteriori informazioni, vedere ALTER FULLTEXT INDEX (Transact-SQL).

Nota
Per aggiungere una proprietà di ricerca specificata a un elenco delle proprietà di ricerca, è necessario fornire i relativi ID int (property_int_id) e GUID del set di proprietà (property_set_guid). Per ulteriori informazioni, vedere Acquisizione di identificatori e GUID del set di proprietà" più avanti in questo argomento.

property_name

Specifica il nome da utilizzare per identificare la proprietà nelle query full-text. property_name deve identificare in modo univoco la proprietà all'interno del set di proprietà. Un nome di proprietà può contenere spazi interni. La lunghezza massima di property_name è di 256 caratteri. Questo nome può essere un nome descrittivo, ad esempio autore o indirizzo abitazione, oppure il nome canonico Windows della proprietà, ad esempio System.Author o System.Contact.HomeAddress.

Gli sviluppatori dovranno utilizzare il valore specificato per property_name per identificare la proprietà nel predicato CONTAINS. Pertanto, quando si aggiunge una proprietà è importante specificare un valore che rappresenti in modo significativo la proprietà definita dal GUID del set di proprietà specificato (property_set_guid) e l'identificatore di proprietà (property_int_id). Per ulteriori informazioni sui nomi di proprietà, vedere la sezione "Osservazioni" più avanti in questo argomento.

Per visualizzare i nomi di proprietà attualmente presenti in un elenco delle proprietà di ricerca del database corrente, utilizzare la vista del catalogo sys.registered_search_properties come segue:

Copia

SELECT property_name FROM sys.registered_search_properties;

PROPERTY_SET_GUID ='property_set_guid'

Specifica l'identificatore del set di proprietà a cui appartiene la proprietà. Si tratta di un identificatore univoco globale (GUID, Globally Unique Identifier). Per informazioni sull'acquisizione di questo valore, vedere la sezione "Osservazioni" più avanti in questo argomento.

Per visualizzare il GUID del set di proprietà di qualsiasi proprietà presente in un elenco delle proprietà di ricerca del database corrente, utilizzare la vista del catalogo sys.registered_search_properties, come illustrato di seguito:

Copia

SELECT property_set_guid FROM sys.registered_search_properties;

PROPERTY_INT_ID =property_int_id

Specifica il numero intero che identifica la proprietà all'interno del set di proprietà. Per informazioni sull'acquisizione di questo valore, vedere la sezione "Osservazioni".

Per visualizzare l'identificatore intero di qualsiasi proprietà presente in un elenco delle proprietà di ricerca del database corrente, utilizzare la vista del catalogo sys.registered_search_properties, come illustrato di seguito:

Copia

SELECT property_int_id FROM sys.registered_search_properties;

Nota
Una combinazione specificata di property_set_guid e property_int_id deve essere univoca in un elenco delle proprietà di ricerca. Se si tenta di aggiungere una combinazione esistente, l'operazione ALTER SEARCH PROPERTY ha esito negativo e viene restituito un errore. Ciò significa che è possibile definire un solo nome per una proprietà specificata.

PROPERTY_DESCRIPTION ='property_description'

Specifica una descrizione della proprietà definita dall'utente. property_description è una stringa composta da un massimo di 512 caratteri. Questa opzione è facoltativa.

DROP

Elimina la proprietà specificata dall'elenco delle proprietà specificato da list_name. L'eliminazione di una proprietà ne annulla la registrazione, pertanto non è più possibile effettuare ricerche che la riguardino.

Ogni indice full-text può disporre di un solo elenco delle proprietà di ricerca.

Per consentire l'esecuzione di query su una proprietà di ricerca specificata, è necessario aggiungerla all'elenco delle proprietà di ricerca dell'indice full-text, quindi ripopolare l'indice.

Quando si specifica una proprietà è possibile disporre le clausole PROPERTY_SET_GUID, PROPERTY_INT_ID e PROPERTY_DESCRIPTION in qualsiasi ordine, come elenco delimitato da virgole tra parentesi, ad esempio:

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 
      );

Nota
In questo esempio viene utilizzato il nome della proprietà, System.Author, che è simile al concetto dei nomi di proprietà canonici introdotti in Windows Vista (nome canonico di Windows).

Acquisizione dei valori delle proprietà

Ricerca delle proprietà aggiunte

L'aggiunta di una proprietà di ricerca a un elenco delle proprietà di ricerca ne comporta la registrazione. È possibile specificare immediatamente nelle query CONTAINS una proprietà appena aggiunta. Tuttavia, le query full-text con ambito proprietà su una proprietà appena aggiunta non restituiscono documenti finché l'indice full-text associato non viene ripopolato. Ad esempio, la query con ambito proprietà seguente eseguita su una proprietà appena aggiunta, new_search_property non restituisce documenti finché l'indice full-text associato alla tabella di destinazione (table_name) non viene ripopolato:

Copia

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

Per avviare un popolamento completo, utilizzare l'istruzione ALTER FULLTEXT INDEX (Transact-SQL) seguente:

Copia

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

Nota
Il ripopolamento non è necessario dopo l'eliminazione di una proprietà da un elenco di proprietà, perché solo le proprietà che rimangono nell'elenco delle proprietà di ricerca sono disponibili per le query full-text.

Per creare un elenco di proprietà

• CREATE SEARCH PROPERTY LIST (Transact-SQL)

Per eliminare un elenco di proprietà

• DROP SEARCH PROPERTY LIST (Transact-SQL)

Per aggiungere o rimuovere un elenco di proprietà in un indice full-text

• ALTER FULLTEXT INDEX (Transact-SQL)

Per eseguire un popolamento in un indice full-text

• ALTER FULLTEXT INDEX (Transact-SQL)

È necessario disporre dell'autorizzazione CONTROL per l'elenco di proprietà.

A.Aggiunta di una proprietà

Nell'esempio seguente vengono aggiunte diverse proprietà (Title, Author e Tags) a un elenco delle proprietà denominato DocumentPropertyList.

Nota
Per un esempio della creazione dell'elenco delle proprietà DocumentPropertyList, vedere CREATE SEARCH PROPERTY LIST (Transact-SQL).

Copia

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.' );

Nota
È necessario associare un elenco delle proprietà di ricerca specificato a un indice full-text prima di utilizzarlo per query con ambito proprietà. A tale scopo, utilizzare un'istruzione ALTER FULLTEXT INDEX e specificare la clausola SET SEARCH PROPERTY LIST.

B.Eliminazione di una proprietà

ALTER SEARCH PROPERTY LIST DocumentPropertyList
DROP 'Comments' ;

Riferimento

Concetti