Popular índices de texto completo

A criação e a manutenção de um índice de texto completo envolvem popular o índice usando um processo chamado população (também conhecido como rastreamento).

Neste tópico

• Tipo de população

• Exemplos de preenchimento de índices de texto completo

• Criando ou alterando uma agenda para população incremental

• Solucionando problemas de erros em uma população de texto completo (rastreamento)

Tipo de população

O SQL Server oferece suporte aos seguintes tipos de população: população completa, população automática ou manual baseada em controle de alterações e população incremental baseada em carimbo de data e hora.

População completa

Durante uma população completa, entradas de índice são criadas para todas as linhas de uma tabela ou exibição indexada. Uma população completa de um índice de texto completo cria entradas de índice para todas as linhas da tabela base ou da exibição indexada.

Por padrão, o SQL Server popula totalmente um novo índice de texto completo assim que ele é criado. No entanto, uma população completa pode consumir recursos consideráveis. Portanto, quando você criar um índice de texto completo durante períodos de pico, uma prática recomendada é atrasar a população completa até uma hora fora do horário de pico, principalmente se a tabela base de um índice de texto completo for grande. Todavia, o catálogo de texto completo ao qual o índice pertence não poderá ser utilizado até que todos os índices de texto completo estejam populados. Para criar um índice de texto completo sem populá-lo imediatamente, especifique a cláusula CHANGE_TRACKING OFF, NO POPULATION na instrução CREATE FULLTEXT INDEX. Se você especificar CHANGE_TRACKING MANUAL, o Mecanismo de Texto Completo usará a instrução. O SQL Server não populará o novo índice de texto completo até que você execute uma instrução ALTER FULLTEXT INDEX usando a cláusula START FULL POPULATION ou START INCREMENTAL POPULATION. Para obter mais informações, consulte os exemplos “A. Criando um índice de texto completo sem executar uma população completa" e "B. Executando uma população completa em tabela", mais adiante neste tópico.

[TOP]TOP

População com base em controle de alterações

Como opção, você pode usar o controle de alterações para manter um índice de texto completo após a população completa inicial. Há uma pequena sobrecarga associada ao controle de alterações porque o SQL Server mantém uma tabela em que controla as alterações feitas na tabela base desde a última população. Quando é usado o controle de alterações, oSQL Server mantém um registro das linhas da tabela base ou exibição indexada que foram modificadas por atualizações, exclusões ou inserções. As alterações de dados por meio de WRITETEXT e UPDATETEXT não são refletidas no índice de texto completo e não são coletadas com o controle de alterações.

Observação
Para tabelas que contêm uma coluna timestamp, você pode usar populações incrementais.

Quando o controle de alterações é habilitado durante a criação do índice, o SQL Server popula completamente o novo índice de texto completo logo após sua criação. Consequentemente, as alterações são controladas e propagadas para o índice de texto completo. Há dois tipos de controle de alterações: automático (opção CHANGE_TRACKING AUTO) e manual (opção CHANGE_TRACKING MANUAL). O controle de alterações automático é o comportamento padrão.

O tipo de controle de alterações determina como o índice de texto completo é populado, como segue:

• População automática

  Por padrão, ou se você especificar CHANGE_TRACKING AUTO, o Mecanismo de Texto Completo usa população automática no índice de texto completo. Depois que a população completa inicial é concluída, as alterações são controladas à medida que os dados são modificados na tabela base, e as alterações controladas são propagadas automaticamente. O índice de texto completo é atualizado em segundo plano, mas as alterações propagadas podem não ser refletidas imediatamente no índice.

  Para configurar o controle de alterações com população automática

  • CREATE FULLTEXT INDEX … WITH CHANGE_TRACKING AUTO

  • ALTER FULLTEXT INDEX … SET CHANGE_TRACKING AUTO

  Para obter mais informações, consulte o exemplo “E. Alterando um índice de texto completo para usar o controle de alterações automáticas”, mais adiante neste tópico.

• População manual

  Se você especificar CHANGE_TRACKING MANUAL, o Mecanismo de Texto Completo usará população manual no índice de texto completo. Depois que a população completa inicial é concluída, as alterações são controladas à medida que os dados são modificados na tabela base. Porém, eles não serão propagados para o índice de texto completo até que você execute uma instrução ALTER FULLTEXT INDEX … START UPDATE POPULATION. É possível usar o SQL Server Agent para chamar essa instrução Transact-SQL periodicamente.

  Para começar a controlar alterações com população manual

  • CREATE FULLTEXT INDEX … WITH CHANGE_TRACKING MANUAL

  • ALTER FULLTEXT INDEX … SET CHANGE_TRACKING MANUAL

  Para obter mais informações, consulte o exemplo “C. Criando um índice de texto completo com controle de alterações manual" e "D. Executando uma população manual", posteriormente neste tópico.

