sp_fulltext_service (Transact-SQL)
Modifica le proprietà del server di ricerca full-text per SQL Server.
.gif "Icona di collegamento a un argomento")
Sintassi
sp_fulltext_service [ [@action=] 'action'
[ , [ @value= ] value ] ]
Argomenti
[ @action=] 'action'
Proprietà da modificare o reimpostare. action è di tipo nvarchar(100), e non prevede alcun valore predefinito. Per un elenco delle proprietà, delle relative descrizioni e dei valori che è possibile impostare, consultare la tabella sotto l'argomento value. Questo argomento restituisce le proprietà seguenti: tipo di dati, valore corrente, valore minimo o massimo e valore che indica se l'oggetto è deprecato, se pertinente.[ @value=] value
Valore della proprietà specificata. value è di tipo sql_variant e il 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
In una versione futura di SQL Server le azioni seguenti verranno rimosse: clean_up, connect_timeout, data_timeout e 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
Supportata unicamente per compatibilità con le versioni precedenti. Il valore corrisponde sempre a 0.
connect_timeout
int
Supportato unicamente per compatibilità con le versioni precedenti. Il valore corrisponde sempre a 0.
data_timeout
int
Supportato unicamente per compatibilità con le versioni precedenti. Il valore corrisponde sempre a 0.
upgrade_option
int
Consente di controllare il modo in cui gli indici full-text vengono migrati durante l'aggiornamento di un database da SQL Server 2000 o SQL Server 2005 a SQL Server 2008 o versioni successive. 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.
Sono possibili i valori seguenti:
0 = I cataloghi full-text vengono ricompilati utilizzando i nuovi word breaker migliorati. La ricostruzione degli indici può richiedere tempo e dopo l'aggiornamento potrebbe essere necessaria una quantità significativa di CPU e di memoria.
1 = I cataloghi full-text vengono reimpostati. I file del catalogo full-text di SQL Server 2005 vengono rimossi, ma i metadati per i cataloghi e per gli indici full-text vengono mantenuti. Dopo l'aggiornamento, in tutti gli indici full-text il rilevamento delle modifiche viene disabilitato 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 è molto più veloce della ricostruzione. Se ad esempio si utilizza una sola CPU, l'importazione è quasi 10 volte più veloce della ricompilazione. Tuttavia, un catalogo full-text importato non utilizza i word breaker nuovi e migliorati introdotti in SQL Server 2008, pertanto potrebbe essere necessario ricompilare i cataloghi full-text.
.gif "Nota")
Nota
La ricompilazione può essere eseguita in modalità a thread multipli e, nel caso in cui siano disponibili più di 10 CPU, può risultare più veloce dell'importazione se si consente alla ricompilazione di utilizzare tutte le CPU.Se non è disponibile un catalogo full-text, vengono ricompilati gli indici full-text associati. Questa opzione è disponibile solo per i database di SQL Server 2005.
Per informazioni sulla scelta dell'opzione di aggiornamento full-text, vedere Aggiornamento della ricerca full-text.
Nota
Per impostare questa proprietà in SQL Server Management Studio, utilizzare la proprietà Opzione di aggiornamento catalogo full-text. Per ulteriori informazioni, vedere Procedura: Visualizzazione o modifica delle proprietà del server per la ricerca full-text (SQL Server Management Studio).load_os_resources
int
Indica se i word breaker, gli stemmer e i filtri del sistema operativo vengono registrati e utilizzati con questa istanza di SQL Server. Sono possibili i valori seguenti:
0 = vengono utilizzati solo i filtri e i word breaker specifici per questa istanza di SQL Server.
1 = Vengono caricati i filtri e i word breaker del sistema operativo.
Per impostazione predefinita, questa proprietà è disabilitata per evitare modifiche accidentali del sistema operativo. L'abilitazione dell'utilizzo delle risorse del sistema operativo consente l'accesso alle risorse per le lingue e i tipi di documenti registrati nel servizio di indicizzazione Microsoft per cui non è installata una risorsa specifica dell'istanza. Se si abilita il caricamento delle risorse del sistema operativo, verificare che le risorse siano file binari firmati trusted. In caso contrario, non sarà possibile eseguire il caricamento quando l'opzione verify_signature (vedere più avanti) è impostata su 1.
pause_indexing
int
Specifica se l'indicizzazione full-text deve essere sospesa, se è attualmente in esecuzione, ripresa o 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 ha alcuna funzione in SQL Server 2008 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 utilizzati dall'host del daemon di filtri per estrarre informazioni testuali dai formati di file corrispondenti quali quelli con estensione docx, archiviati nei tipi di dati, ad esempio varbinary, varbinary(max), image o xml, per l'indicizzazione full-text.
Per ulteriori informazioni, vedere Procedura: Modifica dell'elenco di word breaker e filtri registrati (Transact-SQL).
verify_signature
int
Indica se solo i file binari firmati vengono caricati dal motore di ricerca full-text. Per impostazione predefinita vengono caricati solo i file binari firmati trusted.
1 = Verifica che vengano caricati solo i file binari firmati trusted (impostazione predefinita).
0 = Non verifica se i file binari sono firmati.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Set di risultati
Nessuno
Autorizzazioni
Solo i membri del ruolo predefinito del server serveradmin o l'amministratore di sistema possono eseguire sp_fulltext_service.
Esempi
A. Aggiornamento dell'elenco di lingue registrate
Nell'esempio seguente viene aggiornato l'elenco di lingue registrate per la ricerca full-text.
EXEC sp_fulltext_service 'update_languages';
GO
B. Modifica dell'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. I cataloghi vengono rimossi completamente. Nell'esempio vengono specificate le parole chiave facoltative @action e @value.
EXEC sp_fulltext_service @action='upgrade_option', @value=1;
GO
Vedere anche