Menu

Tipos de dados no PostgreSQL: qual usar em cada coluna

Os tipos de dados do PostgreSQL que você vai usar em quase toda coluna: inteiros, numeric, text, boolean, timestamptz, uuid, jsonb, arrays e enums, e quando escolher cada um.

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

Toda coluna do PostgreSQL tem um tipo fixo, definido no CREATE TABLE. A maioria das tabelas precisa só de alguns: bigint ou integer para números inteiros, numeric para dinheiro, text para strings, boolean, timestamptz para momentos no tempo e jsonb para documentos. pg_typeof() mostra o tipo de qualquer valor.

Os principais tipos e quando usar cada um

TipoGuardaUse para
integer (int)Inteiros até cerca de 2,1 bilhões, 4 bytesContagens, quantidades, ids pequenos
bigintInteiros até cerca de 9,2 quintilhões, 8 bytesChaves primárias, tudo que pode crescer
smallintAté 32767, 2 bytesRaramente vale a pena
numeric(p, s)Decimais exatosDinheiro, taxas, tudo que é somado
real, double precisionPonto flutuante binárioMedições, valores científicos
textStrings de qualquer tamanhoNomes, emails, descrições
varchar(n)Strings com limite de tamanhoQuando o limite é uma regra
booleantrue, false ou NULLFlags
dateUm dia do calendárioAniversários, datas de vencimento
timestamptzUm momento no tempoHorários de criação e atualização
intervalUma duração'2 hours', '30 days'
uuidIdentificador de 128 bitsIds públicos ou distribuídos
jsonbJSON já interpretadoDados sem formato fixo
text[], int[]Arrays de qualquer tipoListas curtas, tags
byteaBytes brutosValores binários pequenos

As escolhas maiores têm páginas próprias: timestamp vs timestamptz, tipos enum, jsonb e arrays. Ids (serial, colunas identity, uuid) ficam na parte de chaves primárias.

numeric vs double precision

numeric guarda decimais de forma exata. real e double precision guardam frações binárias, então valores como 0.1 são aproximações e as somas podem se desviar:

A soma numeric é 0.3. A soma em ponto flutuante é 0.30000000000000004, e o teste de igualdade dá false. Use numeric para dinheiro: numeric(10, 2) aceita 10 dígitos no total, 2 depois do ponto, e arredonda as casas extras no insert.

Dividir um inteiro por outro inteiro descarta a parte fracionária:

7 / 2 retorna 3. Faça um dos lados ser numeric (um literal com ponto decimal ou uma conversão) para obter 3.5.

text vs varchar(n) vs char(n)

Os três usam o mesmo armazenamento, e nenhum é mais rápido. varchar(n) rejeita valores mais longos no insert, o que só ajuda quando o limite é uma regra dos seus dados. char(n) completa com espaços e não tem uso em tabelas novas. Uma conversão explícita para varchar(n) corta o valor em vez de falhar.

A conversão retorna Post. O valor char(5) ocupa 5 bytes, mas length ignora o preenchimento e retorna 2.

Valores boolean e NULL

Uma coluna boolean aceita true, false, 't', 'yes', 'on', '1' e seus opostos, e sempre retorna true ou false. Um valor ausente é NULL, que não é nenhum dos dois, então WHERE NOT active pula as linhas em que active é NULL.

Use IS TRUE, IS NOT TRUE ou COALESCE(active, false) quando NULL deve contar como falso.

Perguntas frequentes

Existe diferença de desempenho entre text e varchar no PostgreSQL?

Não. text, varchar e varchar(n) são armazenados do mesmo jeito. varchar(n) só acrescenta uma verificação de tamanho, então use text, a não ser que o limite seja uma regra real dos seus dados.

Devo usar o tipo money no PostgreSQL?

Geralmente não. A entrada e a saída dependem da configuração lc_monetary, e o valor não registra a moeda. Guarde os valores em numeric(12,2) e a moeda numa coluna própria.

Qual é o equivalente de DATETIME no PostgreSQL?

timestamptz (timestamp with time zone) para momentos no tempo, ou timestamp para um horário de relógio sem fuso. O PostgreSQL não tem um tipo DATETIME.

Como ver o tipo de um valor ou de uma coluna no PostgreSQL?

SELECT pg_typeof(expression) retorna o tipo de qualquer expressão, inclusive de uma coluna. No psql, \d table_name lista cada coluna com seu tipo.

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

Aprenda a programar com o Coddy

Começar