Para desativar o rastreamento de alterações

• CREATE FULLTEXT INDEX … WITH CHANGE_TRACKING OFF

• ALTER FULLTEXT INDEX … SET CHANGE_TRACKING OFF

[TOP]TOP

População incremental baseada em carimbo de data e hora

Uma população incremental é um mecanismo alternativo para popular um índice de texto completo manualmente. Você pode executar uma população incremental para um índice de texto completo que tem CHANGE_TRACKING definido como MANUAL ou OFF. Se a primeira população em um índice de texto completo for uma população incremental, ele indexará todas as linhas, tornando-a equivalente a uma população completa.

O requisito para população incremental é que a tabela indexada deve ter uma coluna do tipo de dados timestamp. Se uma coluna timestamp não existir, a população incremental não poderá ser executada. Uma solicitação para população incremental em uma tabela sem uma coluna timestamp resulta em uma operação de população completa. Além disso, se nenhum metadado que afeta o índice de texto completo da tabela foi alterado desde a última população, as solicitações de população incremental serão implementadas como populações completas. Isso inclui alterações de metadados geradas pela alteração de qualquer coluna, índice ou definições de índice de texto completo.

O SQL Server usa a coluna timestamp para identificar linhas que foram alteradas desde a última população. A população incremental então atualiza o índice de texto completo com linhas adicionadas, excluídas ou modificadas após a última população ou enquanto a última população estava em andamento. Se uma tabela tiver um volume alto de inserções, usar a população incremental poderá ser mais eficiente do que usar a população manual.

Ao término de uma população, o Mecanismo de Texto Completo registra um novo valor de timestamp. Esse valor é o maior valor de timestamp que o SQL Gatherer encontrou. Esse valor será usado quando uma população incremental subsequente for iniciada.

Para executar uma população incremental, execute uma instrução ALTER FULLTEXT INDEX usando a cláusula START INCREMENTAL POPULATION.

[TOP]TOP

Exemplos de preenchimento de índices de texto completo

Observação
Os exemplos desta seção usam a tabela Production.Document ou HumanResources.JobCandidate do banco de dados de exemplo AdventureWorks.

A.Criando um índice de texto completo sem executar uma população completa

O exemplo a seguir cria um índice de texto completo na tabela Production.Document do banco de dados de exemplo AdventureWorks. Este exemplo usa WITH CHANGE_TRACKING OFF, NO POPULATION para atrasar a população completa inicial.

CREATE UNIQUE INDEX ui_ukDoc ON Production.Document(DocumentID);
CREATE FULLTEXT CATALOG AW_Production_FTCat;
CREATE FULLTEXT INDEX ON Production.Document
(
    Document                         --Full-text index column name 
        TYPE COLUMN FileExtension    --Name of column that contains file type information
        Language 1033                 --1033 is LCID for the English language
)
    KEY INDEX ui_ukDoc
    ON AW_Production_FTCat
    WITH CHANGE_TRACKING OFF, NO POPULATION;
GO

B.Executando uma população completa em tabela

O exemplo a seguir executa uma população completa na tabela Production.Document do banco de dados de exemplo AdventureWorks.

ALTER FULLTEXT INDEX ON Production.Document
   START FULL POPULATION;

C.Criando um índice de texto completo com controle de alterações manuais

O exemplo a seguir cria um índice de texto completo que usará o controle de alterações com população manual na tabela HumanResources.JobCandidate do banco de dados de exemplo AdventureWorks.

USE AdventureWorks;
GO
CREATE UNIQUE INDEX ui_ukJobCand ON HumanResources.JobCandidate(JobCandidateID);
CREATE FULLTEXT CATALOG ft AS DEFAULT;
CREATE FULLTEXT INDEX ON HumanResources.JobCandidate(Resume) 
   KEY INDEX ui_ukJobCand 
   WITH CHANGE_TRACKING=MANUAL;
GO

D.Executando uma população manual

