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 →
Uma coluna gerada é uma coluna cujo valor é derivado de uma expressão, em vez de armazenado pela aplicação. O MySQL a calcula automaticamente — você define a fórmula uma vez no schema, e o MySQL a mantém consistente.

Sintaxe

VIRTUAL vs STORED

Use STORED quando o cálculo for caro e você ler a coluna muito mais do que a grava. Use VIRTUAL (o padrão) quando o armazenamento for uma preocupação ou as gravações forem frequentes.

Expressões

As expressões de colunas geradas podem referenciar outras colunas da mesma linha. Elas não podem referenciar outras colunas geradas nem chamar funções não determinísticas.
As funções permitidas em colunas geradas devem ser determinísticas — as mesmas entradas sempre produzem a mesma saída. Não permitidos: NOW(), RAND(), UUID(), subconsultas, funções armazenadas. Extrair campos de JSON é um caso de uso comum:

Indexando Colunas Geradas

Você pode adicionar um índice em uma coluna gerada. Para colunas VIRTUAL, o MySQL materializa o valor calculado no índice.
É assim também que se constrói um índice funcional — um índice sobre uma função de uma coluna, em vez do valor bruto da coluna. O MySQL 8.0.13+ suporta índices funcionais diretamente (INDEX (LOWER(email))), o que internamente cria uma coluna gerada oculta:

Inserindo e Atualizando

Você não pode atribuir um valor a uma coluna gerada em um INSERT ou UPDATE. O valor da coluna é sempre derivado da expressão. Você pode escrever DEFAULT explicitamente, mas é só isso:

ALTER TABLE

Adicione uma coluna gerada a uma tabela existente:
Altere a expressão de uma coluna gerada. A classe de armazenamento VIRTUAL/STORED precisa permanecer a mesma — trocá-la gera ERROR 3106: 'Changing the STORED status' is not supported for generated columns, então mudar o armazenamento significa remover e adicionar a coluna novamente:

Perguntas Frequentes

Posso usar uma coluna gerada em uma cláusula WHERE?

Sim. Para colunas VIRTUAL sem índice, o MySQL calcula a expressão durante a varredura. Para colunas STORED ou colunas VIRTUAL indexadas, o valor já está materializado. Use EXPLAIN para verificar se o índice está sendo usado.

Uma coluna gerada é atualizada automaticamente quando as colunas de origem mudam?

Sim. O MySQL recalcula as colunas geradas VIRTUAL em cada leitura. As colunas geradas STORED são recalculadas e gravadas em cada INSERT ou UPDATE que afeta as colunas da expressão.

Posso usar uma coluna gerada como chave de partição?

Sim, tanto para colunas geradas STORED quanto VIRTUAL.

Solução de Problemas

Veja também