الانتقال إلى المحتوى الرئيسي
يتم إنشاء توثيق الدوال أدناه بالاعتماد على جدول النظام system.functions.

​
FQDN

قُدِّم في: v20.1.0 تعيد اسم النطاق المؤهل بالكامل لخادم ClickHouse. الصيغة 
FQDN()
الأسماء المستعارة: fullHostName الوسائط
  • لا شيء.
القيمة المعادة تعيد اسم النطاق المؤهل بالكامل لخادم ClickHouse. String أمثلة مثال على الاستخدام
Query
SELECT fqdn()
Response
┌─FQDN()──────────────────────────┐
│ clickhouse.us-east-2.internal │
└─────────────────────────────────┘

​
MACNumToString

استُحدث في: v1.1.0 يفسّر العدد UInt64 على أنه عنوان MAC بتنسيق big-endian. ويُرجع عنوان MAC المقابل بالتنسيق AA:BB:CC:DD:EE:FF (قيم مفصولة بنقطتين بالصيغة الست عشرية) كسلسلة نصية. الصياغة 
MACNumToString(num)
المعاملات
  • num — عدد من نوع UInt64. UInt64
القيمة المُعادة يُرجع عنوان MAC بالتنسيق AA:BB:CC:DD:EE:FF. String أمثلة مثال على الاستخدام
Query
SELECT MACNumToString(149809441867716) AS mac_address;
Response
┌─mac_address───────┐
│ 88:00:11:22:33:44 │
└───────────────────┘

​
MACStringToNum

أُضيفت في: v1.1.0 الدالة العكسية لـ MACNumToString. إذا كان عنوان MAC بتنسيق غير صالح، فستُرجع 0. الصياغة 
MACStringToNum(s)
الوسائط
  • s — سلسلة نصية لعنوان MAC. String
القيمة المعادة يعيد عددًا من النوع UInt64. UInt64 أمثلة مثال على الاستخدام
Query
SELECT MACStringToNum('01:02:03:04:05:06') AS mac_numeric;
Response
1108152157446

​
MACStringToOUI

أُضيف في: v1.1.0 إذا أُعطي عنوان MAC بالتنسيق AA:BB:CC:DD:EE:FF (أرقام مفصولة بنقطتين بالصيغة السداسية العشرية)، فإنه يعيد أول ثلاثة أوكتيتات على هيئة رقم UInt64. وإذا كان عنوان MAC بتنسيق غير صالح، فإنه يعيد 0. بنية الجملة 
MACStringToOUI(s)
الوسائط
  • s — عنوان MAC كسلسلة نصية. String
القيمة المُعادة أول ثلاث ثمانيات على هيئة عدد من نوع UInt64. UInt64 أمثلة مثال على الاستخدام
Query
SELECT MACStringToOUI('00:50:56:12:34:56') AS oui;
Response
20566

​
authenticatedUser

أُضيفت في: v25.11.0 إذا جرى تبديل مستخدم الجلسة باستخدام الأمر EXECUTE AS، فستُرجع هذه الدالة اسم المستخدم الأصلي الذي استُخدم للمصادقة وإنشاء الجلسة. الاسم البديل: authUser() البنية 
authenticatedUser()
الأسماء البديلة: authUser الوسائط
  • لا يوجد.
القيمة المعادة اسم المستخدم الذي تمت المصادقة عليه. String أمثلة مثال على الاستخدام
Query
EXECUTE as u1;
            SELECT currentUser(), authenticatedUser();
Response
┌─currentUser()─┬─authenticatedUser()─┐
│ u1            │ default             │
└───────────────┴─────────────────────┘

​
bar

استُحدث في: v1.1.0 ينشئ مخططًا شريطيًا. يرسم شريطًا بعرض يتناسب مع (x - min)، ويكون مساويًا لعدد المحارف في width عندما تكون x = max. يُرسَم الشريط بدقة تصل إلى ثُمن المحرف. البنية 
bar(x, min, max[, width])
الوسيطات القيمة المُعادة تُرجع سلسلة تمثل شريطًا مرسومًا بأحرف Unicode. String أمثلة مثال على الاستخدام
Query
SELECT
toHour(EventTime) AS h,
count() AS c,
bar(c, 0, 600000, 20) AS bar
FROM test.hits
GROUP BY h
ORDER BY h ASC
Response
┌──h─┬──────c─┬─bar────────────────┐
│  0 │ 292907 │ █████████▋         │
│  1 │ 180563 │ ██████             │
│  2 │ 114861 │ ███▋               │
│  3 │  85069 │ ██▋                │
│  4 │  68543 │ ██▎                │
│  5 │  78116 │ ██▌                │
│  6 │ 113474 │ ███▋               │
│  7 │ 170678 │ █████▋             │
│  8 │ 278380 │ █████████▎         │
│  9 │ 391053 │ █████████████      │
│ 10 │ 457681 │ ███████████████▎   │
│ 11 │ 493667 │ ████████████████▍  │
│ 12 │ 509641 │ ████████████████▊  │
│ 13 │ 522947 │ █████████████████▍ │
│ 14 │ 539954 │ █████████████████▊ │
│ 15 │ 528460 │ █████████████████▌ │
│ 16 │ 539201 │ █████████████████▊ │
│ 17 │ 523539 │ █████████████████▍ │
│ 18 │ 506467 │ ████████████████▊  │
│ 19 │ 520915 │ █████████████████▎ │
│ 20 │ 521665 │ █████████████████▍ │
│ 21 │ 542078 │ ██████████████████ │
│ 22 │ 493642 │ ████████████████▍  │
│ 23 │ 400397 │ █████████████▎     │
└────┴────────┴────────────────────┘

​
blockNumber

أُضيف في: v1.1.0 يعيد رقمًا تسلسليًا يزداد باطراد لـالكتلة التي تحتوي على الصف. ويُحدَّث رقم الكتلة المُعاد قدر الإمكان، أي قد لا يكون دقيقًا تمامًا. الصيغة 
blockNumber()
الوسائط
  • لا شيء.
القيمة المعادة الرقم التسلسلي لكتلة البيانات التي يقع فيها الصف. UInt64 أمثلة الاستخدام الأساسي
Query
SELECT blockNumber()
FROM
(
    SELECT *
    FROM system.numbers
    LIMIT 10
) SETTINGS max_block_size = 2
Response
┌─blockNumber()─┐
│             7 │
│             7 │
└───────────────┘
┌─blockNumber()─┐
│             8 │
│             8 │
└───────────────┘
┌─blockNumber()─┐
│             9 │
│             9 │
└───────────────┘
┌─blockNumber()─┐
│            10 │
│            10 │
└───────────────┘
┌─blockNumber()─┐
│            11 │
│            11 │
└───────────────┘

​
blockSerializedSize

أُضيف في: v20.3.0 يعيد الحجم غير المضغوط، بالبايت، لكتلة من القيم على القرص. الصياغة 
blockSerializedSize(x1[, x2[, ...]])
الوسائط
  • x1[, x2, ...] — أي عدد من القيم المطلوب الحصول على الحجم غير المضغوط للكتلة الخاصة بها. Any
القيمة المُعادة يعيد عدد البايتات التي ستُكتب إلى القرص لكتلة من القيم من دون ضغط. UInt64 أمثلة مثال على الاستخدام
Query
SELECT blockSerializedSize(maxState(1)) AS x;
Response
┌─x─┐
│ 2 │
└───┘

​
blockSize

أُضيفت في: v1.1.0 في ClickHouse، تُعالَج الاستعلامات على شكل كتل (chunks). تُرجِع هذه الدالة حجم الكتلة (عدد الصفوف) التي استُدعيت عليها. الصيغة 
blockSize()
المعاملات
  • لا يوجد.
القيمة المعادة يعيد عدد الصفوف في الكتلة الحالية. UInt64 أمثلة مثال على الاستخدام
Query
SELECT blockSize()
FROM system.numbers LIMIT 5
Response
┌─blockSize()─┐
│           5 │
│           5 │
│           5 │
│           5 │
│           5 │
└─────────────┘

​
buildId

قُدِّمت في: v20.5.0 تُرجِع معرّف البناء الذي يُنشئه مصرّف للملف التنفيذي لخادم ClickHouse قيد التشغيل. إذا نُفِّذت في سياق جدول موزّع، فستُنشئ هذه الدالة عمودًا عاديًا بقيم مرتبطة بكل shard. وإلا فإنها تُنتج قيمة ثابتة. الصيغة 
buildId()
المعاملات
  • لا توجد.
القيمة المُعادة يُرجع معرّف البناء. String أمثلة مثال على الاستخدام
Query
SELECT buildId()
Response
┌─buildId()────────────────────────────────┐
│ AB668BEF095FAA6BD26537F197AC2AF48A927FB4 │
└──────────────────────────────────────────┘

​
byteSize

أُضيفت في: v21.1.0 تعيد تقديرًا لحجم البايت غير المضغوط لوسيطاتها في الذاكرة. بالنسبة إلى الوسيطات من النوع String، تعيد الدالة طول السلسلة + 8 (الطول). إذا كانت للدالة عدة وسيطات، فإنها تحسب مجموع أحجام البايت الخاصة بها. البنية 
byteSize(arg1[, arg2, ...])
الوسائط
  • arg1[, arg2, ...] — قيم من أي نوع بيانات يُراد تقدير حجمها بالبايت في صورتها غير المضغوطة. Any
القيمة المُعادة تعيد تقديرًا لحجم الوسائط بالبايت في الذاكرة. UInt64 أمثلة مثال على الاستخدام
Query
SELECT byteSize('string')
Response
┌─byteSize('string')─┐
│                 15 │
└────────────────────┘
وسائط متعددة
Query
SELECT byteSize(NULL, 1, 0.3, '')
Response
┌─byteSize(NULL, 1, 0.3, '')─┐
│                         19 │
└────────────────────────────┘

​
catboostEvaluate

أُضيف في: v22.9.0 قيِّم نموذج CatBoost خارجيًا. CatBoost مكتبة تعزيز تدرّجي مفتوحة المصدر طوّرتها Yandex للتعلّم الآلي. تقبل مسارًا إلى نموذج CatBoost ووسيطات النموذج (السمات). المتطلبات المسبقة
  1. ابنِ مكتبة تقييم CatBoost
قبل تقييم نماذج CatBoost، يجب إتاحة المكتبة libcatboostmodel.<so|dylib>. راجع توثيق CatBoost لمعرفة كيفية تجميعها. بعد ذلك، حدِّد المسار إلى libcatboostmodel.<so|dylib> في تهيئة ClickHouse: 
<clickhouse>
...
    <catboost_lib_path>/path/to/libcatboostmodel.so</catboost_lib_path>
...
</clickhouse>
لأسباب تتعلق بالأمان والعزل، لا يُجرى تقييم النموذج داخل عملية الخادم، بل داخل عملية clickhouse-library-bridge. عند أول تنفيذ للدالة catboostEvaluate()، يبدأ الخادم عملية جسر المكتبة إذا لم تكن قيد التشغيل بالفعل. وتتواصل العمليتان باستخدام واجهة HTTP. يُستخدم المنفذ 9012 افتراضيًا. ويمكن تحديد منفذ مختلف كما يلي - ويكون ذلك مفيدًا إذا كان المنفذ 9012 مخصّصًا بالفعل لخدمة مختلفة. 
<library_bridge>
    <port>9019</port>
</library_bridge>
  1. درّب نموذج CatBoost باستخدام libcatboost
راجع تدريب النماذج وتطبيقها لمعرفة كيفية تدريب نماذج CatBoost انطلاقًا من مجموعة بيانات تدريب. الصيغة 
catboostEvaluate(path_to_model, feature_1[, feature_2, ..., feature_n])
الوسائط
  • path_to_model — مسار نموذج catboost. const String
  • feature — سمة واحدة أو أكثر من سمات/وسائط النموذج. Float*
القيمة المعادة يعيد نتيجة تقييم النموذج. Float64 أمثلة catboostEvaluate
Query
SELECT catboostEvaluate('/root/occupy.bin', Temperature, Humidity, Light, CO2, HumidityRatio) AS prediction FROM occupancy LIMIT 1
Response
4.695691092573497

​
colorOKLABToSRGB

أُضيفت في: v26.2.0 تحوّل لونًا من فضاء الألوان الإدراكي OKLab إلى فضاء الألوان sRGB. يُحدَّد لون الإدخال في فضاء الألوان OKLab. إذا كانت قيم الإدخال خارج نطاقات OKLab المعتادة، فتُحدَّد النتيجة وفقًا للتنفيذ. يستخدم OKLab ثلاثة مكوّنات:
  • L: الإضاءة الإدراكية (عادةً في النطاق [0..1])
    • a: المحور التقابلي الأخضر-الأحمر
    • b: المحور التقابلي الأزرق-الأصفر
مكوّنا a و b غير محدودين نظريًا، لكنهما عمليًا يقعان بين -0.4 و 0.4. صُمّم OKLab ليكون موحّدًا إدراكيًا مع بقائه قليل الكلفة حسابيًا. يُفترض أن يكون هذا التحويل معكوسًا لـ colorSRGBToOKLAB، ويتكوّن من المراحل التالية:
  1. التحويل من OKLab إلى Linear sRGB. 2) التحويل من Linear sRGB إلى sRGB مُرمَّز بالغاما.
تحدّد وسيطة gamma الاختيارية الأس المستخدم عند التحويل من Linear sRGB إلى قيم RGB مُرمَّزة بالغاما. وإذا لم تُحدَّد، فتُستخدم قيمة gamma افتراضية لضمان الاتساق مع colorSRGBToOKLAB. لمزيد من المعلومات حول فضاء الألوان OKLab وعلاقته بـ sRGB، راجع https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/color&#95;value/oklab . الصياغة 
colorOKLABToSRGB(tuple [, gamma])
الوسائط
  • tuple — قيمة Tuple تتألف من ثلاث قيم رقمية هي L وa وb، حيث تقع L ضمن النطاق [0...1]. Tuple(Float64, Float64, Float64)
  • gamma — اختياري. الأسّ المستخدم لتحويل Linear sRGB مرة أخرى إلى sRGB عبر تطبيق (x ^ (1 / gamma)) * 255 على كل قناة x. القيمة الافتراضية هي 2.2. Float64
القيمة المعادة تعيد قيمة Tuple بالشكل (R, G, B) تمثل قيم ألوان sRGB. Tuple(Float64, Float64, Float64) أمثلة تحويل OKLAB إلى sRGB (Float)
Query
SELECT colorOKLABToSRGB((0.4466, 0.0991, 0.44)) AS rgb;
Response
┌─rgb──────────────────────┐
│ (198.07056923258935,0,0) │
└──────────────────────────┘
تحويل OKLAB إلى sRGB ‏(UInt8)
Query
WITH colorOKLABToSRGB((0.7, 0.1, 0.54)) AS t
SELECT tuple(toUInt8(t.1), toUInt8(t.2), toUInt8(t.3)) AS RGB;
Response
┌─RGB──────────┐
│ (255,0,0)    │
└──────────────┘

​
colorOKLCHToSRGB

أُضيف في: v25.7.0 يحوّل لونًا من فضاء الألوان الإدراكي OKLCH إلى فضاء الألوان sRGB المألوف. إذا كانت L خارج النطاق [0...1]، أو كانت C سالبة، أو كانت H خارج النطاق [0...360]، فإن النتيجة تكون مُعرَّفة بحسب التنفيذ.
OKLCH هو نسخة أسطوانية من فضاء الألوان OKLab. إحداثياته الثلاث هي L (السطوع ضمن النطاق [0...1])، وC (التشبّع >= 0)، وH (تدرّج اللون بالدرجات ضمن [0...360]). صُمّم OKLab/OKLCH ليكون متجانسًا إدراكيًا مع بقائه منخفض الكلفة حسابيًا.
التحويل هو معكوس colorSRGBToOKLCH:
  1. من OKLCH إلى OKLab. 2) من OKLab إلى Linear sRGB 3) من Linear sRGB إلى sRGB
تُستخدم الوسيطة الثانية gamma في المرحلة الأخيرة. للاطلاع على أمثلة مرجعية للألوان في فضاء OKLCH، وكيفية توافقها مع ألوان sRGB، يُرجى مراجعة https://oklch.com/. الصياغة 
colorOKLCHToSRGB(tuple [, gamma])
الوسيطات
  • tuple — قيمة من النوع Tuple تتألف من ثلاث قيم رقمية L وC وH، حيث تكون L ضمن النطاق [0...1]، وC >= 0، وH ضمن النطاق [0...360]. Tuple(Float64, Float64, Float64)
  • gamma — اختياري. الأسّ المستخدم لتحويل Linear sRGB إلى sRGB مرة أخرى، وذلك بتطبيق (x ^ (1 / gamma)) * 255 على كل قناة x. القيمة الافتراضية هي 2.2. Float64
القيمة المعادة تعيد قيمة من النوع Tuple ‏(R, G, B) تمثل قيم ألوان sRGB. Tuple(Float64, Float64, Float64) أمثلة تحويل OKLCH إلى sRGB
Query
SELECT colorOKLCHToSRGB((0.6, 0.12, 40)) AS rgb;
Response
┌─rgb───────────────────────────────────────────────────────┐
│ (186.02058688365264,100.68677189684993,71.67819977081575) │
└───────────────────────────────────────────────────────────┘
تحويل OKLCH إلى sRGB (UInt8)
Query
WITH colorOKLCHToSRGB((0.6, 0.12, 40)) AS t
SELECT tuple(toUInt8(t.1), toUInt8(t.2), toUInt8(t.3)) AS RGB;
Response
┌─RGB──────────┐
│ (186,100,71) │
└──────────────┘

​
colorSRGBToOKLAB

أُضيف في: v26.2.0 يحوّل لونًا مُرمَّزًا في فضاء الألوان sRGB إلى فضاء الألوان OKLAB المتجانس إدراكيًا. إذا كانت أي قناة إدخال خارج [0...255] أو كانت قيمة gamma غير موجبة، فإن السلوك يعتمد على التنفيذ.
OKLAB هو فضاء ألوان متجانس إدراكيًا. إحداثياته الثلاث هي L (السطوع ضمن النطاق [0...1]) وa (Green-Red axis) وb (Blue-Yellow axis). صُمّم OKLab ليكون متجانسًا إدراكيًا مع الحفاظ على انخفاض الكلفة الحسابية.
يتكوّن التحويل من مرحلتين:
  1. sRGB إلى Linear sRGB 2) Linear sRGB إلى OKLab
البنية 
colorSRGBToOKLAB(tuple[, gamma])
المعاملات
  • tuple — قيمة Tuple تتكوّن من ثلاث قيم: R وG وB ضمن النطاق [0...255]. Tuple(UInt8, UInt8, UInt8)
  • gamma — اختياري. الأسّ المستخدَم لجعل sRGB خطيًا عبر تطبيق (x / 255)^gamma على كل قناة x. القيمة الافتراضية هي 2.2. Float64
