Pular para o conteúdo principal
Última atualização em

Compatibilidade com tipo de Variant

info

Visualização

Esse recurso está em Prévia Pública.

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

Todas as tabelas Apache Iceberg v3 incluem suporte ao tipo VARIANT. Veja Usar os recursos do Apache Iceberg v3. Para tabelas Delta Lake, você deve habilitar explicitamente o suporte para o tipo VARIANT.

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

Habilitar variante em uma tabela​

Para habilitar a variante, crie uma nova tabela com uma coluna do tipo VARIANT.

SQL
CREATE TABLE table_name (variant_column VARIANT)

Para ativar 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

Quando você ativa a variante, o Databricks atualiza o protocolo da tabela. Clientes que não suportam o tipo variant não podem ler a tabela. Consulte a compatibilidade de recursos e protocolos do Delta Lake.

Limitações​

O suporte para o tipo de dados VARIANT tem as seguintes limitações.

  • Não é possível usar colunas variantes para particionar uma tabela.
  • Uma coluna variante não pode ser uma chave de cluster para uma tabela.
  • Não é possível usar colunas variantes com as cláusulas GROUP BY ou ORDER BY.
  • Não é possível chamar DISTINCT em uma coluna de 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 do tipo Variant não aceitam estatísticas de minValues ou maxValues.
  • Uma coluna variante não pode conter um valor maior que 128 MiB (16 MiB no Databricks Runtime 17.1 e abaixo).
Nesta página