VARIANT Typ

Gilt für: Databricks SQL Databricks Runtime 15.3 und höher

Wichtig

Dieses Feature befindet sich in der öffentlichen Vorschau.

Stellt semi-strukturierte Daten dar.

Hinweis

Iceberg v2-Tabellen unterstützen keine VARIANT-Spalten. Apache Iceberg v3 unterstützt VARIANT Spalten. Siehe "Apache Iceberg v3-Features verwenden".

Syntax

VARIANT

Grenzwerte

Der Typ unterstützt das Speichern halbstrukturierter Daten OBJECT, ARRAYund skalarer Typen. Um STRUCT und MAP zu speichern, verwenden Sie die Funktion to_variant_object. MAP Schlüssel müssen vom Typ STRINGsein.

Literale

Details zum Erstellen eines parse_json Werts finden Sie in der . Sie können auch die CAST-Funktion nutzen, um ein Literal eines bestimmten Typs in VARIANT zu konvertieren.

Notizen

• Um einen Wert aus einem VARIANT zu extrahieren, können Sie die
  • variant_get-Funktion mit einem JSON-Pfadausdruck, um zu einem komplexen Typ zu navigieren
  • :-Operator (Doppelpunkt), um VARIANT mithilfe eines JSON-Pfadausdrucks zu parsen
  • try_variant_get-Funktion mit einem JSON-Pfad, um zu einem komplexen Typ mit Fehlertoleranz zu navigieren
  • cast-Funktion oder ::-Operator (Doppel-Doppelpunkt), um VARIANT in einen bestimmten Typ umzuwandeln
  • try_cast Funktion, um den VARIANT in einen bestimmten Typ mit Fehlertoleranz zu umwandeln.
• Um den Typ eines VARIANT Werts zu überprüfen, verwenden Sie die
  • schema_of_variant funktion für einen einzelnen Wert.
  • schema_of_variant_agg Aggregatfunktion für eine Sammlung von Werten.

Beispiele

> 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" }

Verwandte Themen

• ::-Operator (doppeltes Doppelpunktzeichen)
• cast Funktion
• parse_json Funktion
• schema_of_variant Funktion
• schema_of_variant_agg Aggregatfunktion
• try_cast Funktion
• try_variant_get Funktion
• variant_get Funktion