ClickHouse/docs/fa/sql_reference/functions/json_functions.md
2020-04-04 12:15:31 +03:00

11 KiB
Raw Blame History

machine_translated machine_translated_rev toc_priority toc_title
true d734a8e46d 56 کار با جانسون.

توابع برای کار با جانسون

در یاندکسمتریکا جیسون توسط کاربران به عنوان پارامترهای جلسه منتقل می شود. برخی از توابع خاص برای کار با این جانسون وجود دارد. (اگر چه در بسیاری از موارد jsons هستند علاوه بر این قبل از پردازش و در نتیجه ارزش ها قرار داده و در ستون جداگانه در خود پردازش فرمت.) همه این توابع در فرضیات قوی در مورد چه جانسون می تواند بر اساس, اما سعی می کنند به عنوان کوچک که ممکن است به کار انجام می شود.

مفروضات زیر ساخته شده است:

  1. نام فیلد (استدلال تابع) باید ثابت باشد.
  2. نام فیلد به نحوی می تواند در جیسون کد گذاری شود. به عنوان مثال: visitParamHas('{"abc":"def"}', 'abc') = 1 اما visitParamHas('{"\\u0061\\u0062\\u0063":"def"}', 'abc') = 0
  3. زمینه ها برای در هر سطح تودرتو جستجو, یکسره. اگر زمینه های تطبیق های متعدد وجود دارد, وقوع اول استفاده شده است.
  4. JSON ندارد کاراکتر فضای خارج از string literals.

ویسیتپراماس (پارامز, نام)

بررسی اینکه یک میدان با وجود name اسم.

ویسیتپرامستراکتینت (پارامز, نام)

تجزیه ظاهری64 از ارزش این زمینه به نام name. اگر این یک رشته رشته زمینه, تلاش می کند به تجزیه یک عدد از ابتدای رشته. اگر میدان وجود ندارد, و یا وجود دارد اما حاوی یک عدد نیست, باز می گردد 0.

ویزیتپرامستراکتینت (پارامز, نام)

همان int64.

اطلاعات دقیق)

همان است که برای شناور64.

ویسیتپرامسترکتبولبولول (پارامز, نام)

تجزیه واقعی / ارزش کاذب. نتیجه این است uint8.

ویسیتپرمککتراو (پارامز, نام)

بازگرداندن ارزش یک میدان, از جمله جدا.

مثالها:

visitParamExtractRaw('{"abc":"\\n\\u0000"}', 'abc') = '"\\n\\u0000"'
visitParamExtractRaw('{"abc":{"def":[1,2,3]}}', 'abc') = '{"def":[1,2,3]}'

نام و نام خانوادگی)

تجزیه رشته در نقل قول دو. ارزش بی نتیجه است. اگر بیم شکست خورده, این یک رشته خالی می گرداند.

مثالها:

visitParamExtractString('{"abc":"\\n\\u0000"}', 'abc') = '\n\0'
visitParamExtractString('{"abc":"\\u263a"}', 'abc') = '☺'
visitParamExtractString('{"abc":"\\u263"}', 'abc') = ''
visitParamExtractString('{"abc":"hello}', 'abc') = ''

در حال حاضر هیچ پشتیبانی برای نقاط کد در قالب وجود دارد \uXXXX\uYYYY این از هواپیما چند زبانه پایه نیست (به جای اوتو-8 تبدیل می شود).

توابع زیر بر اساس سیمدجسون طراحی شده برای نیازهای پیچیده تر جسون تجزیه. فرض 2 ذکر شده در بالا هنوز هم صدق.

هشدار داده می شود)

چک که رشته گذشت جانسون معتبر است.

مثالها:

SELECT isValidJSON('{"a": "hello", "b": [-100, 200.0, 300]}') = 1
SELECT isValidJSON('not a json') = 0

JSONHas(json[, indices_or_keys]…)

اگر مقدار در سند جسون وجود داشته باشد, 1 برگردانده خواهد شد.

اگر این مقدار وجود ندارد, 0 برگردانده خواهد شد.

مثالها:

SELECT JSONHas('{"a": "hello", "b": [-100, 200.0, 300]}', 'b') = 1
SELECT JSONHas('{"a": "hello", "b": [-100, 200.0, 300]}', 'b', 4) = 0

indices_or_keys لیستی از استدلال های صفر یا بیشتر است که هر کدام می توانند رشته یا عدد صحیح باشند.

  • رشته = عضو شی دسترسی های کلیدی.
  • عدد صحیح مثبت = از ابتدا به عضو / کلید نفر دسترسی پیدا کنید.
  • عدد صحیح منفی = دسترسی به عضو / کلید نفر از پایان.

حداقل شاخص عنصر 1 است. بنابراین عنصر 0 وجود ندارد.

شما می توانید از اعداد صحیح برای دسترسی به هر دو اشیای جسون ارریس و جسون استفاده کنید.

بنابراین, مثلا:

SELECT JSONExtractKey('{"a": "hello", "b": [-100, 200.0, 300]}', 1) = 'a'
SELECT JSONExtractKey('{"a": "hello", "b": [-100, 200.0, 300]}', 2) = 'b'
SELECT JSONExtractKey('{"a": "hello", "b": [-100, 200.0, 300]}', -1) = 'b'
SELECT JSONExtractKey('{"a": "hello", "b": [-100, 200.0, 300]}', -2) = 'a'
SELECT JSONExtractString('{"a": "hello", "b": [-100, 200.0, 300]}', 1) = 'hello'

JSONLength(json[, indices_or_keys]…)

بازگشت طول یک مجموعه جانسون یا یک شی جانسون.

