Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é tsvector?

    O tsvector representa um documento por lexemas no PostgreSQL. A função to_tsvector prepara as palavras conforme o idioma para comparar o texto com a busca.

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Lexemas na busca textual

    O tsvector é um tipo do PostgreSQL que representa um documento como uma lista ordenada de lexemas distintos para busca textual. Um lexema é a forma preparada de uma palavra, que pode reunir variações como singular e plural conforme o dicionário utilizado.

    A representação também pode guardar as posições dos termos no documento e pesos associados a essas posições. Essas informações permitem considerar proximidade e dar importância diferente a palavras do título e do corpo ao calcular a relevância.

    Preparação do texto com to_tsvector

    A documentação usa um exemplo em inglês para mostrar a normalização. A configuração english determina quais dicionários processam a frase.

    SELECT to_tsvector('english', 'The Fat Rats');

    O resultado é 'fat':2 'rat':3. O artigo The foi removido, as palavras foram convertidas para minúsculas e o plural Rats foi reduzido a rat. Os números indicam as posições no texto recebido, preservando a numeração mesmo após a remoção do artigo.

    Documento e expressão pesquisada

    O cast direto 'The Fat Rats'::tsvector produz 'Fat' 'Rats' 'The', sem a normalização da função. Para preparar um documento, você precisa escolher uma configuração compatível com o idioma e usá-la também ao preparar a pesquisa.

    A função plainto_tsquery transforma o texto pesquisado em uma expressão do tipo tsquery. A comparação com o documento usa @@. Esse processamento não preserva uma versão completa para exibição, portanto mantenha o texto original além da representação usada na busca.

    Dúvidas frequentes

    Perguntas frequentes sobre tsvector

    Converter texto diretamente para tsvector normaliza as palavras?
    O cast para tsvector ordena os termos e remove repetições, mas pressupõe lexemas já normalizados. A função to_tsvector aplica o processamento da configuração de busca escolhida.
    Posso recuperar o texto original a partir do tsvector?
    A representação não conserva necessariamente todas as palavras nem suas formas originais. Guarde o documento completo para exibi-lo, pois a preparação pode remover palavras e reduzir flexões.
    Qual é a diferença entre tsvector e tsquery?
    O tsvector representa o documento preparado. O tsquery descreve os termos procurados e suas relações lógicas. O operador @@ verifica se o documento corresponde à expressão de busca.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao revisar uma busca textual criada com agentes, você precisa conferir a preparação do documento e dos termos pesquisados.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano