Creare e gestire indici a testo completo

Articolo
03/05/2025

Si applica a:SQL Server Database SQL di Azure Istanza gestita di SQL di Azure

Questo argomento descrive come creare, compilare e gestire gli indici full-text in SQL Server.

Creare un catalogo di testo completo

Prima di poter creare un indice full-text è necessario che sia disponibile un catalogo full-text. Il catalogo è un contenitore virtuale per uno o più indici full-text. Per altre informazioni, vedere Creare e gestire cataloghi full-text.

Creare, modificare o eliminare un indice full-text

Popolare un indice full-text

Il processo di creazione e gestione di un indice full-text è definito popolamento (noto anche come scansione). Esistono tre tipi di popolamento dell'indice full-text:

Popolamento completo
Popolamento basato sul tracciamento delle modifiche
Popolamento incrementale basato su timestamp.

Per altre informazioni sugli indici full-text, vedere Popolamento degli indici full-text.

Visualizzare le proprietà di un indice full-text

Visualizzare le proprietà di un indice full-text con Transact-SQL

Catalogo o vista di gestione dinamica	Descrizione
sys.fulltext_index_catalog_usages (Transact-SQL)	Restituisce una riga per ogni catalogo full-text che fa riferimento a un indice full-text.
sys.fulltext_index_columns (Transact-SQL)	Contiene una riga per ogni colonna che fa parte di un indice full-text.
sys.fulltext_index_fragments (Transact-SQL)	Un indice full-text utilizza tabelle interne denominate frammenti di indice full-text per archiviare i dati dell'indice invertito. Questa vista può essere utilizzata per eseguire una query sui metadati relativi a tali frammenti. Nella vista è contenuta una riga per ogni frammento di indice full-text presente in ogni tabella contenente un indice full-text.
sys.fulltext_indexes (Transact-SQL)	Contiene una riga per indice di testo completo di un oggetto tabellare.
sys.dm_fts_index_keywords (Transact-SQL)	Restituisce informazioni sul contenuto di un indice full-text per la tabella specificata.
sys.dm_fts_index_keywords_by_document (Transact-SQL)	Restituisce informazioni sul contenuto a livello di documento di un indice full-text per la tabella specificata. Una determinata parola chiave può essere inclusa in diversi documenti.
sys.dm_fts_index_population (Transact-SQL)	Restituisce informazioni sulle operazioni di popolamento degli indici full-text in corso.

Visualizzare le proprietà di un indice full-text con SQL Server Management Studio

Nota

Per visualizzare le proprietà degli indici full-text per i database SQL di Azure, usa Transact-SQL.

In SQL Server Management Studio, in Esplora oggetti, espandi il server.
Espandi Database, e quindi espandi il database che contiene l'indice full-text.
Espandere Tabelle.
Fai clic con il pulsante destro del mouse sulla tabella in cui viene definito l'indice full-text, scegli Indice full-text e quindi Proprietà dal menu di scelta rapida Indice full-text. Si apre la finestra di dialogo Proprietà del testo integrale.

Nel riquadro Seleziona una pagina è possibile selezionare le pagine seguenti:

Pagina	Descrizione
Generali	Visualizza le proprietà di base dell'indice full-text. Include diverse proprietà modificabili e alcune proprietà non modificabili quali il nome del database, il nome della tabella e il nome della colonna chiave full-text. Le proprietà modificabili sono le seguenti: Stoplist per l'indice full-text Indicizzazione full-text abilitata Registrazione modifiche Elenco delle proprietà di ricerca
Colonne	Consente di visualizzare le colonne della tabella disponibili per l'indicizzazione full-text. La colonna o le colonne selezionate contengono indici full-text. È possibile selezionare il numero desiderato di colonne disponibili da includere nell'indice full-text. Per altre informazioni, vedere Popolare gli indici full-text.
Pianificazioni	Utilizzare questa pagina per creare o gestire le pianificazioni di un'attività di SQL Server Agent che avvia un popolamento incrementale delle tabelle per gli indici full-text. Per altre informazioni, vedere Popolare gli indici full-text. Nota: dopo avere chiuso la finestra di dialogo Proprietà indice full-text, eventuali nuove pianificazioni vengono associate a un processo di SQL Server Agent (avviare il popolamento incrementale della tabella su database_name.table_name).

Seleziona OK per salvare le modifiche e uscire dalla finestra di dialogo Proprietà indice full-text.

Visualizzare le proprietà di tabelle e colonne indicizzate

Per ottenere il valore di diverse proprietà di indicizzazione full-text, è possibile utilizzare varie funzioni Transact-SQL come OBJECTPROPERTYEX. Queste informazioni sono utili per l'amministrazione e la risoluzione dei problemi relativi alla ricerca full-text.

Nella tabella seguente sono elencate le proprietà full-text relative a tabelle e colonne indicizzate e le funzioni Transact-SQL correlate.