O exemplo a seguir executa uma população manual no índice de texto completo com controle de alterações da tabela HumanResources.JobCandidate do banco de dados de exemplo AdventureWorks.

USE AdventureWorks;
GO
ALTER FULLTEXT INDEX ON HumanResources.JobCandidate START UPDATE POPULATION;
GO

E.Alterando um índice de texto completo para usar o controle de alterações automáticas

O exemplo a seguir altera o índice de texto completo da tabela HumanResources.JobCandidate do banco de dados de exemplo AdventureWorks para usar o controle de alterações com população automática.

USE AdventureWorks;
GO
ALTER FULLTEXT INDEX ON HumanResources.JobCandidate SET CHANGE_TRACKING AUTO;
GO 

[TOP]TOP

Criando ou alterando uma agenda para população incremental

Para criar ou alterar uma agenda para população incremental no Management Studio

1. No Pesquisador de Objetos, expanda o servidor.

2. Expanda Bancos de Dados e, depois, expanda o banco de dados que contém o índice de texto completo.

3. Expanda Tabelas.

Clique com o botão direito do mouse na tabela em que o índice de texto completo está definido, selecione Índice de Texto Completo e, no menu de contexto Índice de Texto Completo, clique em Propriedades. Este procedimento abre a caixa de diálogo Propriedades do Índice de Texto Completo.

1. No painel Selecionar uma página, selecione Agendas.

   Use esta página para criar ou gerenciar agendas para um trabalho do SQL Server Agent que inicia uma população incremental de tabela na tabela base ou na exibição indexada do índice de texto completo.

   Importante
   Se a tabela base ou a exibição não contiver uma coluna do tipo de dados timestamp, uma população completa será executada.

   As opções são as seguintes:

   • Para criar uma nova agenda, clique em Novo.

     Este procedimento abre a caixa de diálogo Nova Agenda da Tabela de Indexação de Texto Completo, onde é possível criar uma agenda. Para salvar a agenda, clique em OK.

     Importante
     Um trabalho do SQL Server Agent (Iniciar População Incremental da Tabela em database_name.table_name) é associado a uma nova agenda quando você sai da caixa de diálogo Propriedades do Índice de Texto Completo. Se você criar várias agendas para o índice de texto completo, todos eles usarão o mesmo trabalho.

   • Para alterar uma agenda, selecione-a e clique em Editar.

     Este procedimento abre a caixa de diálogo Nova Agenda da Tabela de Indexação de Texto Completo, onde é possível modificar a agenda.

     Observação
     Para obter informações sobre como modificar um trabalho, consulte Modificar um trabalho.

   • Para remover uma agenda, selecione-a e clique em Excluir.

2. Clique em OK.  

[TOP]TOP

Solucionando problemas de erros em uma população de texto completo (rastreamento)

Quando um erro ocorrer durante um rastreamento, o recurso de registro de rastreamento de pesquisa de texto completo cria e mantém um log de rastreamento, que é um texto sem-formatação. Cada log de rastreamento corresponde a um catálogo de texto completo específico. Por padrão, os logs de rastreamento para uma determinada instância, neste caso, a primeira instância, estão localizados na pasta %Arquivos de programas%\Microsoft SQL Server\MSSQL11.MSSQLSERVER\MSSQL\LOG. O arquivo de log de rastreamento segue o seguinte esquema de nomeação:

SQLFT<DatabaseID><FullTextCatalogID>.LOG[<n>]

• <DatabaseID>
  A ID de um banco de dados. <dbid> é um número de cinco dígitos com zeros à esquerda.

• <FullTextCatalogID>
  ID do catálogo de texto completo. <catid> é um número de cinco dígitos com zeros à esquerda.

• <n>
  É um inteiro que indica um ou mais logs de rastreamento que existem do mesmo catálogo de texto completo.

Por exemplo, SQLFT0000500008.2 é o arquivo de log de rastreamento para o banco de dados com o ID de banco de dados = 5 e ID de catálogo de texto completo = 8. O 2 no final do nome do arquivo indica que há dois arquivos de log de rastreamento para esse par de banco de dados/catálogo.

[TOP]TOP

Consulte também

Referência

sys.dm_fts_index_population (Transact-SQL)

CREATE FULLTEXT INDEX (Transact-SQL)

ALTER FULLTEXT INDEX (Transact-SQL)

Conceitos

Iniciar a pesquisa de texto completo

Criar e gerenciar índices de texto completo