Prise en charge des types de variantes

Important

Cette fonctionnalité est disponible en préversion publique.

Le VARIANT type de données stocke les données semi-structurées. Pour obtenir des exemples sur l’utilisation de VARIANT, consultez les données de variante de requête.

Vous devez utiliser Databricks Runtime 15.3 ou une version ultérieure pour lire et écrire des tables avec la prise en charge des variantes activée.

Activer une variante sur une table

Pour activer la variante, créez une table avec une VARIANT colonne de type.

CREATE TABLE table_name (variant_column VARIANT)

Pour activer la prise en charge VARIANT sur une table existante, utilisez la syntaxe suivante.

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

Avertissement

Lorsque vous activez la variante, Azure Databricks met à niveau le protocole de table. Les clients qui ne prennent pas en charge la variante ne peuvent pas lire la table. Consultez les protocoles et la compatibilité des fonctionnalités Delta Lake.

Limites

La prise en charge du VARIANT type de données présente les limitations suivantes.

• Vous ne pouvez pas utiliser de colonnes variant pour partitionner une table.
• Une colonne variant ne peut pas être une clé de clustering pour une table.
• Vous ne pouvez pas utiliser de colonnes de variantes avec les clauses GROUP BY ou ORDER BY.
• Vous ne pouvez pas utiliser DISTINCT sur une colonne de type variant.
• Vous ne pouvez pas utiliser d’opérateurs de jeu SQL (INTERSECT, UNION, EXCEPT) avec des colonnes de type variant.
• Vous ne pouvez pas utiliser la génération de colonnes pour créer une colonne de type variant.
• Les colonnes variant ne prennent pas en charge les statistiques minValues ou maxValues.
• Une colonne variant ne peut pas contenir une valeur dépassant 128 Mio (16 Mio dans Databricks Runtime 17.1 et versions antérieures).