VARIANT típus

A következőre vonatkozik: Databricks SQL Databricks Runtime 15.3 és újabb

Félig strukturált adatokat jelöl.

Megjegyzés:

A Iceberg v2-táblák nem támogatják az VARIANT oszlopokat. Az Apache Iceberg v3 támogatja az VARIANT oszlopokat. Lásd: Apache Iceberg v3-funkciók használata.

Szintaxis

VARIANT

Korlátok

A típus támogatja a részben strukturált adatok OBJECTés ARRAYskaláris típusok tárolását. A STRUCT és MAP tárolásához használja a to_variant_object függvényt. MAP a kulcsok típusának STRINGkell lennie.

Literálok

A parse_json érték létrehozásának részleteiért tekintse meg függvényt. A CAST függvény használatával egy adott típusú literált átalakíthat VARIANT típusúvá.

Jegyzetek

• Ha ki szeretne nyerni egy értéket egy adott VARIANT értékből, használhatja a
  • variant_get függvény egy JSON-elérésiút-kifejezéssel összetett típusba navigálni.
  • : (kettőspontjel) operátor a VARIANT JSON-elérési útkifejezéssel történő elemzéséhez.
  • try_variant_get függvény egy JSON-elérési úttal egy összetett típusba való navigáláshoz hibatűréssel.
  • cast függvény vagy a :: (kettőspont) operátor, hogy a VARIANT-t egy adott típusra alakítsa.
  • try_cast függvény a VARIANT egy adott típusra való konvertálásához hibatűréssel.
• Egy VARIANT érték típusának vizsgálatához használja a
  • schema_of_variant függvény egy adott értékhez.
  • schema_of_variant_agg összesítő függvény értékek gyűjteményéhez.

Példák

> SELECT parse_json('{"key": 123, "data": [4, 5, "str"]}');
  {"data":[4,5,"str"],"key":123}

> SELECT parse_json(null);
  null

> SELECT parse_json('123');
  123

> SELECT CAST(123.456 AS VARIANT);
  123.456

> SELECT to_variant_object(map('key', 'val'));
  { "key": "val" }

> SELECT to_variant_object(struct('field', 'val'));
  { "field": "val" }

Kapcsolódó

• :: (kettőspont kettőspont jel) operátor
• cast függvény
• parse_json függvény
• schema_of_variant függvény
• schema_of_variant_agg összesítő függvény
• try_cast függvény
• try_variant_get függvény
• variant_get függvény