VARIANT tür

Şunlar için geçerlidir: Databricks Runtime 15.3 ve üzeri

Yarı yapılandırılmış verileri temsil eder.

Sözdizimi

VARIANT

Sınırlar

türü, , ARRAY, MAPve skaler türler dahil olmak üzere STRUCTyarı yapılandırılmış verilerin depolanmasını destekler. VARIANTyalnızca türünde STRINGanahtarlara sahip türleri depolayabilirMAP.

Değişmez Değerler

Değer oluşturma VARIANT hakkında ayrıntılı bilgi için bkz. parse_json işlev işlevi. ayrıca işlevini kullanarak CAST bir türdeki VARIANTdeğişmez değeri değerine dönüştürebilirsiniz.

Notlar

• bir değerinden VARIANT bir değer ayıklamak için
  • karmaşık bir türe gitmek için JSON yol ifadesi kullanan variant_get işlevi.
  • : bir JSON yol ifadesi kullanarak ayrıştırmak VARIANT için (iki nokta üst üste işareti) işleci.
  • hata toleransı ile karmaşık bir türe gitmek için JSON yolu kullanan try_variant_get işlevi .
  • cast işlevi veya :: (iki nokta üst üste işareti) işlecini VARIANT belirli bir türe atama.
  • try_cast hata toleransı VARIANT ile öğesini belirli bir türe dönüştürme işlevi.
• Bir VARIANT değerin türünü incelemek için
  • Tek bir değer için schema_of_variant işlevi .
  • Bir değer koleksiyonu için toplama işlevini schema_of_variant_agg.

Örnekler

> 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

İlişkili

• :: (iki nokta üst üste işareti) işleci
• cast işlevi
• parse_json işlevi
• schema_of_variant işlevi
• schema_of_variant_agg toplama işlevi
• try_cast işlevi
• try_variant_get işlevi
• variant_get işlevi