القيمة المُعادة يعيد قيمة tuple ‏(L وa وb) تمثّل قيم فضاء الألوان OKLAB. Tuple(Float64, Float64, Float64) أمثلة تحويل sRGB إلى OKLAB
Query
SELECT colorSRGBToOKLAB((128, 64, 32), 2.2) AS lab;
Response
┌─lab──────────────────────────────────────────────────────────┐
│ (0.4436238384931984,0.07266246769242975,0.07500108778529994) │
└──────────────────────────────────────────────────────────────┘

​
colorSRGBToOKLCH

أُضيف في: v25.7.0 يحوّل لونًا مُرمَّزًا في فضاء الألوان sRGB إلى فضاء الألوان OKLCH المتجانس إدراكيًا. إذا كانت أي قناة إدخال خارج النطاق [0...255] أو كانت قيمة gamma غير موجبة، فإن السلوك يعتمد على التنفيذ.
OKLCH هو نسخة أسطوانية من فضاء الألوان OKLab. إحداثياته الثلاث هي L (السطوع ضمن النطاق [0...1])، وC (الكروما >= 0) وH (تدرّج اللون بالدرجات ضمن [0...360]). صُمِّم OKLab/OKLCH ليكون متجانسًا إدراكيًا مع بقائه منخفض الكلفة حسابيًا.
يتكوّن التحويل من ثلاث مراحل:
  1. من sRGB إلى Linear sRGB 2) من Linear sRGB إلى OKLab 3) من OKLab إلى OKLCH.
للاطلاع على مراجع الألوان في فضاء OKLCH وكيف تقابل ألوانَ sRGB، يُرجى مراجعة https://OKLCH.com/. الصياغة 
colorSRGBToOKLCH(tuple[, gamma])
الوسائط
  • tuple — قيمة من النوع Tuple تتكوّن من ثلاث قيم R وG وB ضمن النطاق [0...255]. Tuple(UInt8, UInt8, UInt8)
  • gamma — اختياري. الأسّ المُستخدم لتحويل sRGB إلى تمثيل خطي عبر تطبيق (x / 255)^gamma على كل قناة x. القيمة الافتراضية هي 2.2. Float64
القيمة المُعادة تعيد قيمة ثلاثية (L, C, H) تمثّل قيم فضاء الألوان OKLCH. Tuple(Float64, Float64, Float64) أمثلة تحويل sRGB إلى OKLCH
Query
SELECT colorSRGBToOKLCH((128, 64, 32), 2.2) AS lch;
Response
┌─lch───────────────────────────────────────────────────────┐
│ (0.4436238384931984,0.1044269954567863,45.90734548193018) │
└───────────────────────────────────────────────────────────┘

​
connectionId

أُضيفت في: v21.3.0 تعيد معرّف الاتصال للعميل الذي أرسل الاستعلام الحالي. تكون هذه الدالة مفيدة بشكل خاص في سيناريوهات تصحيح الأخطاء. أُنشئت للتوافق مع الدالة CONNECTION_ID في MySQL. ولا تُستخدم عادةً في استعلامات الإنتاج. البنية 
connectionId()
المعاملات
  • لا يوجد.
القيمة المعادة يُرجِع معرّف اتصال العميل الحالي. UInt64 أمثلة مثال على الاستخدام
Query
SELECT connectionId();
Response
┌─connectionId()─┐
│              0 │
└────────────────┘

​
countDigits

أُضيفت في: v20.8.0 تعيد عدد الخانات اللازمة لتمثيل قيمة بالصيغة العشرية.
تأخذ هذه الدالة في الحسبان مقياس القيم العشرية، أي إنها تحسب النتيجة استنادًا إلى نوع العدد الصحيح الأساسي، وهو (value * scale).على سبيل المثال:
  • countDigits(42) = 2
  • countDigits(42.000) = 5
  • countDigits(0.04200) = 4
يمكنك التحقق من تجاوز السعة في Decimal64 باستخدام countDigits(x) > 18، مع أن ذلك أبطأ من isDecimalOverflow.
البنية 
countDigits(x)
المعاملات القيمة المُعادة يُرجع عدد الخانات اللازمة لتمثيل x. UInt8 أمثلة مثال للاستخدام
Query
SELECT countDigits(toDecimal32(1, 9)), countDigits(toDecimal32(-1, 9)),
       countDigits(toDecimal64(1, 18)), countDigits(toDecimal64(-1, 18)),
       countDigits(toDecimal128(1, 38)), countDigits(toDecimal128(-1, 38));
Response
┌─countDigits(toDecimal32(1, 9))─┬─countDigits(toDecimal32(-1, 9))─┬─countDigits(toDecimal64(1, 18))─┬─countDigits(toDecimal64(-1, 18))─┬─countDigits(toDecimal128(1, 38))─┬─countDigits(toDecimal128(-1, 38))─┐
│                             10 │                              10 │                              19 │                               19 │                               39 │                                39 │
└────────────────────────────────┴─────────────────────────────────┴─────────────────────────────────┴──────────────────────────────────┴──────────────────────────────────┴───────────────────────────────────┘

​
currentDatabase

أُضيف في: v1.1.0 يُرجع اسم قاعدة البيانات الحالية. ويفيد ذلك في معاملات محرك الجدول ضمن استعلامات CREATE TABLE عندما تحتاج إلى تحديد قاعدة البيانات. راجع أيضًا تعليمة SET. الصياغة 
currentDatabase()
الأسماء البديلة: current_database, SCHEMA, DATABASE المعاملات
  • لا شيء.
القيمة المُعادة يُرجع اسم قاعدة البيانات الحالية. String أمثلة مثال على الاستخدام
Query
SELECT currentDatabase()
Response
┌─currentDatabase()─┐
│ default           │
└───────────────────┘
صياغة SQL القياسية من دون أقواس
Query
SELECT CURRENT_DATABASE
Response
┌─CURRENT_DATABASE─┐
│ default          │
└──────────────────┘

​
currentProfiles

قُدِّم في: v21.9.0 يعيد مصفوفة من ملفات تعريف الإعدادات الخاصة بالمستخدم الحالي. الصياغة 
currentProfiles()
الوسائط
  • لا توجد.
القيمة المعادة يعيد مصفوفة من ملفات تعريف الإعدادات للمستخدم الحالي. Array(String) أمثلة مثال على الاستخدام
Query
SELECT currentProfiles();
Response
┌─currentProfiles()─────────────────────────────┐
│ ['default', 'readonly_user', 'web_analytics'] │
└───────────────────────────────────────────────┘

​
currentQueryID

قُدِّم في: v25.2.0 يعيد معرّف الاستعلام الحالي. البنية 
currentQueryID()
الأسماء المستعارة: current_query_id الوسائط
  • لا يوجد.
القيمة المُعادة أمثلة مثال
Query
SELECT currentQueryID();
Response
┌─currentQueryID()─────────────────────┐
│ 1280d0e8-1a08-4524-be6e-77975bb68e7d │
└──────────────────────────────────────┘

​
currentRoles

أُضيفت في: v21.9.0 تُرجِع مصفوفة بالأدوار المُعيَّنة للمستخدم الحالي. الصياغة 
currentRoles()
المعاملات
  • لا يوجد.
القيمة المُعادة تُرجع مصفوفة بالأدوار المُسندة إلى المستخدم الحالي. Array(String) أمثلة مثال على الاستخدام
Query
SELECT currentRoles();
Response
┌─currentRoles()─────────────────────────────────┐
│ ['sql-console-role:jane.smith@clickhouse.com'] │
└────────────────────────────────────────────────┘

​
currentSchemas

أُضيف في: v23.7.0 مماثلة للدالة currentDatabase، ولكنها
  • تقبل وسيطة من نوع Boolean يتم تجاهلها
  • تُرجع اسم قاعدة البيانات في مصفوفة تحتوي على قيمة واحدة.
الدالة currentSchemas موجودة فقط للتوافق مع PostgreSQL. يُرجى استخدام currentDatabase بدلًا منها. انظر أيضًا إلى عبارة SET. الصياغة 
currentSchemas(bool)
الأسماء المستعارة: current_schemas الوسائط
  • bool — قيمة منطقية يتم تجاهلها. Bool
القيمة المُعادة تُرجِع مصفوفةً ذات عنصر واحد تحتوي على اسم قاعدة البيانات الحالية. Array(String) أمثلة مثال على الاستخدام
Query
SELECT currentSchemas(true)
Response
┌─currentSchemas(true)─┐
│ ['default']          │
└──────────────────────┘

​
currentUser

أُضيف في: v20.1.0 يعيد اسم المستخدم الحالي. في حال كان الاستعلام موزعًا، يُعاد اسم المستخدم الذي بدأ الاستعلام. البنية 
currentUser()
الأسماء البديلة: session_user, user, current_user الوسائط
  • لا شيء.
القيمة المعادة يعيد اسم المستخدم الحالي، أو اسم تسجيل الدخول للمستخدم الذي بدأ الاستعلام. String أمثلة مثال على الاستخدام
Query
SELECT currentUser()
Response
┌─currentUser()─┐
│ default       │
└───────────────┘
صيغة SQL القياسية من دون أقواس
Query
SELECT CURRENT_USER
Response
┌─CURRENT_USER─┐
│ default      │
└──────────────┘

​
defaultProfiles

أُضيف في: v21.9.0 يُرجع مصفوفة بأسماء ملفات تعريف الإعدادات الافتراضية للمستخدم الحالي. الصياغة 
defaultProfiles()
الوسيطات
  • لا شيء.
القيمة المعادة يعيد مصفوفة من أسماء ملفات تعريف الإعدادات الافتراضية للمستخدم الحالي. Array(String) أمثلة مثال على الاستخدام
Query
SELECT defaultProfiles();
Response
┌─defaultProfiles()─┐
│ ['default']       │
└───────────────────┘

​
defaultRoles

أُضيف في: v21.9.0 يُرجع مصفوفة من الأدوار الافتراضية للمستخدم الحالي. الصياغة 
defaultRoles()
الوسيطات
  • لا توجد.
القيمة المُعادة تعيد مصفوفة من الأدوار الافتراضية للمستخدم الحالي. Array(String) أمثلة مثال للاستخدام
Query
SELECT defaultRoles();
Response
┌─defaultRoles()─────────────────────────────────┐
│ ['sql-console-role:jane.smith@clickhouse.com'] │
└────────────────────────────────────────────────┘

​
defaultValueOfArgumentType

تم تقديمه في: v1.1.0 يعيد القيمة الافتراضية لنوع بيانات معيّن. ولا يشمل القيم الافتراضية للأعمدة المخصّصة التي يعيّنها المستخدم. الصيغة 
defaultValueOfArgumentType(expression)
المعاملات
  • expression — قيمة من أي نوع، أو تعبير يُنتج قيمة من أي نوع. Any
القيمة المُعادة تعيد 0 للأرقام، أو سلسلة نصية فارغة للسلاسل النصية، أو NULL للأنواع Nullable. UInt8 أو String أو NULL أمثلة مثال على الاستخدام
Query
SELECT defaultValueOfArgumentType(CAST(1 AS Int8));
Response
┌─defaultValueOfArgumentType(CAST(1, 'Int8'))─┐
│                                           0 │
└─────────────────────────────────────────────┘
مثال على Nullable
Query
SELECT defaultValueOfArgumentType(CAST(1 AS Nullable(Int8)));
Response
┌─defaultValueOfArgumentType(CAST(1, 'Nullable(Int8)'))─┐
│                                                  ᴺᵁᴸᴸ │
└───────────────────────────────────────────────────────┘

​
defaultValueOfTypeName

تم تقديمه في: v1.1.0 تعيد القيمة الافتراضية للنوع ذي الاسم المحدد. البنية 
defaultValueOfTypeName(type)
الوسيطات
  • type — سلسلة نصية تمثل اسم نوع. String
القيمة المُعادة تُرجع القيمة الافتراضية لاسم النوع المحدد: 0 للأرقام، وسلسلة فارغة للسلاسل النصية، أو NULL في حالة Nullable UInt8 أو String أو NULL أمثلة مثال على الاستخدام
Query
SELECT defaultValueOfTypeName('Int8');
Response
┌─defaultValueOfTypeName('Int8')─┐
│                              0 │
└────────────────────────────────┘
مثال على Nullable
Query
SELECT defaultValueOfTypeName('Nullable(Int8)');
Response
┌─defaultValueOfTypeName('Nullable(Int8)')─┐
│                                     ᴺᵁᴸᴸ │
└──────────────────────────────────────────┘

​
displayName

أُضيف في: v22.11.0 يعيد قيمة display_name من config، أو الاسم المؤهل بالكامل للنطاق (FQDN) الخاص بالخادم إذا لم يتم تعيينه. البنية 
displayName()
الوسيطات
  • لا شيء.
القيمة المُعادة تُعيد قيمة display_name من config، أو FQDN الخاص بالخادم إذا لم تكن مُعيّنة. String أمثلة مثال استخدام
Query
SELECT displayName();
Response
┌─displayName()─┐
│ production    │
└───────────────┘

​
dumpColumnStructure

أُضيف في: v1.1.0 يعرض وصفًا تفصيليًا للبنية الداخلية لعمود ونوع بياناته. الصياغة 
dumpColumnStructure(x)
المعاملات
  • x — القيمة المطلوب الحصول على وصف لها. Any
القيمة المُعادة يعيد وصفًا لبنية العمود المستخدمة لتمثيل هذه القيمة. String أمثلة مثال على الاستخدام
Query
SELECT dumpColumnStructure(CAST('2018-01-01 01:02:03', 'DateTime'));
Response
┌─dumpColumnStructure(CAST('2018-01-01 01:02:03', 'DateTime'))─┐
│ DateTime, Const(size = 1, UInt32(size = 1))                  │
└──────────────────────────────────────────────────────────────┘

​
enabledProfiles

أُضيف في: v21.9.0 يعيد مصفوفة من أسماء ملفات تعريف الإعدادات المُمكّنة للمستخدم الحالي. البنية 
enabledProfiles()
الوسائط
  • لا يوجد.
القيمة المُعادة تُرجع مصفوفة بأسماء ملفات تعريف الإعدادات المُمكَّنة للمستخدم الحالي. Array(String) أمثلة مثال على الاستخدام
Query
SELECT enabledProfiles();
Response
┌─enabledProfiles()─────────────────────────────────────────────────┐
│ ['default', 'readonly_user', 'web_analytics', 'batch_processing'] │
└───────────────────────────────────────────────────────────────────┘

​
enabledRoles

أُضيفت في: v21.9.0 تعيد Array من الأدوار المُمكَّنة للمستخدم الحالي. الصياغة 
enabledRoles()
الوسيطات
  • لا شيء.
القيمة المعادة تُرجع مصفوفة بأسماء الأدوار المفعّلة للمستخدم الحالي. Array(String) أمثلة مثال على الاستخدام
Query
SELECT enabledRoles();
Response
┌─enabledRoles()─────────────────────────────────────────────────┐
│ ['general_data', 'sql-console-role:jane.smith@clickhouse.com'] │
└────────────────────────────────────────────────────────────────┘

​
errorCodeToName

أُضيف في: v20.12.0 يُرجع الاسم النصي لرمز خطأ رقمي في ClickHouse. يتوفر الربط بين رموز الخطأ الرقمية وأسماء الأخطاء هنا. البنية 
errorCodeToName(error_code)
الوسائط القيمة المعادة يعيد الاسم النصي للرمز error_code. String أمثلة مثال على الاستخدام
Query
SELECT errorCodeToName(252);
Response
┌─errorCodeToName(252)─┐
│ TOO_MANY_PARTS       │
└──────────────────────┘

​
file

قُدِّم في: v21.3.0 يقرأ ملفًا على هيئة سلسلة نصية ويحمّل البيانات إلى العمود المحدد. لا يُفسَّر محتوى الملف. راجع أيضًا دالة الجدول file. البنية 
file(path[, default])
الوسائط
  • path — مسار الملف بالنسبة إلى user_files_path. يدعم أحرف البدل *, **, ?, {abc,def} و {N..M}، حيث إن N وM عددان، و'abc' و'def' سلسلتان نصيتان. String
  • default — القيمة المُعادة إذا لم يكن الملف موجودًا أو تعذّر الوصول إليه. String أو NULL
القيمة المُعادة يُرجع محتوى الملف على هيئة سلسلة نصية. String أمثلة إدراج ملفات في جدول
Query
INSERT INTO table SELECT file('a.txt'), file('b.txt');
Response

​
filesystemAvailable

أُضيف في: v20.1.0 يعيد مقدار المساحة الحرة في نظام الملفات الذي يستضيف التخزين الدائم لقاعدة البيانات. تكون القيمة المعادة دائمًا أقل من إجمالي المساحة الحرة (filesystemUnreserved) لأن بعض المساحة تكون محجوزة لنظام التشغيل. الصياغة 
filesystemAvailable([disk_name])
الوسائط
  • disk_name — اختياري. اسم القرص المراد معرفة مقدار المساحة الحرة فيه. إذا لم يُحدَّد، فسيُستخدم القرص default. String أو FixedString
القيمة المعادة تعيد مقدار المساحة المتبقية المتاحة بالبايت. UInt64 أمثلة مثال على الاستخدام
Query
SELECT formatReadableSize(filesystemAvailable()) AS "Available space";
Response
┌─Available space─┐
│ 30.75 GiB       │
└─────────────────┘

​
filesystemCapacity

أُضيفت في: v20.1.0 تعيد سعة نظام الملفات بالبايت. يتطلب ذلك تهيئة المسار الخاص بدليل البيانات. الصياغة 
filesystemCapacity([disk_name])
الوسائط
  • disk_name — اختياري. اسم القرص المطلوب الحصول على سعته. إذا لم يتم تحديده، فسيُستخدم القرص default. String أو FixedString
القيمة المُعادة تعيد سعة نظام الملفات بالبايت. UInt64 أمثلة مثال على الاستخدام
Query
SELECT formatReadableSize(filesystemCapacity()) AS "Capacity";
Response
┌─Capacity──┐
│ 39.32 GiB │
└───────────┘

​
filesystemUnreserved

قُدِّمت في: v22.12.0 تعيد إجمالي المساحة الحرة على نظام الملفات الذي يستضيف التخزين الدائم لقاعدة البيانات (وكان يُسمى سابقًا filesystemFree). انظر أيضًا filesystemAvailable. الصياغة 
filesystemUnreserved([disk_name])
الوسيطات
  • disk_name — اختياري. اسم القرص المطلوب معرفة إجمالي المساحة الحرة فيه. إذا لم يتم تحديده، فسيُستخدم القرص الافتراضي. String أو FixedString
القيمة المعادة يعيد مقدار المساحة الحرة بالبايت. UInt64 أمثلة مثال على الاستخدام
Query
SELECT formatReadableSize(filesystemUnreserved()) AS "Free space";
Response
┌─Free space─┐
│ 32.39 GiB  │
└────────────┘

​
finalizeAggregation

