sp_fulltext_service (Transact-SQL)

2025-07-23

Applies to:SQL Server

Modifica le proprietà di ricerca full-text del server per SQL Server.

Caution

L'azione upgrade_option non è completamente supportata in SQL Server 2022 (16.x) e versioni successive. Per altre informazioni, vedere la sezione Compatibilità con SQL Server 2022 e versioni successive più avanti in questo articolo.

Convenzioni relative alla sintassi Transact-SQL

Syntax

sp_fulltext_service
    [ [ @action = ] N'action' ]
    [ , [ @value = ] value ]
[ ; ]

Arguments

[ @action = ] N'action'

Proprietà da modificare o reimpostare. @action is nvarchar(100), with no default. For a list of @action properties, their descriptions, and the values that can be set, see the table under the @value argument.

Questo argomento restituisce le proprietà seguenti:

data type
valore corrente in esecuzione
valore minimo o massimo
stato di deprecazione, se applicabile.

[ @value = ] value

@value is sql_variant, with a default of NULL.

Valore della proprietà specificata. @value is sql_variant, with a default value of NULL. If @value is null, sp_fulltext_service returns the current setting. In questa tabella sono elencate le proprietà, le descrizioni e i valori che è possibile impostare.

Note

Le azioni seguenti verranno rimosse in una versione futura di SQL Server: clean_up, connect_timeout, data_timeoute resource_usage. Evitare di utilizzare queste azioni in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui attualmente vengono utilizzate.

