Typ: VARIANT

Gäller för: Databricks Runtime 15.3 och senare

Representerar halvstrukturerade data.

Syntax

VARIANT

Gränser

Typen stöder lagring av halvstrukturerade data, inklusive STRUCT, ARRAY, MAPoch skalärtyper. VARIANT kan bara lagra MAP typer med nycklar av typen STRING.

Literaler

Mer VARIANT parse_json. Du kan också använda CAST funktionen för att konvertera en literal av någon typ till VARIANT.

Kommentar

• Om du vill extrahera ett värde från en VARIANT kan du använda
  • variant_get funktion med hjälp av ett JSON-sökvägsuttryck för att navigera till en komplex typ.
  • : operatorn (kolontecken) för att parsa med hjälp av VARIANT ett JSON-sökvägsuttryck.
  • try_variant_get funktion med hjälp av en JSON-sökväg för att navigera till en komplex typ med fel tolererande.
  • cast-funktion eller :: (kolontecken) operator för att kasta VARIANT till en viss typ.
  • try_cast funktion för att omvandla VARIANT till en viss typ med felanlering.
• Om du vill kontrollera typen av ett VARIANT värde använder du
  • schema_of_variant funktion för ett enskilt värde.
  • schema_of_variant_agg aggregatfunktion för en samling av values.

Exempel

> 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

Relaterade

• :: operator (kolonkolontecken)
• cast-funktion
• funktionen parse_json
• funktionen schema_of_variant
• schema_of_variant_agg mängdfunktion
• funktionen try_cast
• funktionen try_variant_get
• funktionen variant_get