sp_fulltext_service (Transact-SQL)

  • Articolo

Si applica a:SQL Server

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

Convenzioni di 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_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 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 = Utilizza 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'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 meno 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. I filtri vengono usati dall'host del daemon di filtri per estrarre informazioni testuali da formati di file corrispondenti, ad esempio .docx archiviati nei tipi di dati, ad esempio varbinary, varbinary(max), image o xml per l'indicizzazione full-text.

Per altre informazioni, vedere Visualizzazione o modifica di word breaker e filtri registrati.
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 utilizzando i nuovi word breaker migliorati. 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.

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 = Verifica che vengano caricati solo i file binari firmati trusted (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.

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.

EXEC 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 .

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

Contenuto correlato