قُدِّمت في: v1.1.0 عند تمرير حالة تجميع، تُرجِع هذه الدالة نتيجة التجميع (أو الحالة المُنهية عند استخدام المُركِّب -State). الصياغة 
finalizeAggregation(state)
الوسائط القيمة المُعادة يعيد النتيجة النهائية للتجميع. Any أمثلة مثال على الاستخدام
Query
SELECT finalizeAggregation(arrayReduce('maxState', [1, 2, 3]));
Response
┌─finalizeAggregation(arrayReduce('maxState', [1, 2, 3]))─┐
│                                                       3 │
└─────────────────────────────────────────────────────────┘
بالاقتران مع initializeAggregation
Query
WITH initializeAggregation('sumState', number) AS one_row_sum_state
SELECT
    number,
    finalizeAggregation(one_row_sum_state) AS one_row_sum,
    runningAccumulate(one_row_sum_state) AS cumulative_sum
FROM numbers(5);
Response
┌─number─┬─one_row_sum─┬─cumulative_sum─┐
│      0 │           0 │              0 │
│      1 │           1 │              1 │
│      2 │           2 │              3 │
│      3 │           3 │              6 │
│      4 │           4 │             10 │
└────────┴─────────────┴────────────────┘

​
flipCoordinates

أُضيفت في: v25.11.0 تبدّل هذه الدالة الإحداثيين x وy في الكائنات الهندسية. تؤدي هذه العملية إلى تبديل خط العرض وخط الطول، وهو ما يفيد عند التحويل بين أنظمة إحداثيات مختلفة أو تصحيح ترتيب الإحداثيات. بالنسبة إلى Point، فهي تبدّل الإحداثيين x وy. وبالنسبة إلى الأشكال الهندسية الأكثر تعقيدًا (LineString وPolygon وMultiPolygon وRing وMultiLineString)، فإنها تطبّق هذا التحويل تكراريًا على كل زوج من الإحداثيات. تدعم الدالة كلاً من الأنواع الهندسية الفردية (Point وRing وPolygon وMultiPolygon وLineString وMultiLineString) ونوع Geometry المتغاير. الصياغة 
flipCoordinates(geometry)
الوسائط
  • geometry — العنصر الهندسي المراد تحويله. الأنواع المدعومة: Point (Tuple(Float64, Float64))، وRing (Array(Point))، وPolygon (Array(Ring))، وMultiPolygon (Array(Polygon))، وLineString (Array(Point))، وMultiLineString (Array(LineString))، أو Geometry (نوع Variant يحتوي على أي من هذه الأنواع).
القيمة المُعادة العنصر الهندسي بإحداثيات معكوسة. نوع الإرجاع يطابق نوع الإدخال. Point أو Ring أو Polygon أو MultiPolygon أو LineString أو MultiLineString أو Geometry أمثلة basic_point
Query
SELECT flipCoordinates((1.0, 2.0));
Response
(2.0, 1.0)
حلقة
Query
SELECT flipCoordinates([(1.0, 2.0), (3.0, 4.0)]);
Response
[(2.0, 1.0), (4.0, 3.0)]
polygon
Query
SELECT flipCoordinates([[(1.0, 2.0), (3.0, 4.0)], [(5.0, 6.0), (7.0, 8.0)]]);
Response
[[(2.0, 1.0), (4.0, 3.0)], [(6.0, 5.0), (8.0, 7.0)]]
geometry_wkt
Query
SELECT flipCoordinates(readWkt('POINT(10 20)'));
Response
(20, 10)
geometry_polygon_wkt
Query
SELECT flipCoordinates(readWkt('POLYGON((0 0, 5 0, 5 5, 0 5, 0 0))'));
Response
[[(0, 0), (0, 5), (5, 5), (5, 0), (0, 0)]]

​
formatQuery

استُحدثت في: v23.10.0 تعيد نسخة منسّقة من استعلام SQL المُعطى، وقد تكون متعددة الأسطر. وتُطلق استثناءً عند حدوث خطأ في التحليل. [example:multiline] الصيغة 
formatQuery(query)
الوسائط
  • query — استعلام SQL المراد تنسيقه. String
القيمة المعادة الاستعلام المنسّق String أمثلة متعدد الأسطر
Query
SELECT formatQuery('select a,    b FRom tab WHERE a > 3 and  b < 3');
Response
SELECT
    a,
    b
FROM tab
WHERE (a > 3) AND (b < 3)

​
formatQueryOrNull

أُضيفت في: v23.11.0 تعيد إصدارًا منسقًا، وقد يمتد على عدة أسطر، من استعلام SQL المحدد. وتعيد NULL عند حدوث خطأ في التحليل. [example:multiline] البنية 
formatQueryOrNull(query)
الوسائط
  • query — استعلام SQL المراد تنسيقه. String
القيمة المُعادة الاستعلام المنسَّق من النوع String أمثلة متعدد الأسطر
Query
SELECT formatQuery('select a,    b FRom tab WHERE a > 3 and  b < 3');
Response
SELECT
    a,
    b
FROM tab
WHERE (a > 3) AND (b < 3)

​
formatQuerySingleLine

أُضيف في: v23.10.0 مشابه لـ formatQuery()، لكن السلسلة المنسّقة المُعادة لا تحتوي على فواصل أسطر. ويُظهر خطأً عند حدوث خطأ في التحليل. [example:multiline] الصياغة 
formatQuerySingleLine(query)
الوسائط
  • query — استعلام SQL المطلوب تنسيقه. String
القيمة المُعادة الاستعلام المنسّق String أمثلة متعدد الأسطر
Query
SELECT formatQuerySingleLine('select a,    b FRom tab WHERE a > 3 and  b < 3');
Response
SELECT a, b FROM tab WHERE (a > 3) AND (b < 3)

​
formatQuerySingleLineOrNull

أُضيف في: v23.11.0 مثل formatQuery()، ولكن السلسلة المنسّقة المُعادة لا تحتوي على فواصل أسطر. ويُرجع NULL في حالة حدوث خطأ في التحليل. [example:multiline] الصيغة 
formatQuerySingleLineOrNull(query)
الوسائط
  • query — استعلام SQL المطلوب تنسيقه. String
القيمة المعادة الاستعلام المنسَّق String أمثلة متعدد الأسطر
Query
SELECT formatQuerySingleLine('select a,    b FRom tab WHERE a > 3 and  b < 3');
Response
SELECT a, b FROM tab WHERE (a > 3) AND (b < 3)

​
formatReadableDecimalSize

أُضيفت في: v22.11.0 عند إعطائها حجمًا معيّنًا (عددًا من البايتات)، تُرجِع هذه الدالة حجمًا مقروءًا ومقرّبًا مع لاحقة (KB وMB وما إلى ذلك) على هيئة سلسلة نصية. العمليات العكسية لهذه الدالة هي parseReadableSize. الصياغة 
formatReadableDecimalSize(value[, precision])
المعاملات القيمة المُعادة تعيد حجمًا مقروءًا ومقربًا مع لاحقة، كسلسلة نصية. String أمثلة تنسيق أحجام الملفات
Query
SELECT
    arrayJoin([1, 1024, 1024*1024, 192851925]) AS filesize_bytes,
    formatReadableDecimalSize(filesize_bytes) AS filesize
Response
┌─filesize_bytes─┬─filesize───┐
│              1 │ 1.00 B     │
│           1024 │ 1.02 KB    │
│        1048576 │ 1.05 MB    │
│      192851925 │ 192.85 MB  │
└────────────────┴────────────┘
مع تحديد الدقة بشكل صريح
Query
SELECT
    formatReadableDecimalSize(192851925, 0) AS no_decimals,
    formatReadableDecimalSize(192851925, 4) AS four_decimals
Response
┌─no_decimals─┬─four_decimals─┐
│ 193 MB      │ 192.8519 MB   │
└─────────────┴───────────────┘

​
formatReadableQuantity

أُضيفت في: v20.10.0 عند إعطائها رقمًا، تُرجِع هذه الدالة رقمًا مُقرَّبًا مع لاحقة (ألف، مليون، مليار، إلخ) في صورة سلسلة نصية. تقبل هذه الدالة أي نوع رقمي كمدخل، لكنها تحوّله داخليًا إلى Float64. قد لا تكون النتائج مثالية مع القيم الكبيرة. البنية 
formatReadableQuantity(value[, precision])
الوسيطات القيمة المُعادة تُرجع رقمًا مُقرَّبًا مع لاحقة، على هيئة سلسلة نصية. String أمثلة تنسيق الأرقام باستخدام لواحق
Query
SELECT
    arrayJoin([1024, 1234 * 1000, (4567 * 1000) * 1000, 98765432101234]) AS number,
    formatReadableQuantity(number) AS number_for_humans
Response
┌─────────number─┬─number_for_humans─┐
│           1024 │ 1.02 thousand     │
│        1234000 │ 1.23 million      │
│     4567000000 │ 4.57 billion      │
│ 98765432101234 │ 98.77 trillion    │
└────────────────┴───────────────────┘
مع دقة محددة بوضوح
Query
SELECT
    formatReadableQuantity(98765432101234, 0) AS no_decimals,
    formatReadableQuantity(98765432101234, 4) AS four_decimals
Response
┌─no_decimals──┬─four_decimals─────┐
│ 99 trillion  │ 98.7654 trillion  │
└──────────────┴───────────────────┘

​
formatReadableSize

أُضيفت في: v1.1.0 عند إعطائها حجمًا (عددًا من البايتات)، تُرجع هذه الدالة حجمًا مقروءًا ومقربًا مع لاحقة (KiB، MiB، إلخ) على هيئة سلسلة نصية. العمليات العكسية لهذه الدالة هي parseReadableSize، وparseReadableSizeOrZero، وparseReadableSizeOrNull. تقبل هذه الدالة أي نوع رقمي كمدخل، لكنها تحوّله داخليًا إلى Float64. قد لا تكون النتائج مثالية مع القيم الكبيرة. الصيغة 
formatReadableSize(value[, precision])
الأسماء البديلة: FORMAT_BYTES الوسيطات القيمة المُعادة يعيد حجمًا مقروءًا ومقرّبًا مع لاحقة، على هيئة سلسلة نصية. String أمثلة تنسيق أحجام الملفات
Query
SELECT
    arrayJoin([1, 1024, 1024*1024, 192851925]) AS filesize_bytes,
    formatReadableSize(filesize_bytes) AS filesize
Response
┌─filesize_bytes─┬─filesize───┐
│              1 │ 1.00 B     │
│           1024 │ 1.00 KiB   │
│        1048576 │ 1.00 MiB   │
│      192851925 │ 183.92 MiB │
└────────────────┴────────────┘
مع تحديد الدقة صراحةً
Query
SELECT
    formatReadableSize(192851925, 0) AS no_decimals,
    formatReadableSize(192851925, 4) AS four_decimals
Response
┌─no_decimals─┬─four_decimals──┐
│ 184 MiB     │ 183.9179 MiB   │
└─────────────┴────────────────┘

​
formatReadableTimeDelta

أُضيفت في: v20.12.0 إذا أُعطيت هذه الدالة فترةً زمنية (delta) بالثواني أو تعبيرًا من نوع INTERVAL، فإنها تُرجع فرقًا زمنيًا كسلسلة نصية بصيغة year/month/day/hour/minute/second/millisecond/microsecond/nanosecond. تقبل هذه الدالة أي نوع رقمي كمدخل، لكنها تحوّله داخليًا إلى Float64. وقد لا تكون النتائج مثالية مع القيم الكبيرة. عند تمرير تعبير من نوع INTERVAL، تُحوَّل قيمته إلى ثوانٍ. ولا تكون وحدات interval من MONTH فما فوق (MONTH, QUARTER, YEAR) مدعومة، لأنها لا تمثل فترةً ثابتة المقدار بالثواني. الصياغة 
formatReadableTimeDelta(column[, maximum_unit, minimum_unit])
الوسيطات
  • column — عمود يحتوي على فرق زمني رقمي، أو تعبير INTERVAL. وحدات INTERVAL من MONTH فما فوق غير مدعومة. Float64 أو Interval
  • maximum_unit — اختياري. أكبر وحدة تُعرض. القيم المقبولة: nanoseconds، microseconds، milliseconds، seconds، minutes، hours، days، months، years. القيمة الافتراضية: years. const String
  • minimum_unit — اختياري. أصغر وحدة تُعرض. تُحذف جميع الوحدات الأصغر. القيم المقبولة: nanoseconds، microseconds، milliseconds، seconds، minutes، hours، days، months، years. إذا كانت القيمة المحددة صراحةً أكبر من maximum_unit، فسيُطلق استثناء. القيمة الافتراضية: seconds إذا كان maximum_unit يساوي seconds أو أكبر، وإلا nanoseconds. const String
القيمة المعادة تعيد فرقًا زمنيًا على هيئة سلسلة نصية. String أمثلة مثال على الاستخدام
Query
SELECT
    arrayJoin([100, 12345, 432546534]) AS elapsed,
    formatReadableTimeDelta(elapsed) AS time_delta
Response
┌────elapsed─┬─time_delta─────────────────────────────────────────────────────┐
│        100 │ 1 minute and 40 seconds                                        │
│      12345 │ 3 hours, 25 minutes and 45 seconds                             │
│  432546534 │ 13 years, 8 months, 17 days, 7 hours, 48 minutes and 54 seconds│
└────────────┴────────────────────────────────────────────────────────────────┘
مع أكبر وحدة
Query
SELECT
    arrayJoin([100, 12345, 432546534]) AS elapsed,
    formatReadableTimeDelta(elapsed, 'minutes') AS time_delta
Response
┌────elapsed─┬─time_delta─────────────────────────────────────────────────────┐
│        100 │ 1 minute and 40 seconds                                         │
│      12345 │ 205 minutes and 45 seconds                                      │
│  432546534 │ 7209108 minutes and 54 seconds                                  │
└────────────┴─────────────────────────────────────────────────────────────────┘
باستخدام تعبير INTERVAL
Query
SELECT formatReadableTimeDelta(INTERVAL 12345 SECOND) AS time_delta
Response
┌─time_delta─────────────────────────┐
│ 3 hours, 25 minutes and 45 seconds │
└────────────────────────────────────┘

​
fuzzQuery

أُضيفت في: v26.2.0 تُحلِّل سلسلة الاستعلام المعطاة وتُطبِّق عليها طفرات عشوائية على AST (التشويش). وتُرجِع الاستعلام الناتج عن التشويش كسلسلة نصية. غير حتمي: قد يُنتِج كل استدعاء نتيجة مختلفة. وتتطلب allow_fuzz_query_functions = 1. الصيغة 
fuzzQuery(query)
المعاملات
  • query — استعلام SQL المراد إخضاعه للاختبار العشوائي. String
القيمة المعادة سلسلة الاستعلام بعد إخضاعها للاختبار العشوائي String أمثلة بسيط
Query
SET allow_fuzz_query_functions = 1; SELECT fuzzQuery('SELECT 1');
Response

​
generateRandomStructure

أُضيف في: v23.5.0 يولّد بنية جدول عشوائية بالتنسيق column1_name column1_type, column2_name column2_type, .... الصياغة 
generateRandomStructure([number_of_columns, seed])
الوسيطات
  • number_of_columns — العدد المطلوب من الأعمدة في بنية الجدول الناتجة. إذا ضُبطت القيمة على 0 أو Null، فسيكون عدد الأعمدة عشوائيًا بين 1 و128. القيمة الافتراضية: Null. UInt64
  • seed — بذرة عشوائية لإنتاج نتائج ثابتة. إذا لم يتم تحديد seed أو ضُبطت قيمته على Null، فسيتم توليدها عشوائيًا. UInt64
القيمة المُعادة بنية جدول مُولَّدة عشوائيًا. String أمثلة مثال على الاستخدام
Query
SELECT generateRandomStructure()
Response
c1 Decimal32(5), c2 Date, c3 Tuple(LowCardinality(String), Int128, UInt64, UInt16, UInt8, IPv6), c4 Array(UInt128), c5 UInt32, c6 IPv4, c7 Decimal256(64), c8 Decimal128(3), c9 UInt256, c10 UInt64, c11 DateTime
بعدد أعمدة محدد
Query
SELECT generateRandomStructure(1)
Response
c1 Map(UInt256, UInt16)
باستخدام قيمة ابتدائية محددة
Query
SELECT generateRandomStructure(NULL, 33)
Response
c1 DateTime, c2 Enum8('c2V0' = 0, 'c2V1' = 1, 'c2V2' = 2, 'c2V3' = 3), c3 LowCardinality(Nullable(FixedString(30))), c4 Int16, c5 Enum8('c5V0' = 0, 'c5V1' = 1, 'c5V2' = 2, 'c5V3' = 3), c6 Nullable(UInt8), c7 String, c8 Nested(e1 IPv4, e2 UInt8, e3 UInt16, e4 UInt16, e5 Int32, e6 Map(Date, Decimal256(70)))

​
generateSerialID

أُضيفت في: v25.1.0 تُولِّد هذه الدالة أرقامًا تسلسلية وتُعيدها بدءًا من قيمة العداد السابقة. تأخذ هذه الدالة وسيطًا نصيًا — معرّف السلسلة — وقيمة بدء اختيارية. يجب تهيئة الخادم لاستخدام Keeper. تُخزَّن السلاسل في عُقد Keeper تحت المسار، الذي يمكن تهيئته في series_keeper_path ضمن تهيئة الخادم. الصياغة 
generateSerialID(series_identifier[, start_value])
الوسائط
  • series_identifier — معرّف السلسلة const String
  • start_value — اختياري. قيمة بداية العداد. القيمة الافتراضية هي 0. ملاحظة: لا تُستخدم هذه القيمة إلا عند إنشاء سلسلة جديدة، ويجري تجاهلها إذا كانت السلسلة موجودة بالفعل UInt*
القيمة المُعادة يعيد أرقامًا متسلسلة تبدأ من قيمة العداد السابقة. UInt64 أمثلة الاستدعاء الأول
Query
SELECT generateSerialID('id1')
Response
┌─generateSerialID('id1')──┐
│                        1 │
└──────────────────────────┘
الاستدعاء الثاني
Query
SELECT generateSerialID('id1')
Response
┌─generateSerialID('id1')──┐
│                        2 │
└──────────────────────────┘
استدعاء العمود
Query
SELECT *, generateSerialID('id1') FROM test_table
Response
┌─CounterID─┬─UserID─┬─ver─┬─generateSerialID('id1')──┐
│         1 │      3 │   3 │                        3 │
│         1 │      1 │   1 │                        4 │
│         1 │      2 │   2 │                        5 │
│         1 │      5 │   5 │                        6 │
│         1 │      4 │   4 │                        7 │
└───────────┴────────┴─────┴──────────────────────────┘
مع قيمة ابتدائية
Query
SELECT generateSerialID('id2', 100)
Response
┌─generateSerialID('id2', 100)──┐
│                           100 │
└───────────────────────────────┘
مع قيمة البداية في الاستدعاء الثاني
Query
SELECT generateSerialID('id2', 100)
Response
┌─generateSerialID('id2', 100)──┐
│                           101 │
└───────────────────────────────┘

​
getClientHTTPHeader

