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.||ouconcat()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
leftourightsignifica todos menos os n últimos (ou primeiros) caracteres. - Com uma expressão regular depois do
FROM,substringretorna 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_partretorna 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)estrpos(text, sub)retornam a posição começando em 1, ou 0 quando não encontram.replacesubstitui todas as ocorrências e diferencia maiúsculas.regexp_replacesubstitui 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
| Tarefa | Função | Exemplo de resultado |
|---|---|---|
| Maiúsculas, minúsculas | upper(s), lower(s) | ADA, ada |
| Começa com | starts_with(s, 'pre') ou s LIKE 'pre%' | true |
| Repetir, inverter | repeat('ab', 3), reverse('abc') | ababab, cba |
| Primeira correspondência de uma regex | substring(s FROM 'pattern') | o texto encontrado |
| Todas as correspondências de uma regex | regexp_matches(s, 'pattern', 'g') | uma linha por correspondência |
| Número para texto com formato | to_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.