sp_fulltext_service (Transact-SQL)
Aplica-se: 
SQL Server
Altera as propriedades do servidor de pesquisa de texto completo do SQL Server.
Cuidado
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
Sintaxe
sp_fulltext_service
[ [ @action = ] N'action' ]
[ , [ @value = ] value ]
[ ; ]
Argumentos
@action [ = ] N'ação'
A propriedade a ser alterada ou redefinida. @action é nvarchar(100), sem padrão. Para obter uma lista de propriedades @action, suas descrições e os valores que podem ser definidos, consulte a tabela no argumento @value.
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 é sql_variant, com um padrão de NULL.
O valor da propriedade especificada. @value é sql_variant, com um valor padrão de NULL. Se @value for nulo, sp_fulltext_service retornará a configuração atual. Essa tabela lista propriedades de ação, suas descrições e os valores que podem ser definidos.
Observação
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.
| Ação | Tipo de dados | Descrição |
|---|---|---|
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. Um destes: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. Os filtros são usados pelo host do daemon de filtro para extrair informações textuais de formatos de arquivo correspondentes, como .docx armazenados em tipos de dados, como varbinary, varbinary(max), image ou xml, para indexação de texto completo.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. Um destes: - 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.Observação: a reconstrução pode ser executada no modo multithread e, se mais de 10 CPUs estiverem disponíveis, a reconstrução poderá ser executada mais rapidamente do que a importação se você permitir que a reconstrução use todas as 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. Observação: Para definir essa propriedade no SQL Server Management Studio, use a propriedade Opção de Atualização de Texto Completo . Para obter informações, consulte Gerenciar e monitorar a pesquisa de texto completo em uma instância do servidor. |
verify_signature |
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. |
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto de resultados
Nenhum.
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).
Permissões
Somente membros da função de servidor fixa serveradmin ou o administrador do sistema podem executar sp_fulltext_serviceo .
Exemplos
R. 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. Este exemplo especifica os argumentos opcionais @action e @value .
EXECUTE sp_fulltext_service
@action = 'upgrade_option',
@value = 1;
GO