أُضيف في: v24.5.0 تعيد قيمة ترويسة HTTP. إذا لم تكن هناك ترويسة بهذا الاسم، أو إذا لم يُنفَّذ الطلب الحالي عبر واجهة HTTP، فستُرجع الدالة سلسلة فارغة. بعض ترويسات HTTP (مثل Authentication و X-ClickHouse-*) مقيّدة.
يتطلب تمكين الإعداد allow_get_client_http_headerتتطلب الدالة أن يكون الإعداد allow_get_client_http_header مُمكّنًا. لا يكون هذا الإعداد مُمكّنًا افتراضيًا لأسباب أمنية، لأن بعض الترويسات، مثل Cookie، قد تحتوي على معلومات حساسة.
تكون ترويسات HTTP في هذه الدالة حساسة لحالة الأحرف. إذا استُخدمت الدالة في سياق استعلام موزّع، فإنها لا تُرجع نتيجة غير فارغة إلا على العقدة المُبادِئة. البنية 
getClientHTTPHeader(name)
المعاملات
  • name — اسم ترويسة HTTP. String
القيمة المعادة تُرجِع قيمة الترويسة. String أمثلة مثال للاستخدام
Query
SELECT getClientHTTPHeader('Content-Type');
Response
┌─getClientHTTPHeader('Content-Type')─┐
│ application/x-www-form-urlencoded   │
└─────────────────────────────────────┘

​
getMacro

أُضيف في: v20.1.0 يعيد قيمة ماكرو من ملف تهيئة الخادم. تُعرَّف وحدات الماكرو في قسم <macros> من ملف التهيئة، ويمكن استخدامها لتمييز الخوادم بأسماء مناسبة حتى لو كانت أسماء المضيفين الخاصة بها معقدة. إذا نُفِّذت الدالة في سياق جدول موزّع، فإنها تُنشئ عمودًا عاديًا بقيم مرتبطة بكل shard. البنية 
getMacro(name)
المعاملات
  • name — اسم الماكرو المطلوب استرجاعه. const String
القيمة المعادة تُرجِع قيمة الماكرو المحدد. String أمثلة الاستخدام الأساسي
Query
SELECT getMacro('test');
Response
┌─getMacro('test')─┐
│ Value            │
└──────────────────┘

​
getMaxTableNameLengthForDatabase

أُضيف في: v25.1.0 يعيد الحد الأقصى لطول اسم الجدول في قاعدة بيانات محددة. البنية 
getMaxTableNameLengthForDatabase(database_name)
الوسيطات
  • database_name — اسم قاعدة البيانات المحددة. String
القيمة المُعادة تعيد الحد الأقصى لطول اسم الجدول، وهو عدد صحيح أمثلة اعتيادي
Query
SELECT getMaxTableNameLengthForDatabase('default');
Response
┌─getMaxTableNameLengthForDatabase('default')─┐
            │                                         206 │
            └─────────────────────────────────────────────┘

​
getMergeTreeSetting

أُضيفت في: v25.6.0 تُرجع القيمة الحالية لأحد إعدادات MergeTree. الصيغة 
getMergeTreeSetting(setting_name)
الوسائط
  • setting_name — اسم الإعداد. String
القيمة المُعادة تُرجع القيمة الحالية لإعداد MergeTree. أمثلة مثال على الاستخدام
Query
SELECT getMergeTreeSetting('index_granularity');
Response
┌─getMergeTreeSetting('index_granularity')─┐
│                                     8192 │
└──────────────────────────────────────────┘

​
getOSKernelVersion

أُضيفت في: v21.11.0 تُرجع سلسلة نصية تحتوي على إصدار نواة نظام التشغيل. الصياغة 
getOSKernelVersion()
الوسائط
  • لا شيء.
القيمة المعادة تعيد إصدار نواة نظام التشغيل الحالي. String أمثلة مثال على الاستخدام
Query
SELECT getOSKernelVersion();
Response
┌─getOSKernelVersion()────┐
│ Linux 4.15.0-55-generic │
└─────────────────────────┘

​
getServerPort

أُضيف في: v21.10.0 يعيد رقم منفذ الخادم للبروتوكول المحدد. الصيغة 
getServerPort(port_name)
المعاملات
  • port_name — اسم المنفذ. String
القيمة المُعادة تعيد رقم منفذ الخادم. UInt16 أمثلة مثال للاستخدام
Query
SELECT getServerPort('tcp_port');
Response
┌─getServerPort('tcp_port')─┐
│                      9000 │
└───────────────────────────┘

​
getServerSetting

