variant_get دالة

ينطبق على: Databricks SQL Databricks Runtime 15.3 والإحدث

استخراج قيمة من نوع من variantExpr، محددة بواسطة path.

بناء الجملة

variant_get ( variantExpr, path, type )

الوسيطات

• variantExpr: تعبير VARIANT .
• pathSTRING: قيمة حرفية مع تعبير مسار JSON جيد التكوين.
• typeSTRING: قيمة حرفية تحدد النوع.

المرتجعات

قيمة من النوع type.

إذا تعذر العثور على الكائن، NULL يتم إرجاعه. إذا تم العثور على الكائن ولكن لا يمكن تحويله إلى النوع المطلوب، فإن Azure Databricks يرفع INVALID_VARIANT_CAST. NULL للعودة بدلا من خطأ، استخدم الدالة try_variant_get.

الأمثلة

-- Simple example
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.data[1].a', 'string')
  hello

-- missing path
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.missing', 'int')
  null

-- Invalid cast
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.key', 'array<int>')
  Error: INVALID_VARIANT_CAST.

الدالات ذات الصلة

• الدالة try_variant_get
• الدالة parse_json
• تعبير مسار JSON