Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
O tipo de dados que você atribui a uma coluna afeta o tamanho do armazenamento, a eficiência dos índices e o comportamento das consultas. Escolher um tipo maior do que o necessário desperdiça espaço em cada linha e em cada índice que inclui essa coluna. Escolher um tipo pequeno demais causa erros de truncamento ou perda silenciosa de dados.

Tipos Inteiros

O MySQL tem cinco tipos inteiros. Escolha o menor que caiba na faixa esperada. INT UNSIGNED dobra a faixa positiva para ~4,3B. Use UNSIGNED em chaves primárias e chaves estrangeiras que são sempre positivas — é faixa extra de graça. BIGINT ocupa o dobro do armazenamento de INT. Não o use como padrão para todos os IDs — INT comporta mais de 2 bilhões de linhas, o que é mais do que a maioria das tabelas jamais alcança.

Tipos de String

VARCHAR vs CHAR

VARCHAR(n) armazena somente os bytes que a string contém (mais 1 ou 2 bytes para o comprimento). CHAR(n) sempre armazena exatamente n bytes, preenchendo as strings mais curtas com espaços. CHAR pode ser ligeiramente mais rápido para valores de comprimento fixo, porque nenhum prefixo de comprimento precisa ser analisado. Para qualquer coisa variável, use VARCHAR.

VARCHAR vs TEXT

Os valores VARCHAR até o limite de tamanho da linha são armazenados na própria página do índice clusterizado. Os valores TEXT (e BLOB) são armazenados em páginas de overflow quando ficam grandes o suficiente. Isso significa que:
  • As colunas VARCHAR são incluídas diretamente nos índices
  • As colunas TEXT não podem ser totalmente indexadas — você precisa de um comprimento de prefixo: INDEX (description(100))
Use VARCHAR para strings que você sabe que têm menos de algumas centenas de caracteres. Use TEXT para conteúdo longo (artigos, comentários, HTML) em que o armazenamento na linha não faz sentido.

Tipos de Data e Hora

A distinção principal entre DATETIME e TIMESTAMP:
  • TIMESTAMP armazena os valores em UTC e os converte para o time_zone da sessão na leitura. Se a sua aplicação opera em vários fusos horários, TIMESTAMP faz a conversão automaticamente.
  • DATETIME armazena o valor literal sem conversão de fuso horário — o que você coloca é o que você recebe de volta.
  • TIMESTAMP tem um limite em 2038 (estouro do timestamp Unix). Para qualquer data além de 2038, use DATETIME.
Para uma discussão completa sobre o tratamento de fusos horários, consulte Timestamps e Fusos Horários no MySQL.

Decimal e Ponto Flutuante

FLOAT e DOUBLE usam ponto flutuante binário, que não consegue representar frações decimais com exatidão. 0.1 + 0.2 em ponto flutuante é 0.30000000000000004. Para dinheiro, use sempre DECIMAL.

JSON

As colunas JSON armazenam JSON validado e oferecem operadores de consulta baseados em caminho.
As colunas JSON não podem ser indexadas diretamente. Para indexar um campo JSON consultado com frequência, use uma coluna gerada:

Perguntas Frequentes

Devo usar INT ou BIGINT para chaves primárias?

INT comporta 2,1 bilhões de linhas como inteiro com sinal, 4,3 bilhões sem sinal. Para a maioria das tabelas, INT UNSIGNED é suficiente. Use BIGINT se você realmente espera passar disso, ou se está usando IDs no estilo UUID que não cabem em 4 bytes.

Posso usar VARCHAR(255) em tudo para não ter que pensar nisso?

Pode, mas declarações VARCHAR mais longas produzem chaves de índice mais largas, o que aumenta o uso de memória do índice e reduz quantas entradas de índice cabem por página. Declare o máximo realista — VARCHAR(100) para um campo de nome, não VARCHAR(255). O custo real de armazenamento corresponde ao comprimento dos dados, mas o comprimento da chave de índice é fixado no tamanho declarado.

Qual é a diferença prática entre NULL e um valor padrão?

NULL significa “desconhecido” — ele se propaga pelas expressões e é excluído das funções de agregação. Um valor padrão como 0 ou '' significa “definido explicitamente como vazio”. Escolha NULL para dados realmente ausentes; escolha um padrão para cenários de “ainda não definido” em que você quer que a coluna tenha um valor sensato imediatamente. Misturar os dois cria inconsistência nas consultas.

Solução de Problemas

Veja também