Proprietà	Descrizione	Funzione
FullTextTypeColumn	TYPE COLUMN nella tabella che contiene le informazioni sul tipo di documento relative alla colonna.	COLUMNPROPERTY
IsFulltextIndexed	Indica se una colonna è stata abilitata per l'indicizzazione full-text.	COLUMNPROPERTY
IsFulltextKey	Indica se l'indice è la chiave full-text di una tabella.	INDEXPROPERTY
TableFulltextBackgroundUpdateIndexOn	Indica se per una tabella è stata impostata l'indicizzazione full-text degli aggiornamenti in background.	OBJECTPROPERTYEX
TableFulltextCatalogId	ID del catalogo del testo completo in cui risiedono i dati dell'indice full-text per la tabella.	OBJECTPROPERTYEX
TableFulltextChangeTrackingOn	Viene verificato se una tabella ha abilitato il rilevamento delle modifiche full-text.	OBJECTPROPERTYEX
TableFulltextDocsProcessed	Numero di righe elaborate dopo l'avvio dell'indicizzazione full-text.	OBJECTPROPERTYEX
TableFulltextFailCount	Numero di righe non indicizzate dalla ricerca full-text.	OBJECTPROPERTYEX
TableFulltextItemCount	Numero di righe per cui l'indicizzazione full-text ha avuto esito positivo.	OBJECTPROPERTYEX
TableFulltextKeyColumn	L'ID della colonna full-text della chiave univoca.	OBJECTPROPERTYEX
TableFullTextMergeStatus	Indica se in una tabella che dispone di un indice full-text è attualmente in corso un'operazione di unione.	OBJECTPROPERTYEX
TableFulltextPendingChanges	Numero di registrazioni in sospeso del rilevamento delle modifiche per l'elaborazione.	OBJECTPROPERTYEX
TableFulltextPopulateStatus	Stato del popolamento di una tabella a testo completo.	OBJECTPROPERTYEX
LaTabellaHaIndiceTestoCompletoAttivo	Indica se una tabella include un indice full-text attivo.	OBJECTPROPERTYEX

Ottenere informazioni sulla colonna chiave a testo completo

In genere, il risultato delle funzioni che restituiscono un set di righe CONTAINSTABLE o FREETEXTTABLE deve essere unito alla tabella di base. In questi casi, è necessario conoscere il nome della colonna chiave univoca. È possibile verificare se un determinato indice univoco viene utilizzato come chiave full-text e ottenere l'identificatore della colonna chiave full-text.

Determinare se un indice univoco specifico viene utilizzato come colonna chiave full-text.

Usare un'istruzione SELECT per chiamare la funzione INDEXPROPERTY. Nella chiamata alla funzione, usa la funzione OBJECT_ID per convertire il nome della tabella (table_name) nell'ID tabella, specificare il nome di un indice univoco per la tabella, quindi specificare la proprietà di indice IsFulltextKey come illustrato di seguito:

SELECT INDEXPROPERTY(OBJECT_ID('table_name'), 'index_name',  'IsFulltextKey');

L'istruzione restituisce 1 se l'indice viene utilizzato per applicare l'unicità della colonna chiave full-text e 0 in caso contrario.

Esempio

Nell'esempio seguente viene illustrato come verificare se l'indice PK_Document_DocumentNode viene utilizzato per applicare l'univocità della colonna chiave full-text:

USE AdventureWorks2022;
GO
SELECT INDEXPROPERTY(OBJECT_ID('Production.Document'), 'PK_Document_DocumentNode',  'IsFulltextKey');

In questo esempio viene restituito 1 se l'indice PK_Document_DocumentNode viene utilizzato per applicare l'univocità della colonna chiave full-text. In caso contrario, viene restituito 0 o NULL. NULL indica che è in uso un nome di indice non valido, il nome dell'indice non corrisponde alla tabella, la tabella non esiste e così via.

Trovare l'identificatore della colonna chiave del testo completo

Ogni tabella abilitata per la funzionalità full-text include una colonna che viene usata per applicare righe univoche per la tabella (la colonna chiave univoca). La proprietà TableFulltextKeyColumn, ottenuta dalla funzione OBJECTPROPERTYEX contiene l'ID della colonna chiave univoca.

Per ottenere questo identificatore, è possibile utilizzare un'istruzione SELECT per chiamare la funzione OBJECTPROPERTYEX. Usare la funzione OBJECT_ID per convertire il nome della tabella (table_name) nell'ID tabella e specificare la proprietà TableFulltextKeyColumn come illustrato di seguito:

SELECT OBJECTPROPERTYEX(OBJECT_ID('table_name'), 'TableFulltextKeyColumn' ) AS 'Column Identifier';

Esempi

Nell'esempio seguente viene restituito l'identificatore della colonna chiave full-text o NULL. NULL indica che è in uso un nome di indice non valido, il nome dell'indice non corrisponde alla tabella, la tabella non esiste e così via.

