Compartilhar via


sp_fulltext_service (Transact-SQL)

Applies to:SQL Server

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

Caution

A upgrade_option ação não tem suporte total 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.

Convenções de sintaxe de Transact-SQL

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 corrente atual
  • Valor mínimo ou máximo
  • status de substituiçã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. Essa tabela lista propriedades de 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 a modificação dos aplicativos que as usam atualmente.

Action Data type Description
clean_up int Com suporte somente para compatibilidade com versões anteriores. O valor é sempre 0.
connect_timeout int Com suporte somente para compatibilidade com versões anteriores. O valor é sempre 0.
data_timeout int Com suporte somente para compatibilidade com versões anteriores. O valor é sempre 0.
load_os_resources int Indica se os 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 impedir alterações de comportamento acidental em atualizações feitas no sistema operacional. Habilitar o 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, certifique-se de que os recursos do sistema operacional sejam 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 ser usado 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 de 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 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 que estão registrados com pesquisa de texto completo. Os idiomas são especificados ao configurar 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 do banco de dados, restaurando um backup de arquivo ou copiando o banco de dados usando o Assistente para Copiar Banco de Dados.

One of:

- 0 = Os catálogos de texto completo são recriados usando os separadores de palavras novos e aprimorados. A recriaçã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. SQL Server 2005 (9.x) os arquivos de catálogos de texto completo são removidos, mas os metadados dos catálogos e dos índices de texto completo são preservados. Depois de atualizados, todos os índices de texto completo são desabilitados para controle de alterações e os rastreamentos não são iniciados automaticamente. O catálogo permanecerá vazio até você executar uma população completa manualmente, depois que a atualização for concluída.

- 2 = Catálogos de texto completo são importados. Normalmente, a importação é mais rápida do que a recompilação. Por exemplo, quando é usada apenas uma CPU, a importação é executada cerca de 10 vezes mais rápido do que a recompilação. No entanto, um catálogo de texto completo importado não usa os separadores de palavras novos e aprimorados, portanto, talvez você queira recompilar 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 recriados. 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, consulteAtualizar pesquisa de texto completo.

Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. Para obter informações, consulte Gerenciar e monitorar a pesquisa de texto completo em uma instância do servidor.
verify_signature 1 int Indica se o Mecanismo de Texto Completo carrega apenas binários assinados. Por padrão, somente binários assinados confiáveis são carregados.

1 = Verifique se apenas binários confiáveis e assinados são carregados (padrão).

0 = Não verifique se os binários estão assinados.

1 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 do código de retorno

0 (sucesso) ou 1 (falha).

Result set

None.

Compatibilidade com SQL Server 2022 e versões posteriores

O recurso de importação na upgrade_option ação (especificado 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 registrados

O exemplo a seguir atualiza a lista de idiomas registrados na 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