Compartilhar via


sp_fulltext_service (Transact-SQL)

Aplica-se: SQL Server

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

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 = Usa somente filtros e separadores de palavra específicos para essa instância do SQL Server.

1 = Carregar filtros e separadores de palavras do sistema operacional.

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 recompilados usando-se 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 = os 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 eventualmente.

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 está disponível apenas 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 = Verifica se somente binários assinados confiáveis 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.

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.

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

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