Suporte a tipos variantes

info

Visualização

Esse recurso está em Public Preview.

O tipo de dados VARIANT armazena dados semiestruturados. Para exemplos de como trabalhar com VARIANT, consulte Consultar dados de variantes.

O senhor deve usar o site Databricks Runtime 15.3 ou o acima para ler e gravar tabelas com o suporte a variantes ativado.

Habilitar variante em uma tabela

Para ativar a variante, crie uma nova tabela com uma coluna do tipo VARIANT, por exemplo:

SQL

CREATE TABLE table_name (variant_column VARIANT)

Para habilitar o suporte para VARIANT em uma tabela existente, use a seguinte sintaxe:

SQL

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

atenção

Ao ativar a variante, o Databricks atualiza o protocolo da tabela. Clientes que não suportam variantes não conseguem ler a tabela. Consulte a compatibilidade e os protocolos de recursosDelta Lake.

Limitações

Aplicam-se as seguintes limitações:

• Não é possível usar colunas variantes para particionar uma tabela.
• Uma coluna variante não pode ser uma key clustering para uma tabela.
• Não é possível usar colunas variantes com cláusulas GROUP BY ou ORDER BY .
• Você não pode chamar DISTINCT em uma coluna variante.
• Você não pode usar operadores de conjunto SQL (INTERSECT, UNION, EXCEPT) com colunas variantes.
• Não é possível usar a geração de colunas para criar uma coluna variante.
• Colunas variantes não suportam estatísticas minValues ou maxValues .
• Uma coluna variante não pode conter um valor maior que 128 MiB (16 MiB no Databricks Runtime 17.1 e versões anteriores).