Menu

Funções de texto no PostgreSQL: substring, concat

As funções de texto do PostgreSQL que você usa todo dia: substring, left e right, || e concat, split_part, position, replace, regexp_replace, trim, lpad e format.

Esta página tem editores executáveis. Edite, execute e veja a saída na hora.

As funções de texto do PostgreSQL que você mais vai usar:

  • substring(text FROM start FOR length) recorta uma parte do texto. As posições começam em 1.
  • || ou concat() junta textos.
  • split_part(text, delimiter, n) pega um campo de um texto com delimitador.
  • replace(text, from, to) substitui todas as ocorrências de uma substring.

A Ada recebe Ada Lovelace e o domínio example.com. concat_ws ignora o sobrenome que falta para a Lin, então o nome completo dela é Lin, sem espaço no final.

Extrair parte de um texto

O resultado é PostgreS, gre, Post, SQL, Postgre e 0042.

  • substring(... FROM start FOR length) é a forma do padrão SQL; substr(text, start, length) faz o mesmo como função comum. Omita o tamanho para pegar o resto do texto.
  • Um número negativo em left ou right significa todos menos os n últimos (ou primeiros) caracteres.
  • Com uma expressão regular depois do FROM, substring retorna a primeira correspondência, ou o primeiro grupo entre parênteses se o padrão tiver um.

Juntar textos: ||, concat e concat_ws

|| retorna NULL assim que um dos lados é NULL. concat trata NULL como texto vazio e retorna ab. concat_ws coloca o separador entre os valores que não são NULL e retorna Ada, London. Quando um lado do || é texto, um número do outro lado é convertido, como em id-42.

Para juntar os valores de muitas linhas num único texto, use string_agg.

Dividir, encontrar e substituir

Os resultados são example.com, c, 4, 2026/11/17, a#b#c# e {red,green,blue}.

  • split_part retorna um texto vazio quando o campo não existe. Um número de campo negativo conta a partir do fim (desde o PostgreSQL 14).
  • position(sub IN text) e strpos(text, sub) retornam a posição começando em 1, ou 0 quando não encontram.
  • replace substitui todas as ocorrências e diferencia maiúsculas. regexp_replace substitui só a primeira correspondência, a menos que você passe a flag 'g'; adicione 'i' para ignorar maiúsculas.
  • regexp_split_to_table(text, pattern) divide em linhas em vez de num array.

Para testar padrões no WHERE (LIKE, ILIKE, ~), veja LIKE, ILIKE e expressões regulares.

Limpar, preencher e formatar

O resultado é hello, hi, 00042, Hello World, 5 e Ada has 3 items. ltrim e rtrim cortam só um lado. lpad e rpad também cortam um texto que já é maior que o tamanho desejado.

length conta caracteres e octet_length conta bytes; eles diferem em texto não ASCII como é. format usa %s para um valor, %I para um identificador entre aspas e %L para um literal entre aspas. Isso o torna o jeito seguro de montar SQL dinâmico dentro de funções.

Referência rápida

TarefaFunçãoExemplo de resultado
Maiúsculas, minúsculasupper(s), lower(s)ADA, ada
Começa comstarts_with(s, 'pre') ou s LIKE 'pre%'true
Repetir, inverterrepeat('ab', 3), reverse('abc')ababab, cba
Primeira correspondência de uma regexsubstring(s FROM 'pattern')o texto encontrado
Todas as correspondências de uma regexregexp_matches(s, 'pattern', 'g')uma linha por correspondência
Número para texto com formatoto_char(1234.5, 'FM9,999.00')1,234.50

A referência oficial de funções de texto lista o resto.

Perguntas frequentes

Como verificar se um texto contém uma substring no PostgreSQL?

position('needle' IN haystack) > 0 ou strpos(haystack, 'needle') > 0, ou numa cláusula WHERE haystack LIKE '%needle%'. Use ILIKE para ignorar maiúsculas e starts_with(haystack, 'prefix') para testar um prefixo.

Por que o || retorna NULL no PostgreSQL?

Se qualquer operando do || for NULL, o resultado é NULL. Use concat() ou concat_ws(), que ignoram argumentos NULL, ou envolva o valor que pode ser nulo em COALESCE(value, '').

As posições de texto no PostgreSQL começam em 1?

Sim. As posições começam em 1, então substring('abc' FROM 1 FOR 1) é a, e position retorna 0 quando não encontra o texto.

Qual a diferença entre text e varchar no PostgreSQL?

Nenhuma em velocidade ou armazenamento. varchar(n) adiciona uma checagem de tamanho; text e varchar sem tamanho não têm limite além do máximo de 1 GB por valor. Todas as funções de texto aceitam os dois.

Ilustração das linguagens de programação do Coddy

Aprenda a programar com o Coddy

Começar