أُضيف في: v25.6.0 يعيد القيمة المعينة حاليًا عند تزويده باسم إعداد الخادم. البنية 
getServerSetting(setting_name')
الوسائط
  • setting_name — اسم إعداد الخادم. String
القيمة المُعادة تُرجع القيمة الحالية لإعداد الخادم. Any أمثلة مثال على الاستخدام
Query
SELECT getServerSetting('allow_use_jemalloc_memory');
Response
┌─getServerSetting('allow_use_jemalloc_memory')─┐
│ true                                          │
└───────────────────────────────────────────────┘

​
getSetting

أُضيف في: v20.7.0 يُرجع القيمة الحالية للإعداد. البنية 
getSetting(setting_name)
الوسيطات القيمة المُعادة تُرجع القيمة الحالية للإعداد. Any أمثلة مثال على الاستخدام
Query
SELECT getSetting('enable_analyzer');
SET enable_analyzer = false;
SELECT getSetting('enable_analyzer');
Response
┌─getSetting('⋯_analyzer')─┐
│ true                     │
└──────────────────────────┘
┌─getSetting('⋯_analyzer')─┐
│ false                    │
└──────────────────────────┘

​
getSettingOrDefault

قُدِّمت في: v24.10.0 تعيد القيمة الحالية لإعداد ما، أو تعيد القيمة الافتراضية المحددة في الوسيطة الثانية إذا لم يكن الإعداد معيّنًا في الملف الشخصي الحالي. البنية 
getSettingOrDefault(setting_name, default_value)
المعاملات
  • setting_name — اسم الإعداد. String
  • default_value — القيمة التي ستُعاد إذا لم يتم تعيين custom_setting. ويمكن أن تكون هذه القيمة من أي نوع بيانات أو Null.
القيمة المُعادة تُعيد القيمة الحالية للإعداد المحدد، أو default_value إذا لم يتم تعيين الإعداد. أمثلة مثال على الاستخدام
Query
SELECT getSettingOrDefault('custom_undef1', 'my_value');
SELECT getSettingOrDefault('custom_undef2', 100);
SELECT getSettingOrDefault('custom_undef3', NULL);
Response
my_value
100
NULL

​
getSizeOfEnumType

أُضيف في: v1.1.0 يعيد عدد الحقول في Enum المعطى. البنية 
getSizeOfEnumType(x)
المعاملات
  • x — قيمة من النوع Enum. Enum
القيمة المُعادة يُرجع عدد الحقول ذات قيم الإدخال من النوع Enum. UInt8/16 أمثلة مثال على الاستخدام
Query
SELECT getSizeOfEnumType(CAST('a' AS Enum8('a' = 1, 'b' = 2))) AS x;
Response
┌─x─┐
│ 2 │
└───┘

​
getSubcolumn

أُضيف في: v23.3.0 يستقبل تعبيرًا أو معرّفًا، بالإضافة إلى سلسلة نصية ثابتة تمثل اسم العمود الفرعي. يعيد العمود الفرعي المطلوب المستخرج من التعبير. البنية 
getSubcolumn(nested_value, subcolumn_name)
الوسائط
  • لا شيء.
القيمة المُعادة أمثلة getSubcolumn
Query
SELECT getSubcolumn(array_col, 'size0'), getSubcolumn(tuple_col, 'elem_name')
Response

​
getTypeSerializationStreams

أُضيف في: v22.6.0 يسرد مسارات التدفق الخاصة بنوع البيانات. هذه الدالة مخصّصة لأغراض التطوير. الصيغة 
getTypeSerializationStreams(col)
الوسيطات
  • col — عمود أو تمثيل نصي لنوع بيانات يُكتشف منه نوع البيانات. Any
القيمة المُعادة يعيد مصفوفة تحتوي على جميع مسارات التدفقات الفرعية الخاصة بالتسلسل. Array(String) أمثلة tuple
Query
SELECT getTypeSerializationStreams(tuple('a', 1, 'b', 2))
Response
['{TupleElement(1), Regular}','{TupleElement(2), Regular}','{TupleElement(3), Regular}','{TupleElement(4), Regular}']
map
Query
SELECT getTypeSerializationStreams('Map(String, Int64)')
Response
['{ArraySizes}','{ArrayElements, TupleElement(keys), Regular}','{ArrayElements, TupleElement(values), Regular}']

​
globalVariable

قُدِّمت في: v20.5.0 تأخذ وسيطة String ثابتة وتُرجع قيمة المتغير العام الذي يحمل هذا الاسم. هذه الدالة مخصّصة للتوافق مع MySQL، وليست مطلوبة أو مفيدة للتشغيل العادي لـ ClickHouse. لا يوجد سوى عدد قليل من المتغيرات العامة الوهمية المعرَّفة. البنية 
globalVariable(name)
الوسائط
  • name — اسم المتغير العام. String
القيمة المُعادة تعيد قيمة المتغير name. Any أمثلة globalVariable
Query
SELECT globalVariable('max_allowed_packet')
Response
67108864

​
hasColumnInTable

أُضيفت في: v1.1.0 يتحقق مما إذا كان عمود محدد موجودًا في جدول بقاعدة بيانات. وبالنسبة إلى العناصر ضمن بنية بيانات متداخلة، تتحقق الدالة من وجود عمود. أما بنية البيانات المتداخلة نفسها، فتعيد الدالة القيمة 0. بناء الجملة 
hasColumnInTable([hostname[, username[, password]],]database, table, column)
الوسائط
  • database — اسم قاعدة البيانات. const String
  • table — اسم الجدول. const String
  • column — اسم العمود. const String
  • hostname — اختياري. اسم الخادم البعيد الذي سيتم إجراء التحقق عليه. const String
  • username — اختياري. اسم المستخدم للخادم البعيد. const String
  • password — اختياري. كلمة المرور للخادم البعيد. const String
القيمة المُعادة يعيد 1 إذا كان العمود المحدد موجودًا، وإلا فيعيد 0. UInt8 أمثلة التحقق من وجود عمود
Query
SELECT hasColumnInTable('system','metrics','metric')
Response
1
التحقق من عمود غير موجود
Query
SELECT hasColumnInTable('system','metrics','non-existing_column')
Response
0

​
hasThreadFuzzer

أُضيف في: v20.6.0 يعيد ما إذا كان thread fuzzer مفعّلًا. هذه الدالة مفيدة فقط للاختبار وتصحيح الأخطاء. الصيغة 
hasThreadFuzzer()
المعاملات
  • لا يوجد.
القيمة المُعادة يعيد ما إذا كان Thread Fuzzer مفعّلًا. UInt8 أمثلة التحقق من حالة Thread Fuzzer
Query
SELECT hasThreadFuzzer()
Response
┌─hasThreadFuzzer()─┐
│                 0 │
└───────────────────┘

​
highlightQuery

أُضيف في: v26.5.0 يحلّل سلسلة query في ClickHouse SQL ويُرجع Array من النطاقات المميّزة لاستخدامها في تمييز الصياغة. كل نطاق عبارة عن named tuple يتضمن موضع البداية (بالبايتات)، وموضع النهاية، ونوع التمييز. وتصف أنواع التمييز الدور النحوي للمقطع (keyword، أو identifier، أو function، وما إلى ذلك) ويمكن استخدامها لتعيين الألوان في واجهة المستخدم. داخل أنماط السلاسل النصية لـ LIKE وREGEXP، تُميَّز المحارف الفوقية وأحرف الإفلات كلٌّ على حدة. الصياغة 
highlightQuery(query)
المعاملات
  • query — سلسلة استعلام في ClickHouse SQL. String.
القيمة المُعادة مصفوفة من Tuples مُسمّاة (begin UInt64, end UInt64, type Enum8(...)) تمثّل النطاقات المميّزة. Array(Tuple(begin UInt64, end UInt64, type Enum8(...))) أمثلة بسيط
Query
SELECT highlightQuery('SELECT 1')
Response
[(0,6,'keyword'),(7,8,'number')]

​
hostName

أُضيفت في: v20.5.0 تعيد اسم المضيف الذي نُفِّذت عليه هذه الدالة. إذا نُفِّذت الدالة على خادم بعيد (المعالجة الموزعة)، فسيُعاد اسم الخادم البعيد. إذا نُفِّذت الدالة ضمن سياق جدول موزّع، فإنها تُنشئ عمودًا عاديًا بقيم تخص كل جزء. وفي غير ذلك، فإنها تُنتج قيمة ثابتة. الصيغة 
hostName()
الأسماء المستعارة: hostname الوسائط
  • لا شيء.
القيمة المُعادة يعيد اسم المضيف. String أمثلة مثال على الاستخدام
Query
SELECT hostName()
Response
┌─hostName()─┐
│ clickhouse │
└────────────┘

​
icebergBucket

أُضيف في: v25.5.0 يُنفِّذ المنطق الخاص بـ تحويل bucket في Iceberg البنية 
icebergBucket(N, value)
الوسيطات القيمة المُعادة يعيد قيمة تجزئة بطول 32 بت للقيمة المصدرية. Int32 أمثلة مثال
Query
SELECT icebergBucket(5, 1.0 :: Float32)
Response
4

​
icebergTruncate

أُضيف في: v25.3.0 يطبّق منطق تحويل truncate في Iceberg: https://iceberg.apache.org/spec/#truncate-transform-details. البنية 
icebergTruncate(N, value)
الوسيطات القيمة المُعادة نفس نوع الوسيط أمثلة مثال
Query
SELECT icebergTruncate(3, 'iceberg')
Response
ice

​
identity

أُضيفت في: v1.1.0 تعيد هذه الدالة الوسيطة التي تمرّرها إليها، وهو ما يفيد في تصحيح الأخطاء والاختبار. كما تتيح لك تجاوز استخدام الفهرس لمعاينة أداء المسح الكامل بدلًا من ذلك. ويتجاهل محلل الاستعلام أي شيء داخل دوال identity عند البحث عن الفهارس التي سيستخدمها، كما يعطّل أيضًا طيّ الثوابت. الصياغة 
identity(x)
الوسيطات
  • x — قيمة الإدخال. Any
القيمة المعادة تعيد قيمة الإدخال دون تغيير. Any أمثلة مثال للاستخدام
Query
SELECT identity(42)
Response
42

​
ignore

استُحدث في: v1.1.0 يقبل أي وسيطات ويُرجع 0 دائمًا. الصياغة 
ignore(x)
الوسائط
  • x — قيمة إدخال غير مستخدمة، وتُمرَّر فقط لتجنّب حدوث خطأ نحوي. Any
القيمة المُعادة تُعيد دائمًا 0. UInt8 أمثلة مثال للاستخدام
Query
SELECT ignore(0, 'ClickHouse', NULL)
Response
┌─ignore(0, 'ClickHouse', NULL)─┐
│                             0 │
└───────────────────────────────┘

​
indexHint

أُضيف في: v1.1.0 هذه الدالة مخصّصة لأغراض تصحيح الأخطاء والفحص الداخلي. فهي تتجاهل وسيطها وتُرجع دائمًا 1. كما أن الوسائط لا تُقيَّم. أثناء تحليل الفهرس، يُفترَض أن وسيط هذه الدالة ليس مغلّفًا داخل indexHint. ويتيح لك ذلك تحديد البيانات ضمن نطاقات الفهرس وفقًا للشرط المقابل، ولكن من دون إجراء تصفية إضافية بناءً على هذا الشرط. وبما أن الفهرس في ClickHouse متناثر، فإن استخدام indexHint سيؤدي إلى إرجاع بيانات أكثر من تحديد الشرط نفسه مباشرةً.
عندما تُشغِّل:
SELECT * FROM test WHERE key = 123;
فإن ClickHouse يقوم بأمرين:
  1. يستخدم الفهرس لتحديد الحبيبات (كتل تضم نحو 8192 صفًا) التي قد تحتوي على key = 123
  2. يقرأ تلك الحبيبات ويصفّيها صفًا بصف لإرجاع الصفوف التي يكون فيها key = 123 فقط
لذا، حتى إذا قرأ 8,192 صفًا من القرص، فإنه لا يُرجع إلا الصف الوحيد المطابق فعليًا.أما مع indexHint، فعندما تُشغِّل:
SELECT * FROM test WHERE indexHint(key = 123);
فإن ClickHouse يقوم بأمر واحد فقط:
  1. يستخدم الفهرس لتحديد الحبيبات التي قد تحتوي على key = 123 ويُرجع جميع الصفوف من تلك الحبيبات من دون تصفية.
فهو يُرجع الصفوف الـ 8,192 كلها، بما في ذلك الصفوف التي فيها key = 456 وkey = 789 وما إلى ذلك. (أي كل ما صادف تخزينه في الحبيبة نفسها.) إن indexHint() ليس مخصّصًا للأداء، بل لتصحيح الأخطاء وفهم كيفية عمل فهرس ClickHouse:
  • ما الحبيبات التي يحدّدها الشرط الخاص بي؟
  • كم عدد الصفوف الموجودة في تلك الحبيبات؟
  • هل يُستخدم الفهرس لديّ بفاعلية؟
ملاحظة: لا يمكن تحسين أي استعلام باستخدام الدالة indexHint. فالدالة indexHint لا تحسّن الاستعلام، لأنها لا توفّر أي معلومات إضافية لتحليل الاستعلام. كما أن وضع تعبير داخل الدالة indexHint ليس أفضل بأي شكل من عدم استخدام الدالة indexHint. ولا يمكن استخدام الدالة indexHint إلا لأغراض الفحص الداخلي وتصحيح الأخطاء، وهي لا تحسّن الأداء. وإذا رأيت استخدام indexHint من أي جهة غير المساهمين في ClickHouse، فغالبًا ما يكون ذلك خطأً ويجب عليك إزالته. الصياغة 
indexHint(expression)
المعاملات
  • expression — أي تعبير لاختيار نطاق الفهرس. Expression
القيمة المُعادة تعيد 1 في جميع الحالات. UInt8 أمثلة مثال استخدام مع التصفية حسب التاريخ
Query
SELECT FlightDate AS k, count() FROM ontime WHERE indexHint(k = '2025-09-15') GROUP BY k ORDER BY k ASC;
Response
┌──────────k─┬─count()─┐
│ 2025-09-14 │    7071 │
│ 2025-09-15 │   16428 │
│ 2025-09-16 │    1077 │
│ 2025-09-30 │    8167 │
└────────────┴─────────┘

​
initialQueryID

أُضيف في: v1.1.0 يُرجع معرّف الاستعلام الحالي الأصلي. يمكن استخراج المعلمات الأخرى الخاصة بالاستعلام من الحقل initial_query_id في system.query_log. بخلاف الدالة queryID، تُرجع initialQueryID النتائج نفسها على الشظايا المختلفة. البنية 
initialQueryID()
الأسماء البديلة: initial_query_id المعاملات
  • لا شيء.
القيمة المُعادة تعيد معرّف الاستعلام الحالي الأوّلي. String أمثلة مثال على الاستخدام
Query
CREATE TABLE tmp (str String) ENGINE = Log;
INSERT INTO tmp (*) VALUES ('a');
SELECT count(DISTINCT t) FROM (SELECT initialQueryID() AS t FROM remote('127.0.0.{1..3}', currentDatabase(), 'tmp') GROUP BY queryID());
Response
┌─count(DISTINCT t)─┐
│                 1 │
└───────────────────┘

​
initialQueryStartTime

قُدِّم في: v25.4.0 يعيد وقت بدء الاستعلام الحالي الأصلي. يعيد initialQueryStartTime النتائج نفسها على مختلف الشظايا. الصياغة 
initialQueryStartTime()
الأسماء المستعارة: initial_query_start_time المعاملات
  • لا يوجد.
القيمة المُعادة تعيد وقت بدء الاستعلام الحالي الأوّلي. DateTime أمثلة مثال على الاستخدام
Query
CREATE TABLE tmp (str String) ENGINE = Log;
INSERT INTO tmp (*) VALUES ('a');
SELECT count(DISTINCT t) FROM (SELECT initialQueryStartTime() AS t FROM remote('127.0.0.{1..3}', currentDatabase(), 'tmp') GROUP BY queryID());
Response
┌─count(DISTINCT t)─┐
│                 1 │
└───────────────────┘

​
initializeAggregation

أُضيفت في: v20.6.0 تحسب نتيجة دالة تجميعية استنادًا إلى قيمة واحدة. يمكن استخدام هذه الدالة لتهيئة دوال التجميع باستخدام المُركِّب -State. يمكنك إنشاء حالات لدوال التجميع وإدراجها في أعمدة من النوع AggregateFunction، أو استخدام التجميعات المُهيّأة كقيم افتراضية. البنية 
initializeAggregation(aggregate_function, arg1[, arg2, ...])
الوسيطات
  • aggregate_function — اسم دالة التجميع المراد تهيئتها. String
  • arg1[, arg2, ...] — وسيطات دالة التجميع. Any
القيمة المعادة تُرجع نتيجة التجميع لكل صف يُمرَّر إلى الدالة. ويكون نوع الإرجاع مطابقًا لنوع الإرجاع الخاص بالدالة التي تأخذها initializeAggregation بوصفها الوسيط الأول. Any أمثلة الاستخدام الأساسي مع uniqState
Query
SELECT uniqMerge(state) FROM (SELECT initializeAggregation('uniqState', number % 3) AS state FROM numbers(10000));
Response
┌─uniqMerge(state)─┐
│                3 │
└──────────────────┘
استخدام sumState و finalizeAggregation
Query
SELECT finalizeAggregation(state), toTypeName(state) FROM (SELECT initializeAggregation('sumState', number % 3) AS state FROM numbers(5));
Response
┌─finalizeAggregation(state)─┬─toTypeName(state)─────────────┐
│                          0 │ AggregateFunction(sum, UInt8) │
│                          1 │ AggregateFunction(sum, UInt8) │
│                          2 │ AggregateFunction(sum, UInt8) │
│                          0 │ AggregateFunction(sum, UInt8) │
│                          1 │ AggregateFunction(sum, UInt8) │
└────────────────────────────┴───────────────────────────────┘

​
isConstant

قُدِّمت في: v20.3.0 تُرجع ما إذا كانت الوسيطة تعبيرًا ثابتًا. والتعبير الثابت هو تعبير تكون نتيجته معروفة أثناء تحليل الاستعلام، أي قبل التنفيذ. على سبيل المثال، تُعدّ التعبيرات المبنية على القيم الحرفية تعبيرات ثابتة. تُستخدم هذه الدالة غالبًا لأغراض التطوير وتصحيح الأخطاء والتوضيح. الصيغة 
isConstant(x)
المعاملات
  • x — تعبير للتحقق منه. Any
القيمة المُعادة تعيد 1 إذا كان x ثابتًا، و0 إذا كان x غير ثابت. UInt8 أمثلة تعبير ثابت
Query
SELECT isConstant(x + 1)
FROM (SELECT 43 AS x)
Response
┌─isConstant(plus(x, 1))─┐
│                      1 │
└────────────────────────┘
ثابت مع استخدام دالة
Query
WITH 3.14 AS pi
SELECT isConstant(cos(pi))
Response
┌─isConstant(cos(pi))─┐
│                   1 │
└─────────────────────┘
تعبير غير ثابت
Query
SELECT isConstant(number)
FROM numbers(1)
Response
┌─isConstant(number)─┐
│                  0 │
└────────────────────┘
سلوك الدالة now()
Query
SELECT isConstant(now())
Response
┌─isConstant(now())─┐
│                 1 │
└───────────────────┘

​
isDecimalOverflow

استُحدثت في: v20.8.0 يتحقق مما إذا كان العدد العشري يحتوي على عدد كبير جدًا من الخانات بحيث لا يمكن تمثيله بشكل صحيح ضمن نوع البيانات Decimal عند دقة محددة. البنية 
isDecimalOverflow(value[, precision])
الوسائط
  • value — قيمة Decimal المطلوب التحقق منها. Decimal
  • precision — اختياري. دقة النوع Decimal. إذا لم يتم تحديده، تُستخدم الدقة الأصلية للوسيطة الأولى. UInt8
القيمة المُعادة تعيد 1 إذا كانت قيمة Decimal تحتوي على عدد من الخانات أكبر مما تسمح به دقتها، و0 إذا كانت قيمة Decimal تستوفي الدقة المحددة. UInt8 أمثلة مثال على الاستخدام
Query
SELECT isDecimalOverflow(toDecimal32(1000000000, 0), 9),
       isDecimalOverflow(toDecimal32(1000000000, 0)),
       isDecimalOverflow(toDecimal32(-1000000000, 0), 9),
       isDecimalOverflow(toDecimal32(-1000000000, 0));
Response
┌─isDecimalOverflow(toDecimal32(1000000000, 0), 9)─┬─isDecimalOverflow(toDecimal32(1000000000, 0))─┬─isDecimalOverflow(toDecimal32(-1000000000, 0), 9)─┬─isDecimalOverflow(toDecimal32(-1000000000, 0))─┐
│                                                1 │                                             1 │                                                 1 │                                              1 │
└──────────────────────────────────────────────────┴───────────────────────────────────────────────┴───────────────────────────────────────────────────┴────────────────────────────────────────────────┘

​
joinGet

أُضيف في: v18.16.0 يتيح لك استخراج البيانات من جدول بالطريقة نفسها كما لو كانت من قاموس. يجلب البيانات من جداول Join باستخدام مفتاح الربط المحدد.
يدعم فقط الجداول التي أُنشئت باستخدام ENGINE = Join(ANY, LEFT, <join_keys>) عبارة.
الصياغة 
joinGet(join_storage_table_name, value_column, join_keys)
الوسيطات
  • join_storage_table_name — معرّف يحدّد مكان إجراء البحث. يُبحث عن هذا المعرّف في قاعدة البيانات الافتراضية (راجع المَعلمة default_database في ملف الإعدادات). لتجاوز قاعدة البيانات الافتراضية، استخدم الاستعلام USE database_name أو حدّد قاعدة البيانات والجدول باستخدام نقطة، مثل database_name.table_name. String
  • value_column — اسم عمود الجدول الذي يحتوي على البيانات المطلوبة. const String
  • join_keys — قائمة بمفاتيح الربط. Any
القيمة المُعادة يعيد قائمة من القيم المقابلة لقائمة المفاتيح. Any أمثلة مثال على الاستخدام
Query
CREATE TABLE db_test.id_val(`id` UInt32, `val` UInt32) ENGINE = Join(ANY, LEFT, id);
INSERT INTO db_test.id_val VALUES (1,11)(2,12)(4,13);

SELECT joinGet(db_test.id_val, 'val', toUInt32(1));
Response
┌─joinGet(db_test.id_val, 'val', toUInt32(1))─┐
│                                          11 │
└─────────────────────────────────────────────┘
الاستخدام مع جدول من قاعدة البيانات الحالية
Query
USE db_test;
SELECT joinGet(id_val, 'val', toUInt32(2));
Response
┌─joinGet(id_val, 'val', toUInt32(2))─┐
│                                  12 │
└─────────────────────────────────────┘
استخدام المصفوفات كمفاتيح للربط
Query
CREATE TABLE some_table (id1 UInt32, id2 UInt32, name String) ENGINE = Join(ANY, LEFT, id1, id2);
INSERT INTO some_table VALUES (1, 11, 'a') (2, 12, 'b') (3, 13, 'c');

SELECT joinGet(some_table, 'name', 1, 11);
Response
┌─joinGet(some_table, 'name', 1, 11)─┐
│ a                                  │
└────────────────────────────────────┘

​
joinGetOrNull

قُدِّمت في: v20.4.0 تتيح لك استخراج البيانات من جدول بالطريقة نفسها المتبعة مع القاموس. تجلب البيانات من جداول Join باستخدام مفتاح join المحدد. وعلى خلاف joinGet، فإنها تُرجع NULL عندما يكون المفتاح غير موجود.
لا تدعم إلا الجداول المُنشأة باستخدام تعليمة ENGINE = Join(ANY, LEFT, <join_keys>).
الصياغة 
joinGetOrNull(join_storage_table_name, value_column, join_keys)
المعاملات
  • join_storage_table_name — معرّف يحدّد مكان إجراء البحث. يُجرى البحث عن هذا المعرّف في قاعدة البيانات default (راجع المعامل default_database في ملف الإعدادات). لتجاوز قاعدة البيانات default، استخدم الاستعلام USE database_name أو حدِّد قاعدة البيانات والجدول باستخدام نقطة، مثل database_name.table_name. String
  • value_column — اسم العمود في الجدول الذي يحتوي على البيانات المطلوبة. const String
  • join_keys — قائمة بمفاتيح الربط. Any
القيمة المُعادة يعيد قائمة بالقيم المقابلة لقائمة المفاتيح، أو NULL إذا لم يُعثر على مفتاح. Any أمثلة مثال على الاستخدام
Query
CREATE TABLE db_test.id_val(`id` UInt32, `val` UInt32) ENGINE = Join(ANY, LEFT, id);
INSERT INTO db_test.id_val VALUES (1,11)(2,12)(4,13);

SELECT joinGetOrNull(db_test.id_val, 'val', toUInt32(1)), joinGetOrNull(db_test.id_val, 'val', toUInt32(999));
Response
┌─joinGetOrNull(db_test.id_val, 'val', toUInt32(1))─┬─joinGetOrNull(db_test.id_val, 'val', toUInt32(999))─┐
│                                                11 │                                                ᴺᵁᴸᴸ │
└───────────────────────────────────────────────────┴─────────────────────────────────────────────────────┘

​
lowCardinalityIndices

تمت إضافته في: v18.12.0 تعيد هذه الدالة موضع قيمة في القاموس الخاص بعمود LowCardinality. تبدأ المواضع من 1. ونظرًا لأن LowCardinality يستخدم قواميس لكل جزء، فقد تُرجِع هذه الدالة مواضع مختلفة للقيمة نفسها في أجزاء مختلفة. الصياغة 
lowCardinalityIndices(col)
الوسائط
  • col — عمود منخفض الكاردينالية. LowCardinality
القيمة المُعادة موضع القيمة في القاموس الخاص بالجزء الحالي. UInt64 أمثلة أمثلة الاستخدام
Query
DROP TABLE IF EXISTS test;
CREATE TABLE test (s LowCardinality(String)) ENGINE = Memory;

-- create two parts:

INSERT INTO test VALUES ('ab'), ('cd'), ('ab'), ('ab'), ('df');
INSERT INTO test VALUES ('ef'), ('cd'), ('ab'), ('cd'), ('ef');

SELECT s, lowCardinalityIndices(s) FROM test;
Response
┌─s──┬─lowCardinalityIndices(s)─┐
│ ab │                        1 │
│ cd │                        2 │
│ ab │                        1 │
│ ab │                        1 │
│ df │                        3 │
└────┴──────────────────────────┘
┌─s──┬─lowCardinalityIndices(s)─┐
│ ef │                        1 │
│ cd │                        2 │
│ ab │                        3 │
│ cd │                        2 │
│ ef │                        1 │
└────┴──────────────────────────┘

​
lowCardinalityKeys

أُضيف في: v18.12.0 تُرجع قيم القاموس لعمود LowCardinality. إذا كانت الكتلة أصغر من حجم القاموس أو أكبر منه، فستُقتطع النتيجة أو تُستكمل باستخدام القيم الافتراضية. ونظرًا لأن LowCardinality تستخدم قواميس منفصلة لكل جزء، فقد تُرجع هذه الدالة قيم قاموس مختلفة في الأجزاء المختلفة. البنية 
lowCardinalityKeys(col)
الوسائط القيمة المُعادة يُرجع مفاتيح القاموس. UInt64 أمثلة lowCardinalityKeys
Query
DROP TABLE IF EXISTS test;
CREATE TABLE test (s LowCardinality(String)) ENGINE = Memory;

-- create two parts:

INSERT INTO test VALUES ('ab'), ('cd'), ('ab'), ('ab'), ('df');
INSERT INTO test VALUES ('ef'), ('cd'), ('ab'), ('cd'), ('ef');

SELECT s, lowCardinalityKeys(s) FROM test;
Response
┌─s──┬─lowCardinalityKeys(s)─┐
│ ef │                       │
│ cd │ ef                    │
│ ab │ cd                    │
│ cd │ ab                    │
│ ef │                       │
└────┴───────────────────────┘
┌─s──┬─lowCardinalityKeys(s)─┐
│ ab │                       │
│ cd │ ab                    │
│ ab │ cd                    │
│ ab │ df                    │
│ df │                       │
└────┴───────────────────────┘

​
materialize

استُحدث في: v1.1.0 يحوِّل قيمة ثابتة إلى عمود كامل يحتوي على قيمة واحدة. تُمثَّل الأعمدة الكاملة والثوابت بصورة مختلفة في الذاكرة. عادةً ما تنفِّذ الدوال شيفرة مختلفة للوسائط العادية والثابتة، رغم أن النتيجة ينبغي في الغالب أن تكون واحدة. يمكن استخدام هذه الدالة لتصحيح هذا السلوك. الصيغة 
materialize(x)
الوسائط
  • x — ثابت. Any
القيمة المُعادة يعيد عمودًا كاملاً يحتوي على القيمة الثابتة. Any أمثلة مثال على الاستخدام
Query
-- In the example below the `countMatches` function expects a constant second argument.
-- This behaviour can be debugged by using the `materialize` function to turn a constant into a full column,
-- verifying that the function throws an error for a non-constant argument.

SELECT countMatches('foobarfoo', 'foo');
SELECT countMatches('foobarfoo', materialize('foo'));
Response
2
Code: 44. DB::Exception: Received from localhost:9000. DB::Exception: Illegal type of argument #2 'pattern' of function countMatches, expected constant String, got String

​
minSampleSizeContinuous

قُدِّمت في: v23.10.0 تحسب الحد الأدنى المطلوب لحجم العينة لاختبار A/B يقارن متوسطات مقياس مستمر بين عينتين. تستخدم الصيغة الموضحة في هذه المقالة. وتفترض تساوي حجمي مجموعتي المعالجة والمجموعة الضابطة. وتُرجع حجم العينة المطلوب لمجموعة واحدة (أي إن حجم العينة المطلوب للتجربة بأكملها يساوي ضعف القيمة المُرجعة). كما تفترض أيضًا تساوي تباين مقياس الاختبار في مجموعتي المعالجة والمجموعة الضابطة. الصيغة 
minSampleSizeContinuous(baseline, sigma, mde, power, alpha)
الأسماء البديلة: minSampleSizeContinous الوسيطات
  • baseline — القيمة المرجعية لمقياس. (U)Int* أو Float*
  • sigma — الانحراف المعياري المرجعي لمقياس. (U)Int* أو Float*
  • mde — الحد الأدنى للأثر القابل للاكتشاف (MDE) كنسبة مئوية من القيمة المرجعية (على سبيل المثال، إذا كانت القيمة المرجعية 112.25، فإن قيمة MDE البالغة 0.03 تعني تغيرًا متوقعًا إلى 112.25 ± 112.25*0.03). (U)Int* أو Float*
  • power — القدرة الإحصائية المطلوبة للاختبار (1 - احتمال الخطأ من النوع الثاني). (U)Int* أو Float*
  • alpha — مستوى الدلالة المطلوب للاختبار (احتمال الخطأ من النوع الأول). (U)Int* أو Float*
القيمة المُعادة تعيد Tuple مُسمّاة تحتوي على 3 عناصر: minimum_sample_size و detect_range_lower و detect_range_upper. وتمثل هذه العناصر، على الترتيب: حجم العينة المطلوب، والحد الأدنى لنطاق القيم التي لا يمكن اكتشافها باستخدام حجم العينة المطلوب المُعاد، ويُحسب على النحو baseline * (1 - mde)، والحد الأعلى لنطاق القيم التي لا يمكن اكتشافها باستخدام حجم العينة المطلوب المُعاد، ويُحسب على النحو baseline * (1 + mde) ‏(Float64). Tuple(Float64, Float64, Float64) أمثلة minSampleSizeContinuous
Query
SELECT minSampleSizeContinuous(112.25, 21.1, 0.03, 0.80, 0.05) AS sample_size
Response
(616.2931945826209,108.8825,115.6175)

​
minSampleSizeConversion

أُضيف في: v22.6.0 يحسب الحد الأدنى المطلوب لحجم العينة لاختبار A/B يقارن معدلات التحويل (النِّسب) بين عينتين. يستخدم الصيغة الموضحة في هذه المقالة. ويفترض تساوي حجمَي مجموعتي المعالجة والضبط. ويُرجع حجم العينة المطلوب لمجموعة واحدة (أي إن حجم العينة المطلوب للتجربة بأكملها يساوي ضعف القيمة المُعادة). الصيغة 
minSampleSizeConversion(baseline, mde, power, alpha)
الوسيطات
  • baseline — معدل التحويل الأساسي. Float*
  • mde — الحد الأدنى للأثر القابل للاكتشاف (MDE) بالنقاط المئوية (على سبيل المثال، إذا كان معدل التحويل الأساسي 0.25، فإن قيمة MDE البالغة 0.03 تعني تغيرًا متوقعًا إلى 0.25 ± 0.03). Float*
  • power — القدرة الإحصائية المطلوبة للاختبار (1 - احتمال خطأ من النوع الثاني). Float*
  • alpha — مستوى الدلالة المطلوب للاختبار (احتمال خطأ من النوع الأول). Float*
القيمة المعادة تعيد قيمة Tuple مُسمّاة تتكون من 3 عناصر: minimum_sample_size وdetect_range_lower وdetect_range_upper. وتمثل هذه العناصر، على الترتيب: حجم العينة المطلوب، والحد الأدنى لنطاق القيم غير القابلة للاكتشاف باستخدام حجم العينة المطلوب المُعاد، ويُحسب على أنه baseline - mde، والحد الأعلى لنطاق القيم غير القابلة للاكتشاف باستخدام حجم العينة المطلوب المُعاد، ويُحسب على أنه baseline + mde. Tuple(Float64, Float64, Float64) أمثلة minSampleSizeConversion
Query
SELECT minSampleSizeConversion(0.25, 0.03, 0.80, 0.05) AS sample_size
Response
(3396.077603219163,0.22,0.28)

​
neighbor

أُضيفت في: v20.1.0 تُرجع قيمة من عمود عند إزاحة محددة من الصف الحالي. هذه الدالة مُهملة ومعرّضة للأخطاء لأنها تعمل على الترتيب الفيزيائي لكتل البيانات، الذي قد لا يتوافق مع الترتيب المنطقي الذي يتوقعه المستخدمون. يُنصح باستخدام دوال النافذة المناسبة بدلًا من ذلك. يمكن تمكين هذه الدالة عن طريق تعيين allow_deprecated_error_prone_window_functions = 1. البنية 
neighbor(column, offset[, default_value])
المعاملات
  • column — العمود المصدر. Any
  • offset — الإزاحة من الصف الحالي. تشير القيم الموجبة إلى الأمام، وتشير القيم السالبة إلى الخلف. Integer
  • default_value — اختياري. القيمة التي تُعاد إذا تجاوزت الإزاحة حدود البيانات. إذا لم يُحدَّد، تُستخدَم القيمة الافتراضية لنوع العمود. Any
القيمة المُعادة تُعيد قيمة عند الإزاحة المحددة، أو القيمة الافتراضية إذا كانت خارج الحدود. Any أمثلة مثال على الاستخدام
Query
SELECT number, neighbor(number, 2) FROM system.numbers LIMIT 10;
Response
┌─number─┬─neighbor(number, 2)─┐
│      0 │                   2 │
│      1 │                   3 │
│      2 │                   4 │
│      3 │                   5 │
│      4 │                   6 │
│      5 │                   7 │
│      6 │                   8 │
│      7 │                   9 │
│      8 │                   0 │
│      9 │                   0 │
└────────┴─────────────────────┘
مع القيمة الافتراضية
Query
SELECT number, neighbor(number, 2, 999) FROM system.numbers LIMIT 10;
Response
┌─number─┬─neighbor(number, 2, 999)─┐
│      0 │                        2 │
│      1 │                        3 │
│      2 │                        4 │
│      3 │                        5 │
│      4 │                        6 │
│      5 │                        7 │
│      6 │                        8 │
│      7 │                        9 │
│      8 │                      999 │
│      9 │                      999 │
└────────┴──────────────────────────┘

​
normalizeQuery

أُضيفت في: v20.8.0 تستبدل القيم الحرفية، وتسلسلات القيم الحرفية، والأسماء المستعارة المعقدة (التي تحتوي على فراغات، أو أكثر من رقمين، أو يبلغ طولها 36 بايتًا على الأقل مثل UUIDs) بالرمز النائب ?. البنية 
normalizeQuery(x)
الوسيطات
  • x — تسلسل من المحارف. String
القيمة المُعادة تُعيد تسلسل المحارف المُعطى مع عناصر نائبة. String أمثلة مثال على الاستخدام
Query
SELECT normalizeQuery('[1, 2, 3, x]') AS query
Response
┌─query────┐
│ [?.., x] │
└──────────┘

​
normalizeQueryKeepNames

قُدِّمت في: v21.2.0 تستبدل القيم الحرفية وسلاسل القيم الحرفية بالعنصر النائب ?، لكنها لا تستبدل الأسماء المستعارة المعقّدة (التي تحتوي على مسافات بيضاء، أو أكثر من رقمين، أو التي يبلغ طولها 36 بايتًا على الأقل، مثل UUIDs). يساعد ذلك على تحليل سجلات الاستعلام المعقّدة بشكل أفضل. الصيغة 
normalizeQueryKeepNames(x)
الوسيطات
  • x — سلسلة من الأحرف. String
القيمة المعادة تعيد سلسلة الأحرف المحددة مع العناصر النائبة. String أمثلة مثال على الاستخدام
Query
SELECT normalizeQuery('SELECT 1 AS aComplexName123'), normalizeQueryKeepNames('SELECT 1 AS aComplexName123')
Response
┌─normalizeQuery('SELECT 1 AS aComplexName123')─┬─normalizeQueryKeepNames('SELECT 1 AS aComplexName123')─┐
│ SELECT ? AS `?`                               │ SELECT ? AS aComplexName123                            │
└───────────────────────────────────────────────┴────────────────────────────────────────────────────────┘

​
normalizedQueryHash

قُدِّمت في: v20.8.0 تعيد قيم hash متطابقة بطول 64 بت، من دون قيم القيم الحرفية، للاستعلامات المتشابهة. يمكن أن يكون ذلك مفيدًا في تحليل سجلات الاستعلامات. الصيغة 
normalizedQueryHash(x)
الوسائط
  • x — تسلسل من الأحرف. String
القيمة المُعادة يعيد قيمة تجزئة من 64 بت. UInt64 أمثلة مثال على الاستخدام
Query
SELECT normalizedQueryHash('SELECT 1 AS `xyz`') != normalizedQueryHash('SELECT 1 AS `abc`') AS res
Response
┌─res─┐
│   1 │
└─────┘

​
normalizedQueryHashKeepNames

أُضيفت في: v21.2.0 على غرار normalizedQueryHash، تُرجِع هذه الدالة قيم hash متطابقة بطول 64 بت للاستعلامات المتشابهة من دون قيم القيم الحرفية، لكنها لا تستبدل الأسماء المستعارة المعقدة (التي تحتوي على مسافات، أو أكثر من رقمين، أو التي يبلغ طولها 36 بايتًا على الأقل مثل UUIDs) بعنصر نائب قبل إجراء hash. وقد يكون ذلك مفيدًا في تحليل سجلات الاستعلامات. البنية 
normalizedQueryHashKeepNames(x)
الوسيطات
  • x — سلسلة من الأحرف. String
القيمة المعادة يعيد قيمة تجزئة بطول 64 بت. UInt64 أمثلة مثال على الاستخدام
Query
SELECT normalizedQueryHash('SELECT 1 AS `xyz123`') != normalizedQueryHash('SELECT 1 AS `abc123`') AS normalizedQueryHash;
SELECT normalizedQueryHashKeepNames('SELECT 1 AS `xyz123`') != normalizedQueryHashKeepNames('SELECT 1 AS `abc123`') AS normalizedQueryHashKeepNames;
Response
┌─normalizedQueryHash─┐
│                   0 │
└─────────────────────┘
┌─normalizedQueryHashKeepNames─┐
│                            1 │
└──────────────────────────────┘

​
obfuscateQuery

أُضيف في: v26.4.0 يُموّه استعلام SQL عبر استبدال المعرّفات بكلمات عشوائية والقيم الحرفية بقيم عشوائية، مع الحفاظ على بنية الاستعلام. تكون هذه الدالة مفيدة لإخفاء هوية الاستعلامات قبل تسجيلها أو مشاركتها لأغراض تصحيح الأخطاء. وستنتج الصفوف المختلفة نتائج تمويه مختلفة حتى مع استعلام الإدخال نفسه، مما يساعد في الحفاظ على الخصوصية عند العمل مع عدة استعلامات. تمنع المعلَمة الاختيارية tag إزالة التعبيرات الفرعية المشتركة عندما يُستخدم استدعاء الدالة نفسه عدة مرات في استعلام. ويضمن ذلك أن ينتج كل استدعاء نتيجة تمويه مختلفة. الميزات:
  • يستبدل أسماء الجداول وأسماء الأعمدة والأسماء المستعارة بكلمات عشوائية
  • يستبدل القيم الحرفية الرقمية والنصية بقيم عشوائية
  • يحافظ على البنية العامة للاستعلام وصياغة SQL
  • ينتج نتائج مختلفة لصفوف مختلفة
الصيغة 
obfuscateQuery(query[, tag])
الوسيطات
  • query — استعلام SQL المطلوب تمويهه. String
  • tag — اختياري. قيمة لمنع إزالة التعبيرات الفرعية المشتركة عند استخدام استدعاء الدالة نفسه عدة مرات.
القيمة المعادة الاستعلام المُموَّه بعد استبدال المعرّفات والقيم الحرفية مع الحفاظ على البنية الأصلية للاستعلام. String أمثلة الاستخدام الأساسي
Query
SELECT obfuscateQuery('SELECT name, age FROM users WHERE age > 30')
Response
SELECT fruit, number FROM table WHERE number > 12
باستخدام وسم لمنع إزالة التعبيرات الفرعية المشتركة
Query
SELECT obfuscateQuery('SELECT * FROM t', 1), obfuscateQuery('SELECT * FROM t', 2)
Response
SELECT a FROM b, SELECT c FROM d
تعطي الصفوف المختلفة نتائج مختلفة
Query
SELECT obfuscateQuery('SELECT 1') AS a, obfuscateQuery('SELECT 1') AS b
Response
A B

​
obfuscateQueryWithSeed

أُضيف في: v26.4.0 يُموّه استعلام SQL باستخدام قيمة seed محددة للحصول على نتائج حتمية. بخلاف obfuscateQuery(), تُنتج هذه الدالة نتائج حتمية عند تزويدها بالقيمة نفسها من seed. ويكون ذلك مفيدًا عندما تحتاج إلى تمويه متسق عبر عمليات تشغيل متعددة، أو عندما تريد إعادة إنتاج الاستعلام المُموَّه نفسه لأغراض الاختبار أو تصحيح الأخطاء. الميزات:
  • تمويه حتمي استنادًا إلى قيمة seed المقدمة
  • تؤدي قيمة seed نفسها دائمًا إلى النتيجة المُموَّهة نفسها
  • تؤدي قيم seed المختلفة إلى نتائج مختلفة
  • يحافظ على بنية الاستعلام مثل obfuscateQuery()
حالات الاستخدام:
  • حالات اختبار قابلة لإعادة الإنتاج
  • إخفاء هوية متسق عبر عمليات تشغيل متعددة
  • تصحيح الأخطاء باستخدام استعلامات مُموَّهة متسقة
الصيغة 
obfuscateQueryWithSeed(query, seed)
الوسائط
  • query — استعلام SQL المراد تمويهه. String
  • seed — قيمة البذرة للتمويه. تؤدي البذرة نفسها إلى نتائج حتمية. Integer أو String
القيمة المُعادة الاستعلام المُموَّه، ويُولَّد بصورة حتمية استنادًا إلى البذرة المُقدَّمة. String أمثلة تمويه حتمي باستخدام بذرة من نوع عدد صحيح
Query
SELECT obfuscateQueryWithSeed('SELECT name FROM users', 42)
Response
SELECT fruit FROM table
إخفاء الهوية الحتمي باستخدام seed نصي
Query
SELECT obfuscateQueryWithSeed('SELECT id, value FROM data', 'myseed')
Response
SELECT a, b FROM c
قيمة seed نفسها تعطي النتيجة نفسها
Query
SELECT obfuscateQueryWithSeed('SELECT 1', 100) = obfuscateQueryWithSeed('SELECT 1', 100)
Response
true

​
parseReadableSize

أُضيفت في: v24.6.0 إذا أُعطيت هذه الدالة سلسلة نصية تحتوي على حجم بالبايت مع وحدة مثل B أو KiB أو KB أو MiB أو MB وما إلى ذلك (أي ISO/IEC 80000-13 أو وحدة بايت عشرية)، فستُرجع عدد البايتات المقابل. إذا تعذّر على الدالة تحليل قيمة الإدخال، فإنها تُطلق استثناءً. العمليات العكسية لهذه الدالة هي formatReadableSize وformatReadableDecimalSize. البنية 
parseReadableSize(x)
الوسائط
  • x — حجم بصيغة مقروءة مع وحدة ISO/IEC 80000-13 أو وحدة بايت عشرية. String
القيمة المُعادة يعيد عدد البايتات، مُقرَّبًا للأعلى إلى أقرب عدد صحيح. UInt64 أمثلة مثال على الاستخدام
Query
SELECT arrayJoin(['1 B', '1 KiB', '3 MB', '5.314 KiB']) AS readable_sizes, parseReadableSize(readable_sizes) AS sizes;
Response
┌─readable_sizes─┬───sizes─┐
│ 1 B            │       1 │
│ 1 KiB          │    1024 │
│ 3 MB           │ 3000000 │
│ 5.314 KiB      │    5442 │
└────────────────┴─────────┘

​
parseReadableSizeOrNull

أُضيف في: v24.6.0 إذا أُعطيت هذه الدالة سلسلة نصية تتضمن حجم بايت ووحدة مثل B أو KiB أو KB أو MiB أو MB وما إلى ذلك (أي ISO/IEC 80000-13 أو وحدة بايت عشرية)، فإنها تُرجع عدد البايتات المقابل. إذا تعذّر على الدالة تحليل قيمة الإدخال، فإنها تُرجع NULL. العمليات العكسية لهذه الدالة هي formatReadableSize وformatReadableDecimalSize. الصياغة 
parseReadableSizeOrNull(x)
الوسائط
  • x — حجم بصيغة مقروءة باستخدام ISO/IEC 80000-13 أو وحدة بايت عشرية. String
القيمة المعادة يُرجع عدد البايتات، مُقرَّبًا للأعلى إلى أقرب عدد صحيح، أو NULL إذا تعذّر تحليل الإدخال Nullable(UInt64) أمثلة مثال على الاستخدام
Query
SELECT arrayJoin(['1 B', '1 KiB', '3 MB', '5.314 KiB', 'invalid']) AS readable_sizes, parseReadableSizeOrNull(readable_sizes) AS sizes;
Response
┌─readable_sizes─┬───sizes─┐
│ 1 B            │       1 │
│ 1 KiB          │    1024 │
│ 3 MB           │ 3000000 │
│ 5.314 KiB      │    5442 │
│ invalid        │    ᴺᵁᴸᴸ │
└────────────────┴─────────┘

​
parseReadableSizeOrZero

أُضيفت في: v24.6.0 إذا كانت لديك سلسلة نصية تحتوي على حجم بالبايت ووحدة مثل B أو KiB أو KB أو MiB أو MB وما إلى ذلك (أي ISO/IEC 80000-13 أو وحدة البايت العشرية)، فستُرجع هذه الدالة عدد البايتات المقابل. إذا تعذّر على الدالة تحليل قيمة الإدخال، فستُرجع 0. العمليتان العكسيتان لهذه الدالة هما formatReadableSize وformatReadableDecimalSize. الصياغة 
parseReadableSizeOrZero(x)
الوسيطات
  • x — حجم بصيغة مقروءة وفق ISO/IEC 80000-13 أو بوحدة بايت عشرية. String
القيمة المُعادة يعيد عدد البايتات، مُقرَّبًا إلى الأعلى لأقرب عدد صحيح، أو 0 إذا تعذّر تحليل المُدخل. UInt64 أمثلة مثال على الاستخدام
Query
SELECT arrayJoin(['1 B', '1 KiB', '3 MB', '5.314 KiB', 'invalid']) AS readable_sizes, parseReadableSizeOrZero(readable_sizes) AS sizes;
Response
┌─readable_sizes─┬───sizes─┐
│ 1 B            │       1 │
│ 1 KiB          │    1024 │
│ 3 MB           │ 3000000 │
│ 5.314 KiB      │    5442 │
│ invalid        │       0 │
└────────────────┴─────────┘

​
parseTimeDelta

أُضيف في: v22.7.0 يحلّل تسلسلًا من الأرقام يتبعه ما يشبه وحدة زمنية. تستخدم سلسلة الفاصل الزمني هذه مواصفات وحدات الزمن التالية:
  • years, year, yr, y
  • months, month, mo
  • weeks, week, w
  • days, day, d
  • hours, hour, hr, h
  • minutes, minute, min, m
  • seconds, second, sec, s
  • milliseconds, millisecond, millisec, ms
  • microseconds, microsecond, microsec, μs, µs, us
  • nanoseconds, nanosecond, nanosec, ns
يمكن الجمع بين عدة وحدات زمنية باستخدام الفواصل (مسافة، ;، -، +، ,، :). أطوال السنوات والأشهر تقريبية: السنة 365 يومًا، والشهر 30.5 يومًا. الصيغة 
parseTimeDelta(timestr)
الوسائط
  • timestr — سلسلة من الأرقام يتبعها ما يشبه وحدة زمنية. String
القيمة المُعادة عدد الثواني. Float64 أمثلة مثال على الاستخدام
Query
SELECT parseTimeDelta('11s+22min')
Response
┌─parseTimeDelta('11s+22min')─┐
│                        1331 │
└─────────────────────────────┘
وحدات زمنية مركّبة
Query
SELECT parseTimeDelta('1yr2mo')
Response
┌─parseTimeDelta('1yr2mo')─┐
│                 36806400 │
└──────────────────────────┘

​
partitionId

قُدِّمت في: v21.4.0 تحسب معرّف التقسيم.
هذه الدالة بطيئة، ويجب عدم استدعائها لأعداد كبيرة من الصفوف.
الصيغة 
partitionId(column1[, column2, ...])
الأسماء المستعارة: partitionID الوسيطات
  • column1, column2, ... — العمود الذي سيُعاد معرّف القسم الخاص به.
القيمة المُعادة يُعيد معرّف القسم الذي ينتمي إليه الصف. String أمثلة مثال على الاستخدام
Query
DROP TABLE IF EXISTS tab;

CREATE TABLE tab
(
  i int,
  j int
)
ENGINE = MergeTree
PARTITION BY i
ORDER BY tuple();

INSERT INTO tab VALUES (1, 1), (1, 2), (1, 3), (2, 4), (2, 5), (2, 6);

SELECT i, j, partitionId(i), _partition_id FROM tab ORDER BY i, j;
Response
┌─i─┬─j─┬─partitionId(i)─┬─_partition_id─┐
│ 1 │ 1 │ 1              │ 1             │
│ 1 │ 2 │ 1              │ 1             │
│ 1 │ 3 │ 1              │ 1             │
│ 2 │ 4 │ 2              │ 2             │
│ 2 │ 5 │ 2              │ 2             │
│ 2 │ 6 │ 2              │ 2             │
└───┴───┴────────────────┴───────────────┘

​
queryID

قُدِّمت في: v21.9.0 يُرجع معرّف الاستعلام الحالي. يمكن استخراج المعلمات الأخرى للاستعلام من الحقل query_id في الجدول system.query_log. بخلاف الدالة initialQueryID، قد تُرجع queryID نتائج مختلفة على المقاطع المختلفة. البنية 
queryID()
الأسماء المستعارة: query_id المعاملات
  • لا شيء.
القيمة المُعادة يُرجع معرّف الاستعلام الحالي. String أمثلة مثال على الاستخدام
Query
CREATE TABLE tmp (str String) ENGINE = Log;
INSERT INTO tmp (*) VALUES ('a');
SELECT count(DISTINCT t) FROM (SELECT queryID() AS t FROM remote('127.0.0.{1..3}', currentDatabase(), 'tmp') GROUP BY queryID());
Response
┌─count(DISTINCT t)─┐
│                 3 │
└───────────────────┘

​
revision

قُدِّم في: v22.7.0 يُرجع رقم مراجعة خادم ClickHouse الحالي. البنية 
revision()
الوسائط
  • لا شيء.
القيمة المُعادة يعيد رقم المراجعة الحالي لخادم ClickHouse. UInt32 أمثلة مثال على الاستخدام
Query
SELECT revision()
Response
┌─revision()─┐
│      54485 │
└────────────┘

​
rowNumberInAllBlocks

أُضيف في: v1.1.0 يعيد رقم صف فريدًا لكل صف مُعالَج. الصياغة 
rowNumberInAllBlocks()
الوسائط
  • لا شيء.
القيمة المُعادة تُرجع الرقم الترتيبي للصف في كتلة البيانات ابتداءً من 0. UInt64 أمثلة مثال على الاستخدام
Query
SELECT rowNumberInAllBlocks()
FROM
(
    SELECT *
    FROM system.numbers_mt
    LIMIT 10
)
SETTINGS max_block_size = 2
Response
┌─rowNumberInAllBlocks()─┐
│                      0 │
│                      1 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│                      4 │
│                      5 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│                      2 │
│                      3 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│                      6 │
│                      7 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│                      8 │
│                      9 │
└────────────────────────┘

​
rowNumberInBlock

أُضيف في: v1.1.0 بالنسبة إلى كل كتلة يعالجها rowNumberInBlock، تُرجِع الدالة رقم الصف الحالي. يبدأ الرقم المُعاد من 0 في كل كتلة. البنية 
rowNumberInBlock()
المعاملات
  • لا شيء.
القيمة المعادة تُرجِع الرقم الترتيبي للصف في كتلة البيانات ابتداءً من 0. UInt64 أمثلة مثال على الاستخدام
Query
SELECT rowNumberInBlock()
FROM
(
    SELECT *
    FROM system.numbers_mt
    LIMIT 10
) SETTINGS max_block_size = 2
Response
┌─rowNumberInBlock()─┐
│                  0 │
│                  1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│                  0 │
│                  1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│                  0 │
│                  1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│                  0 │
│                  1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│                  0 │
│                  1 │
└────────────────────┘

​
runningAccumulate

أُضيفت في: v1.1.0 تُراكم حالات دالة تجميع لكل صف ضمن كتلة بيانات.
مهملةيُعاد تعيين الحالة مع كل كتلة بيانات جديدة. ونظرًا إلى هذا السلوك المعرّض للأخطاء، فقد أُهمِلت هذه الدالة، ويُنصح باستخدام دوال النوافذ بدلًا منها. يمكنك استخدام الإعداد allow_deprecated_error_prone_window_functions للسماح باستخدام هذه الدالة.
البنية 
runningAccumulate(agg_state[, grouping])
الوسائط
  • agg_state — حالة الدالة التجميعية. AggregateFunction
  • grouping — اختياري. مفتاح التجميع. تُعاد تهيئة حالة الدالة إذا تغيّرت قيمة grouping. ويمكن أن يكون من أيٍّ من أنواع البيانات المدعومة التي يكون فيها عامل المساواة معرّفًا. Any
القيمة المُعادة تعيد النتيجة المتراكمة لكل صف. Any أمثلة مثال على الاستخدام مع initializeAggregation
Query
WITH initializeAggregation('sumState', number) AS one_row_sum_state
SELECT
    number,
    finalizeAggregation(one_row_sum_state) AS one_row_sum,
    runningAccumulate(one_row_sum_state) AS cumulative_sum
FROM numbers(5);
Response
┌─number─┬─one_row_sum─┬─cumulative_sum─┐
│      0 │           0 │              0 │
│      1 │           1 │              1 │
│      2 │           2 │              3 │
│      3 │           3 │              6 │
│      4 │           4 │             10 │
└────────┴─────────────┴────────────────┘

​
runningConcurrency

استُحدث في: v21.3.0 يحسب عدد الأحداث المتزامنة. لكل حدث وقت بداية ووقت نهاية. يُحتسب وقت البداية ضمن الحدث، بينما لا يُحتسب وقت النهاية. يجب أن تكون الأعمدة التي تتضمن وقت بداية ووقت نهاية من نوع البيانات نفسه. تحسب الدالة العدد الإجمالي للأحداث النشطة (المتزامنة) لكل وقت بداية حدث.
المتطلباتيجب ترتيب الأحداث حسب وقت البداية ترتيبًا تصاعديًا. إذا لم يُستوفَ هذا الشرط، فستُطلق الدالة استثناءً. تُعالَج كل كتلة بيانات على حدة. إذا تداخلت أحداث من كتل بيانات مختلفة، فلن تتم معالجتها على نحو صحيح.
مهمليُنصح باستخدام دوال النافذة بدلًا من ذلك.
البنية 
runningConcurrency(start, end)
المعاملات القيمة المعادة يعيد عدد الأحداث المتزامنة عند وقت بدء كل حدث. UInt32 أمثلة مثال على الاستخدام
Query
SELECT start, runningConcurrency(start, end) FROM example_table;
Response
┌──────start─┬─runningConcurrency(start, end)─┐
│ 2025-03-03 │                              1 │
│ 2025-03-06 │                              2 │
│ 2025-03-07 │                              3 │
│ 2025-03-11 │                              2 │
└────────────┴────────────────────────────────┘

​
runningDifference

قُدِّمت في: v1.1.0 تحسب الفرق بين قيمتَي صفّين متتاليين داخل كتلة البيانات. وتُرجِع 0 للصف الأول، أما الصفوف اللاحقة فتُرجِع الفرق مقارنةً بالصف السابق.
مهملةلا تُرجِع الفروق إلا داخل كتلة البيانات التي تُعالَج حاليًا. وبسبب هذا السلوك المعرّض للأخطاء، أُهمِلت هذه الدالة. يُنصَح باستخدام window functions بدلًا منها.يمكنك استخدام الإعداد allow_deprecated_error_prone_window_functions للسماح باستخدام هذه الدالة.
تعتمد نتيجة الدالة على كتل البيانات المعنية وترتيب البيانات داخل الكتلة. وقد يختلف ترتيب الصفوف أثناء حساب runningDifference() عن ترتيب الصفوف المُعادة إلى المستخدم. ولتجنّب ذلك، يمكنك إنشاء استعلام فرعي باستخدام ORDER BY ثم استدعاء الدالة من خارج هذا الاستعلام الفرعي. يرجى ملاحظة أن حجم الكتلة يؤثر في النتيجة. تُعاد تهيئة الحالة الداخلية للدالة runningDifference مع كل كتلة جديدة. الصياغة 
runningDifference(x)
الوسائط
  • x — العمود الذي يُحسب له الفرق التراكمي. Any
القيمة المُعادة يعيد الفرق بين كل قيمتين متتاليتين، وتكون القيمة 0 في الصف الأول. أمثلة مثال على الاستخدام
Query
SELECT
    EventID,
    EventTime,
    runningDifference(EventTime) AS delta
FROM
(
    SELECT
        EventID,
        EventTime
    FROM events
    WHERE EventDate = '2025-11-24'
    ORDER BY EventTime ASC
    LIMIT 5
);
Response
┌─EventID─┬───────────EventTime─┬─delta─┐
│    1106 │ 2025-11-24 00:00:04 │     0 │
│    1107 │ 2025-11-24 00:00:05 │     1 │
│    1108 │ 2025-11-24 00:00:05 │     0 │
│    1109 │ 2025-11-24 00:00:09 │     4 │
│    1110 │ 2025-11-24 00:00:10 │     1 │
└─────────┴─────────────────────┴───────┘
مثال على تأثير حجم الكتلة
Query
SELECT
    number,
    runningDifference(number + 1) AS diff
FROM numbers(100000)
WHERE diff != 1;
Response
┌─number─┬─diff─┐
│      0 │    0 │
└────────┴──────┘
┌─number─┬─diff─┐
│  65536 │    0 │
└────────┴──────┘

​
runningDifferenceStartingWithFirstValue

أُضيفت في: v1.1.0 تحسب الفرق بين قيم الصفوف المتتالية في كتلة بيانات، ولكن بخلاف runningDifference، فإنها تُرجع القيمة الفعلية للصف الأول بدلًا من 0.
مهملةتُرجع الفروق فقط داخل كتلة البيانات الجاري معالجتها حاليًا. ونظرًا لأن هذا السلوك قد يؤدي إلى أخطاء، فقد أُهملت هذه الدالة. يُنصح باستخدام دوال النافذة بدلًا من ذلك.يمكنك استخدام الإعداد allow_deprecated_error_prone_window_functions للسماح باستخدام هذه الدالة.
الصيغة 
runningDifferenceStartingWithFirstValue(x)
الوسائط
  • x — العمود المراد حساب الفرق التراكمي له. Any
القيمة المُعادة يعيد الفرق بين القيم المتتالية، وتكون قيمة الصف الأول هي قيمة الصف الأول نفسها. Any أمثلة مثال على الاستخدام
Query
SELECT
    number,
    runningDifferenceStartingWithFirstValue(number) AS diff
FROM numbers(5);
Response
┌─number─┬─diff─┐
│      0 │    0 │
│      1 │    1 │
│      2 │    1 │
│      3 │    1 │
│      4 │    1 │
└────────┴──────┘

​
serverUUID

أُضيف في: v20.1.0 يعيد معرّف UUID (v4) عشوائيًا وفريدًا يُولَّد عند بدء تشغيل الخادم لأول مرة. ويُحفَظ هذا المعرّف، أي إن تشغيل الخادم للمرة الثانية أو الثالثة أو ما بعدها يعيد معرّف UUID نفسه. الصيغة 
serverUUID()
الوسائط
  • لا توجد.
القيمة المُعادة يُرجع معرّف UUID عشوائيًا للخادم. UUID أمثلة مثال على الاستخدام
Query
SELECT serverUUID();
Response
┌─serverUUID()─────────────────────────────┐
│ 7ccc9260-000d-4d5c-a843-5459abaabb5f     │
└──────────────────────────────────────────┘

​
shardCount

استُحدث في: v21.9.0 يعيد العدد الإجمالي للشظايا في الاستعلام الموزع. إذا لم يكن الاستعلام موزعًا، فستُعاد القيمة الثابتة 0. البنية 
shardCount()
الوسائط
  • لا شيء.
القيمة المُعادة يُرجع العدد الإجمالي للشظايا أو 0. UInt32 أمثلة مثال على الاستخدام
Query
-- See shardNum() example above which also demonstrates shardCount()
CREATE TABLE shard_count_example (dummy UInt8)
ENGINE=Distributed(test_cluster_two_shards_localhost, system, one, dummy);
SELECT shardCount() FROM shard_count_example;
Response
┌─shardCount()─┐
│            2 │
│            2 │
└──────────────┘

​
shardNum

تم تقديمه في: v21.9.0 يعيد فهرس الشظية التي تعالج جزءًا من البيانات في استعلام موزّع. تبدأ الفهارس من 1. إذا لم يكن الاستعلام موزّعًا، فستُعاد قيمة ثابتة هي 0. البنية 
shardNum()
المعاملات
  • لا يوجد.
القيمة المُعادة تعيد فهرس الجزء أو القيمة الثابتة 0. UInt32 أمثلة مثال على الاستخدام
Query
CREATE TABLE shard_num_example (dummy UInt8)
ENGINE=Distributed(test_cluster_two_shards_localhost, system, one, dummy);
SELECT dummy, shardNum(), shardCount() FROM shard_num_example;
Response
┌─dummy─┬─shardNum()─┬─shardCount()─┐
│     0 │          1 │            2 │
│     0 │          2 │            2 │
└───────┴────────────┴──────────────┘

​
showCertificate

أُضيف في: v22.6.0 يعرض معلومات عن شهادة SSL الخاصة بالخادم الحالي إذا كانت مُهيّأة. راجع إعداد TLS لمزيد من المعلومات حول كيفية إعداد ClickHouse لاستخدام شهادات OpenSSL للتحقق من الاتصالات. الصيغة 
showCertificate()
المعاملات
  • لا شيء.
القيمة المُعادة تعيد خريطةً من أزواج المفتاح والقيمة المرتبطة بشهادة SSL المُعدّة. Map(String, String) أمثلة مثال على الاستخدام
Query
SELECT showCertificate() FORMAT LineAsString;
Response
{'version':'1','serial_number':'2D9071D64530052D48308473922C7ADAFA85D6C5','signature_algo':'sha256WithRSAEncryption','issuer':'/CN=marsnet.local CA','not_before':'May  7 17:01:21 2024 GMT','not_after':'May  7 17:01:21 2025 GMT','subject':'/CN=chnode1','pkey_algo':'rsaEncryption'}

​
sleep

قُدِّمت في: v1.1.0 توقف تنفيذ الاستعلام مؤقتًا لمدة عدد الثواني المحدد. تُستخدم هذه الدالة أساسًا لأغراض الاختبار واستكشاف الأخطاء وإصلاحها. بوجه عام، لا ينبغي استخدام الدالة sleep() في بيئات production، لأنها قد تؤثر سلبًا في أداء الاستعلام واستجابة النظام. ومع ذلك، قد تكون مفيدة في السيناريوهات التالية:
  1. الاختبار: عند اختبار ClickHouse أو إجراء benchmarking له، قد ترغب في محاكاة حالات تأخير أو إدخال توقفات مؤقتة لملاحظة كيفية تصرف النظام في ظروف معينة.
  2. استكشاف الأخطاء وإصلاحها: إذا كنت بحاجة إلى فحص حالة النظام أو تنفيذ استعلام عند نقطة زمنية محددة، فيمكنك استخدام sleep() لإدخال توقف مؤقت، مما يتيح لك فحص المعلومات ذات الصلة أو جمعها.
  3. المحاكاة: في بعض الحالات، قد ترغب في محاكاة سيناريوهات واقعية تحدث فيها حالات تأخير أو توقفات مؤقتة، مثل كمون الشبكة أو اعتماديات الأنظمة الخارجية.
من المهم استخدام الدالة sleep() بحذر وعند الضرورة فقط، لأنها قد تؤثر في الأداء العام واستجابة نظام ClickHouse لديك.
لأسباب أمنية، لا يمكن تنفيذ هذه الدالة إلا ضمن ملف تعريف المستخدم default (مع تفعيل allow_sleep). الصيغة 
sleep(seconds)
الوسائط
  • seconds — عدد الثواني المطلوب إيقاف تنفيذ الاستعلام مؤقتًا خلالها، بحد أقصى 3 ثوانٍ. ويمكن أن تكون قيمة ذات فاصلة عائمة لتحديد أجزاء من الثانية. const UInt* أو const Float*
القيمة المعادة يعيد 0. UInt8 أمثلة مثال على الاستخدام
Query
-- This query will pause for 2 seconds before completing.
-- During this time, no results will be returned, and the query will appear to be hanging or unresponsive.
SELECT sleep(2);
Response
┌─sleep(2)─┐
│        0 │
└──────────┘
1 row in set. Elapsed: 2.012 sec.

​
sleepEachRow

أُضيفت في: v1.1.0 توقف تنفيذ الاستعلام لعدد محدد من الثواني لكل صف في مجموعة النتائج. تُستخدم الدالة sleepEachRow() بشكل أساسي لأغراض الاختبار وتصحيح الأخطاء، على غرار الدالة sleep(). وتتيح لك محاكاة حالات التأخير أو إدخال توقفات مؤقتة أثناء معالجة كل صف، مما قد يكون مفيدًا في سيناريوهات مثل:
  1. الاختبار: عند اختبار أداء ClickHouse أو إجراء اختبارات قياس الأداء له في ظل ظروف محددة، يمكنك استخدام sleepEachRow() لمحاكاة حالات التأخير أو إدخال توقفات مؤقتة لكل صف تتم معالجته.
  2. تصحيح الأخطاء: إذا كنت بحاجة إلى فحص حالة النظام أو تنفيذ الاستعلام لكل صف تتم معالجته، فيمكنك استخدام sleepEachRow() لإدخال توقفات مؤقتة، مما يتيح لك فحص المعلومات ذات الصلة أو جمعها.
  3. المحاكاة: في بعض الحالات، قد ترغب في محاكاة سيناريوهات واقعية تحدث فيها حالات تأخير أو توقفات مؤقتة لكل صف تتم معالجته، مثل عند التعامل مع أنظمة خارجية أو أزمنة استجابة الشبكة.
مثل الدالة sleep()، من المهم استخدام sleepEachRow() بحذر وعند الضرورة فقط، لأنه قد يؤثر بشكل كبير في الأداء العام وسرعة استجابة نظام ClickHouse، خاصة عند التعامل مع مجموعات نتائج كبيرة.
الصياغة 
sleepEachRow(seconds)
الوسائط
  • seconds — عدد الثواني التي يُوقَف فيها تنفيذ الاستعلام مؤقتًا لكل صف في مجموعة النتائج، بحد أقصى 3 ثوانٍ. ويمكن أن تكون قيمة فاصلة عائمة لتحديد أجزاء من الثانية. const UInt* أو const Float*
القيمة المُعادة يعيد 0 لكل صف. UInt8 أمثلة مثال على الاستخدام
Query
-- The output will be delayed, with a 0.5-second pause between each row.
SELECT number, sleepEachRow(0.5) FROM system.numbers LIMIT 5;
Response
┌─number─┬─sleepEachRow(0.5)─┐
│      0 │                 0 │
│      1 │                 0 │
│      2 │                 0 │
│      3 │                 0 │
│      4 │                 0 │
└────────┴───────────────────┘

​
structureToCapnProtoSchema

أُضيفت في: v23.8.0 دالة تُحوِّل بنية جدول ClickHouse إلى مخطط schema بتنسيق CapnProto الصيغة 
structureToCapnProtoSchema(table_structure, message)
الوسائط
  • لا شيء.
القيمة المُعادة أمثلة random
Query
SELECT structureToCapnProtoSchema('s String, x UInt32', 'MessageName') format TSVRaw
Response
struct MessageName
{
    s @0 : Data;
    x @1 : UInt32;
}

​
structureToProtobufSchema

أُضيفت في: v23.8.0 تحوّل بنية جدول ClickHouse إلى مخطط بتنسيق Protobuf. تأخذ هذه الدالة تعريف بنية جدول ClickHouse وتحوله إلى تعريف مخطط Protocol Buffers ‏(Protobuf) بصياغة proto3. وهذا مفيد لإنشاء مخططات Protobuf تتوافق مع بُنى جداول ClickHouse لتبادل البيانات. الصيغة 
structureToProtobufSchema(structure, message_name)
المعاملات
  • structure — تعريف بنية جدول ClickHouse كسلسلة نصية (على سبيل المثال: ‘column1 Type1, column2 Type2’). String
  • message_name — اسم نوع رسالة Protobuf في المخطط المُنشأ. String
القيمة المُعادة يُرجع تعريفًا لمخطط Protobuf بصيغة proto3 يتوافق مع بنية ClickHouse المُدخلة. String أمثلة تحويل بنية ClickHouse إلى مخطط Protobuf
Query
SELECT structureToProtobufSchema('s String, x UInt32', 'MessageName') FORMAT TSVRaw;
Response
syntax = "proto3";

message MessageName
{
    bytes s = 1;
    uint32 x = 2;
}

​
tcpPort

أُضيفت في: v20.12.0 تعيد رقم منفذ TCP الخاص بـ الواجهة الأصلية الذي يستمع عليه الخادم. إذا نُفِّذت في سياق جدول موزّع، فستُنشئ هذه الدالة عمودًا عاديًا بقيم مرتبطة بكل جزء. وإلا، فإنها تُنتج قيمة ثابتة. الصيغة 
tcpPort()
المعاملات
  • لا توجد.
القيمة المُعادة يُرجع رقم منفذ TCP. UInt16 أمثلة مثال على الاستخدام
Query
SELECT tcpPort()
Response
┌─tcpPort()─┐
│      9000 │
└───────────┘

​
throwIf

قُدِّمت في: v1.1.0 يطرح استثناءً إذا كانت الوسيطة x تساوي true. لاستخدام الوسيطة error_code، يجب تمكين معلمة الإعداد allow_custom_error_code_in_throw. الصيغة 
throwIf(x[, message[, error_code]])
الوسيطات
  • x — الشرط المطلوب التحقق منه. Any
  • message — اختياري. رسالة خطأ مخصّصة. const String
  • error_code — اختياري. رمز خطأ مخصّص. const Int8/16/32
القيمة المُعادة يعيد 0 إذا كان الشرط false، ويُطلق استثناءً إذا كان الشرط true. UInt8 أمثلة مثال على الاستخدام
Query
SELECT throwIf(number = 3, 'Too many') FROM numbers(10);
Response
↙ Progress: 0.00 rows, 0.00 B (0.00 rows/s., 0.00 B/s.) Received exception from server (version 19.14.1):
Code: 395. DB::Exception: Received from localhost:9000. DB::Exception: Too many.

​
toColumnTypeName

أُضيف في: v1.1.0 يعيد الاسم الداخلي لنوع بيانات القيمة المحددة. وعلى خلاف الدالة toTypeName، قد يشمل نوع البيانات المُعاد أعمدة مُغلِّفة داخلية مثل Const وLowCardinality. البنية 
toColumnTypeName(value)
المعاملات
  • value — القيمة التي يُراد إرجاع نوع البيانات الداخلي الخاص بها. Any
القيمة المُعادة يُرجع نوع البيانات الداخلي المستخدم لتمثيل القيمة. String أمثلة مثال على الاستخدام
Query
SELECT toColumnTypeName(CAST('2025-01-01 01:02:03' AS DateTime));
Response
┌─toColumnTypeName(CAST('2025-01-01 01:02:03', 'DateTime'))─┐
│ Const(UInt32)                                             │
└───────────────────────────────────────────────────────────┘

​
toTypeName

قُدِّم في: v1.1.0 يعيد اسم النوع للوسيطة المُمرَّرة. إذا تم تمرير NULL، فستُعيد الدالة النوع Nullable(Nothing)، وهو ما يقابل التمثيل الداخلي للقيمة NULL في ClickHouse. البنية 
toTypeName(x)
الوسائط
  • x — قيمة من أي نوع. Any
القيمة المُعادة يُرجع اسم نوع بيانات قيمة الإدخال. String أمثلة مثال على الاستخدام
Query
SELECT toTypeName(123)
Response
┌─toTypeName(123)─┐
│ UInt8           │
└─────────────────┘

​
tokenizeQuery

استُحدث في: v26.5.0 يُجزِّئ سلسلة استعلام ClickHouse SQL إلى رموز ويُعيد مصفوفة من الرموز. كل رمز عبارة عن named tuple يتضمن موضع البداية (بالبايت)، وموضع النهاية، ونوع الرمز. البنية 
tokenizeQuery(query)
الوسائط
  • query — سلسلة استعلام في ClickHouse SQL. String.
القيمة المُعادة مصفوفة من قيم Tuple مُسمّاة (begin UInt64, end UInt64, type Enum8(...)) تمثل توكنات الاستعلام. Array(Tuple(begin UInt64, end UInt64, type Enum8(...))) أمثلة بسيط
Query
SELECT tokenizeQuery('SELECT 1')
Response
[(0,6,'BareWord'),(6,7,'Whitespace'),(7,8,'Number')]

​
transactionID

أُضيف في: v22.6.0 تُرجِع معرّف المعاملة.
هذه الدالة جزء من مجموعة ميزات تجريبية. فعِّل دعم المعاملات التجريبي بإضافة هذا الإعداد إلى التهيئة:
<clickhouse>
    <allow_experimental_transactions>1</allow_experimental_transactions>
</clickhouse>
لمزيد من المعلومات، راجع صفحة دعم المعاملات (ACID).
البنية 
transactionID()
الوسائط
  • لا شيء.
القيمة المُعادة تُرجِع قيمة من النوع Tuple تتكوّن من start_csn وlocal_tid وhost_id.
  • start_csn: رقم تسلسلي عام، وهو أحدث طابع زمني لعملية commit تمت ملاحظته عند بدء هذه المعاملة.
  • local_tid: رقم تسلسلي محلي فريد لكل معاملة يبدأها هذا المضيف ضمن start&#95;csn محدد.
  • host_id: معرّف UUID للمضيف الذي بدأ هذه المعاملة. Tuple(UInt64, UInt64, UUID)
أمثلة مثال على الاستخدام
Query
BEGIN TRANSACTION;
SELECT transactionID();
ROLLBACK;
Response
┌─transactionID()────────────────────────────────┐
│ (32,34,'0ee8b069-f2bb-4748-9eae-069c85b5252b') │
└────────────────────────────────────────────────┘

​
transactionLatestSnapshot

أُضيف في: v22.6.0 تعيد أحدث لقطة (Commit Sequence Number) لـ معاملة المتاحة للقراءة.
هذه الدالة جزء من مجموعة ميزات تجريبية. فعِّل دعم المعاملات التجريبي بإضافة هذا الإعداد إلى التهيئة:
<clickhouse>
    <allow_experimental_transactions>1</allow_experimental_transactions>
</clickhouse>
لمزيد من المعلومات، راجع صفحة دعم المعاملات (ACID).
الصياغة 
transactionLatestSnapshot()
الوسيطات
  • لا شيء.
القيمة المُعادة يُرجع أحدث لقطة (CSN) لمعاملة. UInt64 أمثلة مثال على الاستخدام
Query
BEGIN TRANSACTION;
SELECT transactionLatestSnapshot();
ROLLBACK;
Response
┌─transactionLatestSnapshot()─┐
│                          32 │
└─────────────────────────────┘

​
transactionOldestSnapshot

تم تقديمه في: v22.6.0 تُرجع أقدم لقطة (Commit Sequence Number) مرئية لإحدى المعاملات الجارية.
هذه الدالة جزء من مجموعة ميزات تجريبية. فعِّل دعم المعاملات التجريبي بإضافة هذا الإعداد إلى التهيئة الخاصة بك:
<clickhouse>
    <allow_experimental_transactions>1</allow_experimental_transactions>
</clickhouse>
لمزيد من المعلومات، راجع صفحة دعم المعاملات (ACID).
البنية 
transactionOldestSnapshot()
الوسائط
  • لا شيء.
القيمة المُعادة تُعيد أقدم لقطة (CSN) لمعاملة. UInt64 أمثلة مثال على الاستخدام
Query
BEGIN TRANSACTION;
SELECT transactionOldestSnapshot();
ROLLBACK;
Response
┌─transactionOldestSnapshot()─┐
│                          32 │
└─────────────────────────────┘

​
transform

قُدِّمت في: v1.1.0 تحوِّل قيمةً وفق تعيين مُعرَّف صراحةً لبعض العناصر إلى عناصر أخرى. لهذه الدالة صيغتان:
  • transform(x, array_from, array_to, default) - تحوِّل x باستخدام مصفوفتَي تعيين مع قيمة default للعناصر غير المتطابقة
  • transform(x, array_from, array_to) - التحويل نفسه، لكنها تعيد x الأصلي إذا لم يُعثر على أي تطابق
تبحث الدالة عن x في array_from وتعيد العنصر المقابل من array_to عند الفهرس نفسه. إذا لم يُعثر على x في array_from، فإنها تعيد إما قيمة default (في نسخة المعاملات الأربعة) أو x الأصلي (في نسخة المعاملات الثلاثة). إذا وُجدت عدة عناصر متطابقة في array_from، فإنها تعيد العنصر المقابل لأول تطابق. المتطلبات:
  • يجب أن يحتوي array_from وarray_to على العدد نفسه من العناصر
  • لنسخة المعاملات الأربعة: transform(T, Array(T), Array(U), U) -> U حيث يمكن أن يكون T وU نوعين مختلفين لكن متوافقين
  • لنسخة المعاملات الثلاثة: transform(T, Array(T), Array(T)) -> T حيث يجب أن تكون جميع الأنواع متماثلة
الصيغة 
transform(x, array_from, array_to[, default])
الوسيطات القيمة المُعادة تُعيد القيمة المناظرة من array_to إذا كانت x تطابق عنصرًا في array_from، وإلا فتُعيد default (إذا تم تحديده) أو x (إذا لم يتم تحديد default). Any أمثلة transform(T, Array(T), Array(U), U) -> U
Query
SELECT
transform(SearchEngineID, [2, 3], ['Yandex', 'Google'], 'Other') AS title,
count() AS c
FROM test.hits
WHERE SearchEngineID != 0
GROUP BY title
ORDER BY c DESC
Response
┌─title─────┬──────c─┐
│ Yandex    │ 498635 │
│ Google    │ 229872 │
│ Other     │ 104472 │
└───────────┴────────┘
transform(T, Array(T), Array(T)) -> T
Query
SELECT
transform(domain(Referer), ['yandex.ru', 'google.ru', 'vkontakte.ru'], ['www.yandex', 'example.com', 'vk.com']) AS s, count() AS c
FROM test.hits
GROUP BY domain(Referer)
ORDER BY count() DESC
LIMIT 10
Response
┌─s──────────────┬───────c─┐
│                │ 2906259 │
│ www.yandex     │  867767 │
│ ███████.ru     │  313599 │
│ mail.yandex.ru │  107147 │
│ ██████.ru      │  100355 │
│ █████████.ru   │   65040 │
│ news.yandex.ru │   64515 │
│ ██████.net     │   59141 │
│ example.com    │   57316 │
└────────────────┴─────────┘

​
uniqThetaIntersect

طُرح في: v22.9.0 يُستخدم كائنان من نوع uniqThetaSketch لإجراء عملية التقاطع (عملية المجموعات ∩)، وتكون النتيجة كائن uniqThetaSketch جديدًا. الصيغة 
uniqThetaIntersect(uniqThetaSketch,uniqThetaSketch)
الوسيطات القيمة المُعادة كائن uniqThetaSketch جديد يحتوي على ناتج التقاطع. UInt64 أمثلة مثال على الاستخدام
Query
SELECT finalizeAggregation(uniqThetaIntersect(a, b)) AS a_intersect_b, finalizeAggregation(a) AS a_cardinality, finalizeAggregation(b) AS b_cardinality
FROM
(SELECT arrayReduce('uniqThetaState', [1, 2]) AS a, arrayReduce('uniqThetaState', [2, 3, 4]) AS b);
Response
┌─a_intersect_b─┬─a_cardinality─┬─b_cardinality─┐
│             1 │             2 │             3 │
└───────────────┴───────────────┴───────────────┘

​
uniqThetaNot

قُدِّم في: v22.9.0 كائنان من نوع uniqThetaSketch لإجراء العملية الحسابية a_not_b (عملية على المجموعات ×)، وتكون النتيجة كائن uniqThetaSketch جديدًا. الصيغة 
uniqThetaNot(uniqThetaSketch,uniqThetaSketch)
الوسيطات القيمة المُعادة يعيد كائن uniqThetaSketch جديدًا يحتوي على نتيجة a_not_b. UInt64 أمثلة مثال للاستخدام
Query
SELECT finalizeAggregation(uniqThetaNot(a, b)) AS a_not_b, finalizeAggregation(a) AS a_cardinality, finalizeAggregation(b) AS b_cardinality
FROM
(SELECT arrayReduce('uniqThetaState', [2, 3, 4]) AS a, arrayReduce('uniqThetaState', [1, 2]) AS b);
Response
┌─a_not_b─┬─a_cardinality─┬─b_cardinality─┐
│       2 │             3 │             2 │
└─────────┴───────────────┴───────────────┘

​
uniqThetaUnion

أُضيف في: v22.9.0 كائنان من نوع uniqThetaSketch لإجراء عملية الاتحاد (عملية مجموعات ∪)، وتكون النتيجة uniqThetaSketch جديدًا. الصيغة 
uniqThetaUnion(uniqThetaSketch,uniqThetaSketch)
الوسيطات القيمة المعادة يُرجع كائن uniqThetaSketch جديدًا يحتوي على نتيجة الاتحاد. UInt64 أمثلة مثال على الاستخدام
Query
SELECT finalizeAggregation(uniqThetaUnion(a, b)) AS a_union_b, finalizeAggregation(a) AS a_cardinality, finalizeAggregation(b) AS b_cardinality
FROM
(SELECT arrayReduce('uniqThetaState', [1, 2]) AS a, arrayReduce('uniqThetaState', [2, 3, 4]) AS b);
Response
┌─a_union_b─┬─a_cardinality─┬─b_cardinality─┐
│         4 │             2 │             3 │
└───────────┴───────────────┴───────────────┘

​
مدة التشغيل

أُضيف في: v1.1.0 يعيد مدة تشغيل الخادم بالثواني. إذا نُفِّذت هذه الدالة في سياق جدول موزّع، فإنها تُنشئ عمودًا عاديًا بقيم مرتبطة بكل جزء. أما خلاف ذلك، فتنتج قيمة ثابتة. الصيغة 
uptime()
الوسائط
  • لا يوجد.
القيمة المُعادة يُرجع مدة تشغيل الخادم بالثواني. UInt32 أمثلة مثال على الاستخدام
Query
SELECT uptime() AS Uptime
Response
┌─Uptime─┐
│  55867 │
└────────┘

​
variantElement

أُضيفت في: v25.2.0 تستخرج عمودًا من النوع المحدد من عمود Variant. البنية 
variantElement(variant, type_name[, default_value])
المعاملات
  • variant — عمود Variant. Variant
  • type_name — اسم نوع Variant المراد استخراجه. String
  • default_value — القيمة الافتراضية التي ستُستخدم إذا لم يتضمّن variant نوع Variant المحدد. يمكن أن تكون من أي نوع. اختياري. Any
القيمة المُعادة يعيد عمودًا يحتوي على نوع Variant المحدد بعد استخراجه من عمود Variant. Any أمثلة مثال على الاستخدام
Query
CREATE TABLE test (v Variant(UInt64, String, Array(UInt64))) ENGINE = Memory;
INSERT INTO test VALUES (NULL), (42), ('Hello, World!'), ([1, 2, 3]);
SELECT v, variantElement(v, 'String'), variantElement(v, 'UInt64'), variantElement(v, 'Array(UInt64)') FROM test;
Response
┌─v─────────────┬─variantElement(v, 'String')─┬─variantElement(v, 'UInt64')─┬─variantElement(v, 'Array(UInt64)')─┐
│ ᴺᵁᴸᴸ          │ ᴺᵁᴸᴸ                        │                        ᴺᵁᴸᴸ │ []                                 │
│ 42            │ ᴺᵁᴸᴸ                        │                          42 │ []                                 │
│ Hello, World! │ Hello, World!               │                        ᴺᵁᴸᴸ │ []                                 │
│ [1,2,3]       │ ᴺᵁᴸᴸ                        │                        ᴺᵁᴸᴸ │ [1,2,3]                            │
└───────────────┴─────────────────────────────┴─────────────────────────────┴────────────────────────────────────┘

​
variantType

قُدِّم في: v24.2.0 يعيد اسم النوع المتغيّر لكل صف في عمود Variant. وإذا احتوى الصف على NULL، فستُعاد له القيمة ‘None’. الصيغة 
variantType(variant)
الوسائط
  • variant — عمود Variant. Variant
القيمة المُعادة يُرجع عمودًا من نوع Enum يحتوي على اسم نوع Variant لكل صف. Enum أمثلة مثال على الاستخدام
Query
CREATE TABLE test (v Variant(UInt64, String, Array(UInt64))) ENGINE = Memory;
INSERT INTO test VALUES (NULL), (42), ('Hello, World!'), ([1, 2, 3]);
SELECT variantType(v) FROM test;
Response
┌─variantType(v)─┐
│ None           │
│ UInt64         │
│ String         │
│ Array(UInt64)  │
└────────────────┘

​
version

أُضيف في الإصدار: v1.1.0 تعيد الإصدار الحالي من ClickHouse كسلسلة نصية بالصيغة: major_version.minor_version.patch_version.number_of_commits_since_the_previous_stable_release. إذا نُفِّذت في سياق جدول موزّع، فستُنشئ هذه الدالة عمودًا عاديًا بقيم خاصة بكل جزء. وبخلاف ذلك، فإنها تُنتج قيمة ثابتة. الصياغة 
version()
المعاملات
  • لا شيء.
القيمة المُعادة يُرجع الإصدار الحالي من ClickHouse. String أمثلة مثال للاستخدام
Query
SELECT version()
Response
┌─version()─┐
│ 24.2.1.1  │
└───────────┘

​
visibleWidth

ظهر لأول مرة في: v1.1.0 يحسب العرض التقريبي عند إخراج القيم إلى الطرفية بتنسيق نصي (مفصول بعلامات الجدولة). تُستخدم هذه الدالة من قِبل النظام لتنفيذ تنسيقات Pretty. تُمثَّل NULL كسلسلة نصية تقابل NULL في تنسيقات Pretty. الصيغة 
visibleWidth(x)
الوسائط
  • x — قيمة من أي نوع بيانات. Any
القيمة المُعادة يعيد العرض التقريبي للقيمة عند عرضها بتنسيق نصي. UInt64 أمثلة حساب العرض المرئي لـ NULL
Query
SELECT visibleWidth(NULL)
Response
┌─visibleWidth(NULL)─┐
│                  4 │
└────────────────────┘

​
zookeeperSessionUptime

أُضيف في: v21.11.0 تعيد مدة تشغيل جلسة ZooKeeper الحالية بالثواني. البنية 
zookeeperSessionUptime()
الوسيطات
  • لا شيء.
القيمة المُعادة تُرجع مدة تشغيل جلسة ZooKeeper الحالية بالثواني. UInt32 أمثلة مثال على الاستخدام
Query
SELECT zookeeperSessionUptime();
Response
┌─zookeeperSessionUptime()─┐
│                      286 │
└──────────────────────────┘
آخر تعديل في ٢٥ يونيو ٢٠٢٦