Action	Data type	Description
`clean_up`	int	Supportato unicamente per compatibilità con le versioni precedenti. Il valore è sempre `0`.
`connect_timeout`	int	Supportato unicamente per compatibilità con le versioni precedenti. Il valore è sempre `0`.
`data_timeout`	int	Supportato unicamente per compatibilità con le versioni precedenti. Il valore è sempre `0`.
`load_os_resources`	int	Indica se i word breaker, gli stemmer e i filtri del sistema operativo vengono registrati e usati con questa istanza di SQL Server. One of: `0` = Usare solo filtri e word breaker specifici di questa istanza di SQL Server. `1` = Caricare i filtri del sistema operativo e i word breaker. Per impostazione predefinita, questa proprietà è disabilitata per evitare modifiche accidentali del sistema operativo. L'abilitazione dell'uso delle risorse del sistema operativo consente l'accesso alle risorse per le lingue e i tipi di documento registrati con il servizio di indicizzazione Microsoft in cui non è installata una risorsa specifica dell'istanza. Se si abilita il caricamento delle risorse del sistema operativo, assicurarsi che le risorse del sistema operativo siano file binari firmati attendibili; in caso contrario, non possono essere caricati quando `verify_signature` è impostato su `1`.
`master_merge_dop`	int	Specifica il numero di thread che deve essere utilizzato dal processo di unione nell'indice master. Questo valore non deve superare il numero di CPU o core CPU disponibili. Quando questo argomento non viene specificato, il servizio usa il minore di `4`o il numero di CPU o core CPU disponibili.
`pause_indexing`	int	Specifica se l'indicizzazione full-text deve essere sospesa, se è attualmente in esecuzione o ripresa, se è attualmente sospesa. `0` = Riprende le attività di indicizzazione full-text per l'istanza del server. `1` = Sospende le attività di indicizzazione full-text per l'istanza del server.
`resource_usage`	int	Non dispone di alcuna funzione in SQL Server 2008 (10.0.x) e versioni successive e viene ignorata.
`update_languages`	`NULL`	Aggiorna l'elenco di lingue e filtra quelle registrate per la ricerca full-text. Le lingue vengono specificate quando si configura l'indicizzazione e nelle query full-text. Filters are used by the filter daemon host to extract textual information from corresponding file formats such as `.docx` stored in data types, such as varbinary, varbinary(max), image, or xml, for full-text indexing. Per altre informazioni, vedere Visualizzare o modificare i filtri registrati e i word breaker.
`upgrade_option`	int	Controlla la modalità di migrazione degli indici full-text durante l'aggiornamento di un database da SQL Server 2005 (9.x) a una versione successiva. Questa proprietà si applica ai casi in cui viene eseguito l'aggiornamento tramite il collegamento di un database, il ripristino di un backup di database o di un backup di file oppure la copia del database tramite la Copia guidata database. One of: - `0` = I cataloghi full-text vengono ricompilati usando i word breaker nuovi e avanzati. La ricompilazione degli indici può richiedere del tempo e potrebbe essere necessaria una quantità significativa di CPU e memoria dopo l'aggiornamento. - `1` = I cataloghi full-text vengono reimpostati. I file del catalogo full-text di SQL Server 2005 (9.x) vengono rimossi, ma i metadati per i cataloghi e per gli indici full-text vengono mantenuti. Dopo l'aggiornamento, tutti gli indici full-text vengono disabilitati per il rilevamento delle modifiche e le ricerche per indicizzazione non vengono avviate automaticamente. Il catalogo resterà vuoto fino a quando non si eseguirà manualmente un popolamento completo al termine dell'aggiornamento. - `2` = I cataloghi full-text vengono importati. In genere, l'importazione è più veloce rispetto alla ricompilazione. Se ad esempio si utilizza solo una CPU, l'importazione è di circa 10 volte più veloce della ricompilazione. Tuttavia, un catalogo full-text importato non usa i word breaker nuovi e avanzati, quindi potrebbe essere necessario ricompilare i cataloghi full-text. Rimosso in SQL Server 2022 (16.x) e versioni successive e genera un errore. Note: Rebuild can run in multi-threaded mode, and if more than 10 CPUs are available, rebuild might run faster than import if you allow rebuild to use all of the CPUs. Se non è disponibile un catalogo full-text, gli indici full-text associati vengono ricompilati. Questa opzione è disponibile solo per i database di SQL Server 2005 (9.x). Per informazioni sulla scelta dell'opzione di aggiornamento full-text, vedereAggiornare la ricerca full-text. Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. Per altre informazioni, vedere Gestione e monitoraggio della ricerca full-text per un'istanza del server.
`verify_signature` ¹	int	Indica se il motore full-text carica solo file binari firmati. Per impostazione predefinita vengono caricati solo i file binari firmati attendibili. `1` = Verificare che vengano caricati solo file binari attendibili e firmati (impostazione predefinita). `0` = Non verificare se i file binari sono firmati.

¹ When verify_signature is 1, the Full-Text Engine only checks the cached Certificate Revocation List (CRL) before loading binaries. You should periodically refresh your local CRL cache with certutil, when using third party binaries.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Result set

None.

Compatibilità con SQL Server 2022 e versioni successive

La funzionalità di importazione nell'azione upgrade_option (specificata da @action = 'upgrade_option', @value = 2) viene rimossa in SQL Server 2022 (16.x) e versioni successive. Se è necessario importare un indice full-text da una versione precedente di SQL Server, è possibile importarlo usando SQL Server 2019 (15.x) o versioni precedenti e quindi eseguire l'aggiornamento a SQL Server 2022 (16.x).

Permissions

Only members of the serveradmin fixed server role or the system administrator can execute sp_fulltext_service.

Examples

A. Aggiornare l'elenco delle lingue registrate

Nell'esempio seguente viene aggiornato l'elenco di lingue registrate per la ricerca full-text.

EXECUTE sp_fulltext_service 'update_languages';
GO

B. Modificare l'opzione di aggiornamento full-text per reimpostare i cataloghi full-text

Nell'esempio seguente viene modificata l'opzione di aggiornamento full-text per reimpostare i cataloghi full-text, rimuovendoli completamente. This example specifies the optional @action and @value arguments.

EXECUTE sp_fulltext_service
    @action = 'upgrade_option',
    @value = 1;
GO