SQL Funções de Texto

Esta é a página de consulta rápida das funções que trabalham com texto no SQLite 3.50: juntar, medir, cortar, trocar, limpar e formatar. Cada linha das tabelas traz um exemplo e o resultado que ele dá de verdade. A explicação passo a passo, com exercícios, está na aula Funções de Texto.

Juntar textos

Com dados da Loja Aurora: o || monta "cidade (UF)", e o concat_ws lida bem com o estado NULL dos fornecedores estrangeiros:

SELECT nome,
       concat_ws(' / ', cidade, estado, pais) AS local
FROM fornecedores;

Repare nas linhas de Porto e Buenos Aires: o estado é NULL, e o concat_ws simplesmente o pulou. Com cidade || ' / ' || estado || ' / ' || pais, essas duas linhas sairiam NULL inteiras.

Medir

Maiúsculas e minúsculas

SELECT nome, upper(nome) AS maiusculo, length(nome) AS letras
FROM clientes
WHERE id IN (1, 5, 9);

Cortar, procurar e trocar

Combinando substr e instr: tudo o que vem depois do @ do email (o domínio):

SELECT nome, substr(email, instr(email, '@') + 1) AS dominio
FROM clientes
WHERE id <= 3;

Limpar as pontas

Formatar: format() e printf()

format(modelo, valores…) monta um texto a partir de um modelo: cada % do modelo é trocado pelo próximo valor. printf é outro nome da mesma função (o nome antigo, que vem da linguagem C).

O uso mais comum na loja: mostrar o preço com duas casas.

SELECT nome, format('R$ %.2f', preco) AS preco
FROM produtos
WHERE id <= 3;

Comparar com padrões

Códigos, bytes e aspas

Funções que o SQLite não tem

Quem vem de outro banco sente falta de algumas funções. Todas dão no such function no SQLite, mas há um jeito de fazer cada uma:

SELECT left('Teresina', 3);

Nos outros bancos

Experimente

SELECT nome, preco
FROM produtos;

SELECT nome, format('R$ %.2f', preco) AS preco_txt
FROM produtos;

SELECT nome,
       upper(substr(nome, 1, 1)) AS inicial,
       length(nome) AS letras,
       replace(nome, ' ', '_') AS sem_espacos
FROM clientes
LIMIT 5;

Resumo

• Juntar: || (com NULL vira NULL), concat e concat_ws (pulam os NULL).
• Medir: length em letras, octet_length em bytes.
• Cortar e procurar: substr(x, início, n) (início 1, negativo conta do fim), instr, replace.
• Limpar: trim, ltrim, rtrim, com ou sem a lista de letras.
• Formatar: format / printf com %s, %d, %.2f, %05d.
• upper, lower, LIKE e NOCASE só tratam as letras sem acento.
• Não existem no SQLite: LEFT, RIGHT, LPAD, REPEAT, LEN; use substr e printf.