sp_fulltext_service (Transact-SQL)

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

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

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

    Supportata unicamente per compatibilità con le versioni precedenti. Il valore corrisponde sempre a 0.

    data_timeout

    int

    Supportata unicamente per compatibilità con le versioni precedenti. Il valore corrisponde sempre a 0.

    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.

    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 di core della CPU disponibili.

    Quando questo argomento non viene specificato, il servizio utilizza il minore di 4 o il numero di CPU o di core della 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 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 Visualizzazione o modifica di word breaker e filtri registrati.

    upgrade_option

    int

    Consente di controllare il modo in cui viene eseguita la migrazione degli indici full-text durante l'aggiornamento di un database da 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 ricompilazione 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 ricompilazione. 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.

    [!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 in SQL Server 2005.

    [!NOTA]

    Per impostare questa proprietà in SQL Server Management Studio, utilizzare la proprietà Opzione di aggiornamento full-text. Per ulteriori informazioni, vedere Gestione e monitoraggio della ricerca full-text per un'istanza del server.

    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

Riferimento

FULLTEXTSERVICEPROPERTY (Transact-SQL)

Stored procedure di sistema (Transact-SQL)

Concetti

Ricerca full-text (SQL Server)