USE AdventureWorks2022;
GO
SELECT OBJECTPROPERTYEX(OBJECT_ID('Production.Document'), 'TableFulltextKeyColumn');
GO

Nell'esempio seguente viene illustrato come utilizzare l'identificatore della colonna chiave univoca per ottenere il nome della colonna.

USE AdventureWorks2022;
GO

DECLARE @key_column SYSNAME

SET @key_column = COL_NAME(OBJECT_ID('Production.Document'),
   OBJECTPROPERTYEX(OBJECT_ID('Production.Document'), 'TableFulltextKeyColumn'));

SELECT @key_column AS 'Unique Key Column';
GO

Nell'esempio viene restituita una colonna del set di risultati denominata Unique Key Columnin cui viene visualizzata una sola riga contenente il nome della colonna chiave univoca della tabella Document, DocumentNode. Se questa query contenesse un nome di indice non valido, il nome di indice non corrispondesse alla tabella, la tabella non esistesse e così via, il risultato restituito sarebbe NULL.

Indicizzare le colonne varbinary(max) e XML

Se una colonna varbinary(max), varbinaryo xml viene sottoposta a indicizzazione full-text, le query su questa colonna possono essere eseguite usando predicati (CONTAINS e FREETEXT) e funzioni (CONTAINSTABLE e FREETEXTTABLE) full-text, proprio come su ogni altra colonna con indicizzazione full-text.

Indicizzare varbinary(max) o dati varbinary

In una singola colonna varbinary(max) o varbinary possono essere archiviati molti tipi di documenti. SQL Server supporta qualsiasi tipo di documento per cui è installato un filtro disponibile nel sistema operativo. Il tipo di ogni documento è identificato dall'estensione file relativa. Per un'estensione file doc, ad esempio, la ricerca full-text utilizza il filtro che supporta i documenti di Microsoft Word. Per un elenco dei tipi di documento disponibili, eseguire una query sulla vista del catalogo sys.fulltext_document_types .

Il motore di ricerca full-text può utilizzare i filtri esistenti installati nel sistema operativo. Prima di poter utilizzare i filtri, i word breaker e gli stemmer del sistema operativo, è necessario caricarli nell'istanza del server, come illustrato di seguito:

EXEC sp_fulltext_service @action = 'load_os_resources', @value = 1;

Per creare un indice full-text in una colonna varbinary(max) , il motore di ricerca full-text deve accedere alle estensioni file dei documenti nella colonna varbinary(max) . Queste informazioni devono essere archiviate in una colonna di tabella, denominata colonna del tipo, che deve essere associata alla colonna varbinary(max) nell'indice full-text. Quando si esegue l'indicizzazione di un documento, il motore di ricerca full-text utilizza l'estensione del file nella colonna del tipo per identificare il filtro da utilizzare.

Indicizzare i dati XML

In una colonna del tipo di dati xml vengono archiviati esclusivamente documenti e frammenti XML e per i documenti viene usato solo il filtro XML. Una colonna del tipo non è pertanto necessaria. Nelle colonne xml , l'indice full-text indicizza il contenuto degli elementi XML, ma ignora il markup XML. Ai valori di attributo viene applicata l'indicizzazione full-text a meno che non siano valori numerici. I tag degli elementi vengono utilizzati come limiti dei token. Sono supportati documenti e frammenti XML o HTML ben formati e contenenti più lingue.

Per altre informazioni sull'indicizzazione e l'esecuzione di query su una colonna xml , vedere Usare la ricerca full-text con colonne XML.

Disabilitare o riabilitare l'indicizzazione full-text per una tabella

In SQL Server, per impostazione predefinita, tutti i database creati dall'utente sono abilitati per la funzionalità full-text. Una tabella viene inoltre abilitata automaticamente per l'indicizzazione full-text dopo la creazione di un indice full-text nella tabella e l'aggiunta di una colonna all'indice. Una tabella viene disabilitata automaticamente per l'indicizzazione full-text quando l'ultima colonna viene eliminata dall'indice full-text.

In una tabella che dispone di un indice full-text, puoi disabilitare o riabilitare manualmente una tabella per l’indicizzazione full-text usando SQL Server Management Studio.

Espandi il gruppo di server, espandi Database, ed espandi il database contenente la tabella che si vuole abilitare per l'indicizzazione a testo completo.
Espandere Tabelle e fare clic con il pulsante destro del mouse sulla tabella che si vuole disabilitare o riabilitare per l'indicizzazione a testo completo.
Seleziona Indice full-text, quindi fai clic su Disabilita indicizzazione full-text o Abilita indicizzazione full-text.

Rimuovere un indice full-text da una tabella

In Esplora oggetti fare clic con il pulsante destro del mouse sulla tabella contenente l'indice full-text che si desidera eliminare.
Selezionare Elimina indice a testo completo.
Quando richiesto, seleziona OK per confermare l'eliminazione dell'indice full-text.

Condividi tramite