sp_fulltext_service (Transact-SQL)

Applies to:SQL Server

Altera as propriedades do servidor da pesquisa de texto completo para o SQL Server.

Caution

A upgrade_option ação não é totalmente suportada no SQL Server 2022 (16.x) e versões posteriores. Para obter mais informações, consulte a seção Compatibilidade com o SQL Server 2022 e versões posteriores, mais adiante neste artigo.

Transact-SQL convenções de sintaxe

Syntax

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

Arguments

[ @action = ] N'action'

A propriedade a ser alterada ou redefinida. @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.

Esse argumento retorna as seguintes propriedades:

tipo de dados
Valor de execução atual
valor mínimo ou máximo
status de preterição, se aplicável.

[ @value = ] value

@value is sql_variant, with a default of NULL.

O valor da propriedade especificada. @value is sql_variant, with a default value of NULL. If @value is null, sp_fulltext_service returns the current setting. Esta tabela lista as propriedades da ação, suas descrições e os valores que podem ser definidos.

Note

As seguintes ações serão removidas em uma versão futura do SQL Server: clean_up, connect_timeout, data_timeoute resource_usage. Evite usar essas ações em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam qualquer um deles.

Action	Data type	Description
`clean_up`	int	Suportado apenas para compatibilidade com versões anteriores. O valor é sempre `0`.
`connect_timeout`	int	Suportado apenas para compatibilidade com versões anteriores. O valor é sempre `0`.
`data_timeout`	int	Suportado apenas para compatibilidade com versões anteriores. O valor é sempre `0`.
`load_os_resources`	int	Indica se separadores de palavras, lematizadores e filtros do sistema operacional são registrados e usados com essa instância do SQL Server. One of: `0` = Use apenas filtros e separadores de palavras específicos para esta instância do SQL Server. `1` = Carregar filtros do sistema operacional e separadores de palavras. Por padrão, essa propriedade é desabilitada para evitar alterações de comportamento inadvertidas feitas por atualizações feitas no sistema operacional. A habilitação do uso de recursos do sistema operacional fornece acesso a recursos para idiomas e tipos de documentos registrados no Serviço de Indexação da Microsoft que não têm um recurso específico da instância instalado. Se você habilitar o carregamento de recursos do sistema operacional, verifique se os recursos do sistema operacional são binários assinados confiáveis; caso contrário, eles não poderão ser carregados quando `verify_signature` estiver definido como `1`.
`master_merge_dop`	int	Especifica o número de threads a serem usados pelo processo de mesclagem mestre. Esse valor não deve exceder o número de CPUs ou núcleos de CPU disponíveis. Quando esse argumento não é especificado, o serviço usa o menor dos `4`, ou o número de CPUs ou núcleos de CPU disponíveis.
`pause_indexing`	int	Especifica se a indexação de texto completo deve ser pausada, se estiver em execução no momento, ou retomada, se estiver pausada no momento. `0` = Retoma as atividades de indexação de texto completo para a instância do servidor. `1` = Pausa as atividades de indexação de texto completo para a instância do servidor.
`resource_usage`	int	Não tem nenhuma função no SQL Server 2008 (10.0.x) e versões posteriores e é ignorado.
`update_languages`	`NULL`	Atualiza a lista de idiomas e filtros registrados na pesquisa de texto completo. Os idiomas são especificados ao configurar a indexação e em consultas de texto completo. 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. Para obter mais informações, consulte Exibir ou alterar filtros registrados e separadores de palavras.
`upgrade_option`	int	Controla como os índices de texto completo são migrados ao atualizar um banco de dados do SQL Server 2005 (9.x) para uma versão posterior. Essa propriedade se aplica à atualização anexando um banco de dados, restaurando um backup de banco de dados, restaurando um backup de arquivo ou copiando o banco de dados usando o Assistente para Cópia de Banco de Dados. One of: - `0` = Os catálogos de texto completo são reconstruídos usando os separadores de palavras novos e aprimorados. A reconstrução de índices pode levar algum tempo, e uma quantidade significativa de CPU e memória pode ser necessária após a atualização. - `1` = Os catálogos de texto completo são redefinidos. Os arquivos de catálogo de texto completo do SQL Server 2005 (9.x) são removidos, mas os metadados para catálogos de texto completo e índices de texto completo são mantidos. Depois de atualizados, todos os índices de texto completo são desativados para controle de alterações e os rastreamentos não são iniciados automaticamente. O catálogo permanecerá vazio até que você emita manualmente uma população completa, após a conclusão da atualização. - `2` = Os catálogos de texto completo são importados. Normalmente, a importação é mais rápida do que a reconstrução. Por exemplo, ao usar apenas uma CPU, a importação é executada cerca de 10 vezes mais rápido do que a reconstrução. No entanto, um catálogo de texto completo importado não usa os separadores de palavras novos e aprimorados, portanto, convém reconstruir seus catálogos de texto completo. Removido no SQL Server 2022 (16.x) e versões posteriores e gera um erro. 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 um catálogo de texto completo não estiver disponível, os índices de texto completo associados serão reconstruídos. Essa opção só está disponível para bancos de dados do SQL Server 2005 (9.x). Para obter informações sobre como escolher uma opção de atualização de texto completo, veja Atualizaçãode texto completo Full-Text Pesquisa. Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. Para obter mais informações, consulte Gerir e Monitorizar Full-Text Procurar uma Instância do Servidor.
`verify_signature` ¹	int	Indica se o Full-Text Engine carrega apenas binários assinados. Por padrão, apenas binários confiáveis e assinados são carregados. `1` = Verifique se apenas binários confiáveis e assinados estão carregados (padrão). `0` = Não verifique se os binários estão assinados.

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

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Result set

None.

Compatibilidade com o SQL Server 2022 e versões posteriores

O recurso de importação na upgrade_option ação (especificada por @action = 'upgrade_option', @value = 2) é removido no SQL Server 2022 (16.x) e versões posteriores. Se você precisar importar um índice de texto completo de uma versão mais antiga do SQL Server, poderá importá-lo usando o SQL Server 2019 (15.x) ou versões anteriores e, em seguida, atualizar para o 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. Atualizar a lista de idiomas registados

O exemplo a seguir atualiza a lista de idiomas registrados com a pesquisa de texto completo.

EXECUTE sp_fulltext_service 'update_languages';
GO

B. Alterar a opção de atualização de texto completo para redefinir catálogos de texto completo

O exemplo a seguir altera a opção de atualização de texto completo para redefinir catálogos de texto completo, removendo-os completamente. This example specifies the optional @action and @value arguments.

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

Feedback

Esta página foi útil?

Last updated on 2025-07-23