اگر مقدار وجود ندارد و یا دارای یک نوع اشتباه, 0 برگردانده خواهد شد.

مثالها:

SELECT JSONLength('{"a": "hello", "b": [-100, 200.0, 300]}', 'b') = 3
SELECT JSONLength('{"a": "hello", "b": [-100, 200.0, 300]}') = 2

JSONType(json[, indices_or_keys]…)

بازگشت به نوع یک مقدار جانسون.

اگر این مقدار وجود ندارد, Null برگردانده خواهد شد.

مثالها:

SELECT JSONType('{"a": "hello", "b": [-100, 200.0, 300]}') = 'Object'
SELECT JSONType('{"a": "hello", "b": [-100, 200.0, 300]}', 'a') = 'String'
SELECT JSONType('{"a": "hello", "b": [-100, 200.0, 300]}', 'b') = 'Array'

JSONExtractUInt(json[, indices_or_keys]…)

JSONExtractInt(json[, indices_or_keys]…)

JSONExtractFloat(json[, indices_or_keys]…)

JSONExtractBool(json[, indices_or_keys]…)

تجزیه جانسون و استخراج ارزش. این توابع شبیه به visitParam توابع.

اگر مقدار وجود ندارد و یا دارای یک نوع اشتباه, 0 برگردانده خواهد شد.

مثالها:

SELECT JSONExtractInt('{"a": "hello", "b": [-100, 200.0, 300]}', 'b', 1) = -100
SELECT JSONExtractFloat('{"a": "hello", "b": [-100, 200.0, 300]}', 'b', 2) = 200.0
SELECT JSONExtractUInt('{"a": "hello", "b": [-100, 200.0, 300]}', 'b', -1) = 300

JSONExtractString(json[, indices_or_keys]…)

تجزیه جانسون و استخراج یک رشته. این تابع شبیه به visitParamExtractString توابع.

اگر مقدار وجود ندارد و یا دارای یک نوع اشتباه, یک رشته خالی بازگردانده خواهد شد.

ارزش بی نتیجه است. اگر بیم شکست خورده, این یک رشته خالی می گرداند.

مثالها:

SELECT JSONExtractString('{"a": "hello", "b": [-100, 200.0, 300]}', 'a') = 'hello'
SELECT JSONExtractString('{"abc":"\\n\\u0000"}', 'abc') = '\n\0'
SELECT JSONExtractString('{"abc":"\\u263a"}', 'abc') = '☺'
SELECT JSONExtractString('{"abc":"\\u263"}', 'abc') = ''
SELECT JSONExtractString('{"abc":"hello}', 'abc') = ''

JSONExtract(json[, indices_or_keys…], return_type)

تجزیه یک جسون و استخراج یک مقدار از نوع داده داده داده کلیک.

این یک تعمیم قبلی است JSONExtract<type> توابع. این به این معنی است JSONExtract(..., 'String') بازده دقیقا همان JSONExtractString(), JSONExtract(..., 'Float64') بازده دقیقا همان JSONExtractFloat().

مثالها:

SELECT JSONExtract('{"a": "hello", "b": [-100, 200.0, 300]}', 'Tuple(String, Array(Float64))') = ('hello',[-100,200,300])
SELECT JSONExtract('{"a": "hello", "b": [-100, 200.0, 300]}', 'Tuple(b Array(Float64), a String)') = ([-100,200,300],'hello')
SELECT JSONExtract('{"a": "hello", "b": [-100, 200.0, 300]}', 'b', 'Array(Nullable(Int8))') = [-100, NULL, NULL]
SELECT JSONExtract('{"a": "hello", "b": [-100, 200.0, 300]}', 'b', 4, 'Nullable(Int64)') = NULL
SELECT JSONExtract('{"passed": true}', 'passed', 'UInt8') = 1
SELECT JSONExtract('{"day": "Thursday"}', 'day', 'Enum8(\'Sunday\' = 0, \'Monday\' = 1, \'Tuesday\' = 2, \'Wednesday\' = 3, \'Thursday\' = 4, \'Friday\' = 5, \'Saturday\' = 6)') = 'Thursday'
SELECT JSONExtract('{"day": 5}', 'day', 'Enum8(\'Sunday\' = 0, \'Monday\' = 1, \'Tuesday\' = 2, \'Wednesday\' = 3, \'Thursday\' = 4, \'Friday\' = 5, \'Saturday\' = 6)') = 'Friday'

JSONExtractKeysAndValues(json[, indices_or_keys…], value_type)

پارسه جفت کلید ارزش از یک جانسون که ارزش از نوع داده داده خانه رعیتی هستند.

مثال:

SELECT JSONExtractKeysAndValues('{"x": {"a": 5, "b": 7, "c": 11}}', 'x', 'Int8') = [('a',5),('b',7),('c',11)];

JSONExtractRaw(json[, indices_or_keys]…)

بازگرداندن بخشی از جانسون.

اگر بخش وجود ندارد و یا دارای یک نوع اشتباه, یک رشته خالی بازگردانده خواهد شد.

مثال:

SELECT JSONExtractRaw('{"a": "hello", "b": [-100, 200.0, 300]}', 'b') = '[-100, 200.0, 300]'

JSONExtractArrayRaw(json[, indices_or_keys]…)

بازگرداندن مجموعه ای با عناصر از مجموعه جانسون,هر یک به عنوان رشته نامحدود نشان.

اگر بخش وجود ندارد و یا مجموعه ای نیست, مجموعه ای خالی بازگردانده خواهد شد.

مثال:

SELECT JSONExtractArrayRaw('{"a": "hello", "b": [-100, 200.0, "hello"]}', 'b') = ['-100', '200.0', '"hello"']'

مقاله اصلی