Suporte a tipos variantes

Importante

Esta funcionalidade está em Pré-visualização Pública.

O VARIANT tipo de dados armazena dados semi-estruturados. Para obter exemplos sobre como trabalhar com VARIANT, consulte Dados de variantes de consulta.

Você deve usar o Databricks Runtime 15.3 ou superior para ler e gravar tabelas com suporte a variantes habilitado.

Ativar variante numa tabela

Para ativar a variante, crie uma nova tabela com uma VARIANT coluna de tipos.

CREATE TABLE table_name (variant_column VARIANT)

Para permitir suporte para VARIANT numa tabela existente, use a seguinte sintaxe.

ALTER TABLE table_name SET TBLPROPERTIES('delta.feature.variantType-preview' = 'supported')

Aviso

Quando ativas a variante, o Azure Databricks atualiza o protocolo de tabelas. Clientes que não suportam variantes não conseguem ler a tabela. Consulte Compatibilidade de recursos e protocolos do Delta Lake.

Limitações

O suporte para este VARIANT tipo de dado tem as seguintes limitações.

• Não podes usar colunas variantes para particionar uma tabela.
• Uma coluna variante não pode ser uma chave de agrupamento para uma tabela.
• Não é possível usar colunas variantes com cláusulas de GROUP BY, ou ORDER BY.
• Não podes chamar DISTINCT numa coluna variante.
• Não podes usar operadores de conjunto SQL (INTERSECT, UNION, EXCEPT) com colunas variantes.
• Não podes usar geração de colunas para criar uma coluna variante.
• Colunas variantes não suportam minValues ou estatísticas maxValues.
• Uma coluna variante não pode conter um valor superior a 128 MiB (16 MiB em Databricks Runtime 17.1 e inferior).