sp_fulltext_service (Transact-SQL)
Si applica a: 
SQL Server
Modifica le proprietà di ricerca full-text del server per SQL Server.
Attenzione
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
Sintassi
sp_fulltext_service
[ [ @action = ] N'action' ]
[ , [ @value = ] value ]
[ ; ]
Argomenti
[ @action = ] N'action'
Proprietà da modificare o reimpostare. @action è nvarchar(100), senza impostazione predefinita. Per un elenco di proprietà @action , le relative descrizioni e i valori che è possibile impostare, vedere la tabella sotto l'argomento @value .
Questo argomento restituisce le proprietà seguenti:
- tipo di dati
- valore corrente in esecuzione
- valore minimo o massimo
- stato di deprecazione, se applicabile.
[ @value = ] value
@value è sql_variant, con il valore predefinito NULL.
Valore della proprietà specificata. @value è sql_variant, con un valore predefinito .NULL Se @value è Null, sp_fulltext_service restituisce l'impostazione corrente. In questa tabella sono elencate le proprietà, le descrizioni e i valori che è possibile impostare.
Nota
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.
| Azione | Tipo di dati | Descrizione |
|---|---|---|
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. Uno dei valori possibili: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 4o 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. I filtri vengono usati dall'host del daemon di filtri per estrarre informazioni testuali da formati di file corrispondenti, ad esempio .docx archiviati in tipi di dati, ad esempio varbinary, varbinary(max), image o xml, per l'indicizzazione full-text.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. Uno dei valori possibili: - 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.Nota: la ricompilazione può essere eseguita in modalità multithread e, se sono disponibili più di 10 CPU, la ricompilazione potrebbe essere eseguita più velocemente dell'importazione se si consente la ricompilazione di usare tutte le CPU. 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. Nota: per impostare questa proprietà in SQL Server Management Studio, usare la proprietà Opzione di aggiornamento full-text. 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. |
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Set di risultati
Nessuno.
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).
Autorizzazioni
Solo i membri del ruolo predefinito del serveradmin o l'amministratore di sistema possono eseguire sp_fulltext_service.
Esempi
R. 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. In questo esempio vengono specificati gli argomenti facoltativi @action e @value .
EXECUTE sp_fulltext_service
@action = 'upgrade_option',
@value = 1;
GO