sp_fulltext_service (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @action=] 'action'
    É a propriedade a ser alterada ou redefinida. action é nvarchar(100), sem padrão. Para obter uma lista das propriedades de action, suas descrições e os valores que podem ser definidos, consulte a tabela sob o argumento value. Esse argumento retorna as seguintes propriedades: tipo de dados, valor em execução atual, valor mínimo ou máximo e status da reprovação, se aplicável.

  • [ @value=] value
    É 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çãoObservação

    As seguintes ações serão removidas em uma versão futura do SQL Server: clean_up, connect_timeout, data_timeout e 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 apenas para compatibilidade com versões anteriores. O valor padrão é sempre 0.

    connect_timeout

    int

    Com suporte apenas para compatibilidade com versões anteriores. O valor padrão é sempre 0.

    data_timeout

    int

    Com suporte apenas para compatibilidade com versões anteriores. O valor padrão é sempre 0.

    upgrade_option

    int

    Controla como são migrados índices de texto completo ao atualizar um banco de dados do SQL Server 2000 ou SQL Server 2005 para o SQL Server 2008 ou versões posteriores. 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 dos seguintes:

    0 = os catálogos de texto completo são recompilados usando-se os separadores de palavras novos e aprimorados. A recompilação de índices pode demorar um pouco, e uma quantidade significativa de memória e CPU pode ser necessária depois da atualização.

    1 = os catálogos de texto completo são redefinidos. Os arquivos de catálogo de texto completo do SQL Server 2005 são removidos, mas os metadados para catálogos de texto completo e os índices de texto completo são retidos. Depois de serem atualizados, todos os índices de texto completo são desabilitados para o controle de alteração 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. A importação costuma ser consideravelmente 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. Contudo, um catálogo de texto completo importado não usa os separadores de palavras novos e aprimorados introduzidos no SQL Server 2008, por isso pode ser necessário recompilar o catálogo de texto completo no futuro.

    ObservaçãoObservação
    A recompilação pode ser executada no modo multi-threaded e, se houver mais de 10 CPUs disponíveis, ela poderá ser executada mais rápido do que a importação se você autorizar o uso de todas as CPUs.

    Se um catálogo de texto completo não estiver disponível, os índices de texto completo associados serão recompilados. Essa opção só está disponível para bancos de dados do SQL Server 2005.

    Para obter informações sobre como escolher uma opção de atualização de texto completo, consulte Atualização da pesquisa de texto completo.

    ObservaçãoObservação
    Para definir essa propriedade no SQL Server Management Studio, use a propriedade Opção de Atualização de Texto Completo. Para obter mais informações, consulte Como exibir ou alterar propriedades do servidor para a pesquisa de texto completo (SQL Server Management Studio).

    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 dos seguintes:

    0 = Usar somente filtros e separadores de palavras específicos a 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. A habilitação do uso de recursos do sistema operacional fornece acesso a recursos para idiomas e tipos de documento registrados no Microsoft Indexing Service que não têm um recurso específico de instância instalado. Ao habilitar o carregamento de recursos do sistema operacional, verifique se eles são recursos binários assinados confiáveis; caso contrário, não poderão ser carregados quando verify_signature (consulte a seguir) estiver definido como 1.

    pause_indexing

    int

    Especifica se a indexação de texto completo deve ser pausada, se estiver em execução no momento, ou continuada, se estiver pausada no momento.

    0 = Continua 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 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 arquivos correspondentes, como .docx armazenado em tipos de dados, como varbinary, varbinary(max), image ou xml, para indexação de texto completo.

    Para obter mais informações, consulte Como alterar a lista de separadores de palavras e filtros registrados (Transact-SQL).

    verify_signature

    int

    Indica se apenas binários assinados são carregados pelo Mecanismo de Texto Completo. Por padrão, apenas 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 verifica se binários são assinados.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Permissões

Apenas membros da função de servidor fixa serveradmin ou o administrador do sistema podem executar sp_fulltext_service.

Exemplos

A. Atualizando 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. Alterando 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. Isso os remove completamente. Esse exemplo especifica a @action opcional e as palavras-chave @value.

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