Compartir a través de


Compatibilidad con tipos de variantes

Importante

Esta característica está en versión preliminar pública.

El VARIANT tipo de datos almacena datos semiestructurados. Para obtener ejemplos sobre cómo trabajar con VARIANT, consulte Consulta de datos de variante.

Debe usar Databricks Runtime 15.3 o superior para leer y escribir tablas con la compatibilidad Variant habilitada.

Habilitar variante en una tabla

Para habilitar la variante, cree una nueva tabla con una VARIANT columna de tipo.

CREATE TABLE table_name (variant_column VARIANT)

Para habilitar la compatibilidad con VARIANT en una tabla existente, use la sintaxis siguiente.

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

Advertencia

Al habilitar variant, Azure Databricks actualiza el protocolo de tabla. Los clientes que no admiten variant no pueden leer la tabla. Consulte Compatibilidad y protocolos de características de Delta Lake.

Limitaciones

La compatibilidad con el VARIANT tipo de datos tiene las siguientes limitaciones.

  • No se pueden usar columnas variantes para crear particiones de una tabla.
  • Una columna variant no puede ser una clave de clúster para una tabla.
  • No se pueden usar columnas variantes con cláusulas GROUP BY o ORDER BY.
  • No se puede llamar a DISTINCT en una columna variante.
  • No se pueden usar operadores de conjunto de SQL (INTERSECT, UNION, EXCEPT) con columnas variantes.
  • No se puede usar la generación de columnas para crear una columna variante.
  • Las columnas de tipo variant no admiten estadísticas de minValues o maxValues.
  • Una columna variant no puede contener un valor mayor que 128 MiB (16 MiB en Databricks Runtime 17.1 y versiones posteriores).