Typ VARIANT

Platí pro: Databricks SQL Databricks Runtime 15.3 a novější

Důležitý

Tato funkce je ve verzi Public Preview.

Představuje částečně strukturovaná data.

Poznámka:

Tabulky Iceberg v2 nepodporují VARIANT sloupce. Apache Iceberg v3 podporuje VARIANT sloupce. Viz Použití funkcí Apache Iceberg v3.

Syntaxe

VARIANT

Omezení

Tento typ podporuje ukládání všech částečně strukturovaných dat, včetně STRUCT, ARRAY, MAPa skalárních typů. VARIANT může ukládat pouze typy MAP s klíči typu STRING.

Literály

Podrobnosti o vytvoření hodnoty parse_json najdete v části týkající se funkcí . Funkci CAST můžete také použít k převodu literálu určitého typu na VARIANT.

Poznámky

• K extrahování hodnoty z VARIANT můžete použít
  • variant_get funkci pomocí výrazu cesty JSON k přechodu na komplexní typ.
  • : operátoru dvojtečky parsovat VARIANT pomocí výrazu cesty JSON.
  • try_variant_get funkce pomocí cesty JSON pro navigaci do komplexního typu s tolerancí vůči chybám.
  • cast operátor nebo :: (dvojtečka) přetypování VARIANT na určitý typ.
  • try_cast funkce pro převod VARIANT na konkrétní typ s tolerancí chyb.
• Pokud chcete zkontrolovat typ VARIANT hodnoty, použijte
  • schema_of_variant funkce pro jednotlivé hodnoty.
  • schema_of_variant_agg agregační funkce pro kolekci hodnot.

Příklady

> 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

Související

• :: (operátor dvojité dvojtečky) – operátor
• cast funkce
• parse_json funkce
• schema_of_variant funkce
• schema_of_variant_agg agregační funkce
• try_cast funkce
• try_variant_get funkce
• variant_get funkce