Conversão entre tipos
Um cast converte um valor de um tipo para outro, como de texto para inteiro. Você pode indicar a conversão explicitamente na consulta. O banco também aplica certas conversões implícitas quando a expressão e os tipos envolvidos permitem.
Texto convertido para uma soma
Este exemplo didático usa a sintaxe CAST no PostgreSQL. A expressão recebe o texto '42', converte seu conteúdo para integer e soma uma unidade.
SELECT CAST('42' AS integer) + 1 AS resultado;O resultado é o número 43, pois a adição recebe um inteiro após a conversão. O PostgreSQL também aceita '42'::integer para expressar esse cast. Essa sintaxe com dois-pontos duplos é própria do PostgreSQL, por isso você precisa conferir a sintaxe aceita ao transportar a consulta para outro banco.
Conversão aceita e conteúdo válido
A existência de uma conversão entre tipos não torna qualquer conteúdo válido no destino. Trocar '42' por 'quarenta' provoca erro na conversão para inteiro. O tipo de destino define a representação aceita e o intervalo de valores possíveis.
Uma conversão implícita depende das condições autorizadas pelo banco. No PostgreSQL, um cast permitido numa atribuição a uma coluna não fica necessariamente disponível para qualquer expressão. Explicitar o destino permite indicar a interpretação pretendida, mas o banco ainda precisa oferecer aquela conversão.
Dúvidas frequentes
Perguntas frequentes sobre cast
- O cast altera o tipo da coluna armazenada?
- Um cast aplicado numa expressão converte o valor usado por aquela expressão. Ele não altera a definição da coluna. Mudar o tipo da coluna exige uma alteração própria na tabela.
- Uma conversão permitida pode falhar para determinado valor?
- O texto '42' pode ser convertido para inteiro no PostgreSQL. O texto 'quarenta' provoca erro nessa conversão porque não é uma representação válida de inteiro.
- Todo cast executa uma função de conversão?
- Alguns casts do PostgreSQL aproveitam representações internas compatíveis e dispensam uma função de conversão. Outros usam uma função ou a saída textual da origem seguida da entrada do destino.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: definição de conversões entre tipos
Conversões explícitas e implícitas, funções e compatibilidade de representação.
Abrir recursoDocumentação
PostgreSQL: casts em expressões
Sintaxes CAST e ::, interpretação do valor e condições da conversão.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
O Desenvolvimento Colaborativo oferece orientação ao vivo para investigar erros de conversão e revisar os tipos usados nas consultas do seu aplicativo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você precisa conferir os tipos usados por consultas geradas com agentes para interpretar resultados numéricos e erros de conversão.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.