Eventi
Ottieni gratuitamente la certificazione in Microsoft Fabric.
19 nov, 23 - 10 dic, 23
Per un periodo di tempo limitato, il team della community di Microsoft Fabric offre buoni per esami DP-600 gratuiti.
Prepara oraQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
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.
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.
Il processo di creazione e gestione di un indice full-text è definito popolamento (noto anche come ricerca per indicizzazione). Esistono tre tipi di popolamento dell'indice full-text:
Per altre informazioni sugli indici full-text, vedere Popolamento degli indici full-text.
Catalogo o vista a gestione dinamica | Descrizione |
---|---|
sys.fulltext_index_catalog_usages (Transact-SQL) | Restituisce una riga per ogni catalogo full-text in riferimento all'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 full-text di un oggetto in formato di tabella. |
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 sui popolamenti di indici full-text in corso. |
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.
Espandere Databasee quindi il database contenente 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. Verrà visualizzata la finestra di dialogo Proprietà indice full-text .
Nel riquadro Seleziona una pagina è possibile selezionare le pagine seguenti:
Pagina | Descrizione |
---|---|
Generali | Sono contenute 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: Elenco di parole non significative 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 per un processo di SQL Server Agent che consente di avviare un popolamento incrementale della tabella per i popolamenti dell'indice 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 Popolamento incrementale tabella in database_name.table_name). |
Seleziona OK per salvare le modifiche e uscire dalla finestra di dialogo Proprietà indice full-text.
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 in cui sono contenute le informazioni sui tipi di documenti della 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 full-text contenente i dati dell'indice full-text per la tabella. | OBJECTPROPERTYEX |
TableFulltextChangeTrackingOn | Indica se per la tabella è 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 | ID della colonna chiave univoca full-text. | 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 voci in sospeso del rilevamento delle modifiche da elaborare. | OBJECTPROPERTYEX |
TableFulltextPopulateStatus | Stato popolamento di una tabella full-text. | OBJECTPROPERTYEX |
TableHasActiveFulltextIndex | Indica se una tabella include un indice full-text attivo. | OBJECTPROPERTYEX |
In genere, il risultato della funzione con valori del set di righe CONTAINSTABLE o FREETEXTTABLE deve essere unito in join 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.
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.
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.
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';
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 Column
in 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.
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.
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.
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.
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. L'indicizzazione full-text viene disabilitata automaticamente nella tabella 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.
Espandere il gruppo di server, espandere Database, quindi il database contenente la tabella che si vuole abilitare per l'indicizzazione full-text.
Espandere Tabellee fare clic con il pulsante destro del mouse sulla tabella che si vuole disabilitare o riabilitare per l'indicizzazione full-text.
Seleziona Indice full-text, quindi fai clic su Disabilita indicizzazione full-text o Abilita indicizzazione full-text.
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 full-text.
Quando richiesto, seleziona OK per confermare l'eliminazione dell'indice full-text.
Eventi
Ottieni gratuitamente la certificazione in Microsoft Fabric.
19 nov, 23 - 10 dic, 23
Per un periodo di tempo limitato, il team della community di Microsoft Fabric offre buoni per esami DP-600 gratuiti.
Prepara ora