sp_fulltext_column (Transact-SQL)

Sintassi

sp_fulltext_column [ @tabname= ] 'qualified_table_name' , 
     [ @colname= ] 'column_name' , 
     [ @action= ] 'action' 
     [ , [ @language= ] 'language_term' ] 
     [ , [ @type_colname= ] 'type_column_name' ]

Argomenti

• [ @tabname= ] 'qualified_table_name'
  Nome della tabella composto da una o due parti. La tabella deve esistere nel database corrente. e includere un indice full-text. qualified_table_name è di tipo nvarchar(517) e non prevede alcun valore predefinito.

• [ @colname= ] 'column_name'
  Nome di colonna in qualified_table_name. Deve essere una colonna di tipo carattere, varbinary(max) o image e non deve essere calcolata. column_name è di tipo sysname e non prevede alcun valore predefinito.

  Nota

  SQL Server supporta la creazione di indici full-text dei dati di testo archiviati nelle colonne di tipo varbinary(max) o image. Le immagini non vengono indicizzate.

• [ @action = ] 'action'
  Azione da eseguire. action è di tipo varchar(20) e non prevede alcun valore predefinito. I possibili valori sono i seguenti.

  Valore	Descrizione
  add	Aggiunge column_name di qualified_table_name all'indice full-text inattivo della tabella. Questa azione abilita la colonna per l'indicizzazione full-text.
  drop	Rimuove column_name di qualified_table_name dall'indice full-text inattivo della tabella.

• [ @language = ] 'language_term'
  Lingua dei dati archiviati nella colonna. Per un elenco delle lingue incluse in SQL Server, vedere sys.fulltext_languages (Transact-SQL).

  Nota

  Se una colonna include dati in più lingue o in una lingua non supportata, utilizzare la lingua neutra. Il valore predefinito è specificato nell'opzione di configurazione "default full-text language".

• [ @type_colname = ] 'type_column_name'
  Nome della colonna in qualified_table_name contenente il tipo di documento di column_name. Tale colonna deve essere di tipo char, nchar, varchar o nvarchar. Viene utilizzato solo quando column_name è di tipo varbinary(max) o image. type_column_name è di tipo sysname e non prevede alcun valore predefinito.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

Se l'indice full-text è attivo, l'eventuale processo di popolamento in corso viene arrestato. Inoltre, se in una tabella con indice full-text attivo è abilitato il rilevamento delle modifiche, SQL Server assicura che l'indice sia aggiornato. Ad esempio, SQL Server arresta l'eventuale processo di popolamento in corso nella tabella, elimina l'indice esistente e avvia un nuovo popolamento.

Se il rilevamento delle modifiche è attivato e devono essere aggiunte o eliminate colonne dall'indice full-text conservando tuttavia l'indice, è necessario disattivare la tabella, quindi aggiungere ed eliminare le colonne appropriate. In seguito a queste azioni l'indice viene bloccato. È quindi possibile attivare la tabella in un momento successivo, quando è opportuno avviare un processo di popolamento.

Autorizzazioni

L'utente deve essere membro del ruolo predefinito del database db_ddladmin o db_owner, oppure il proprietario della tabella.

Esempi

Nell'esempio seguente la colonna DocumentSummary della tabella Document viene aggiunta all'indice full-text della tabella.

USE AdventureWorks2008R2;
GO
EXEC sp_fulltext_column 'Production.Document', DocumentSummary, 'add';
GO

Nell'esempio seguente si presuppone che sia stato creato un indice full-text nella tabella spanishTbl. Per aggiungere la colonna spanishCol all'indice full-text, eseguire la stored procedure seguente:

EXEC sp_fulltext_column 'spanishTbl', 'spanishCol', 'add', 0xC0A;
GO

Quando si esegue la seguente query:

SELECT * 
FROM spanishTbl 
WHERE CONTAINS(spanishCol, 'formsof(inflectional, trabajar)')

Il set di risultati deve includere le righe contenenti forme diverse del verbo spagnolo trabajar (lavorare), ad esempio trabajo, trabajamos e trabajan.

Vedere anche

Riferimento