Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

الدوال الرياضية

acos

أُضيف في: v1.1.0

تُرجِع دالة جيب التمام العكسي للوسيطة.

صيغة

acos(x)

وسيطة

  • x — القيمة المراد إيجاد جيب التمام العكسي لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تعيد جيب التمام العكسي لـ x من النوع Float*

أمثلة

مثال للاستخدام

SELECT acos(0.5);
1.0471975511965974

acosh

أُضيف في: v20.12.0

يعيد جيب التمام الزائدي العكسي.

البنية

acosh(x)

الوسيطات

  • x — جيب تمام الزاوية الزائدي. القيم ضمن المجال: 1 ≤ x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع الزاوية بالراديان. القيم ضمن المجال: 0 ≤ acosh(x) < +∞. Float64

أمثلة

مثال على الاستخدام

SELECT acosh(1)
0

asin

أُضيف في: v1.1.0

تحسب دالة الجيب العكسي للوسيطة المقدَّمة. وبالنسبة إلى الوسائط ضمن النطاق [-1, 1]، فإنها تُرجِع قيمة ضمن النطاق [-pi() / 2, pi() / 2].

صيغة

asin(x)

وسيطة

  • x — الوسيطة المراد حساب قوس الجيب لها. (U)Int* أو Float* أو Decimal

القيمة المُعادة

تعيد قيمة قوس الجيب للوسيطة المقدَّمة x من النوع Float64

أمثلة

المعكوس

SELECT asin(1.0) = pi() / 2, sin(asin(1)), asin(sin(1))
1	1	0.9999999999999999

float32

SELECT toTypeName(asin(1.0::Float32))
Float64

nan

SELECT asin(1.1), asin(-2), asin(inf), asin(nan)
nan	nan	nan	nan

asinh

قُدِّم في: v20.12.0

تُرجع الجيب الزائدي العكسي.

الصيغة

asinh(x)

الوسائط

  • x — الجيب الزائدي العكسي للزاوية. القيم من المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المعادة

يعيد الزاوية بوحدة الراديان. القيم من المجال: -∞ < asinh(x) < +∞. Float64

أمثلة

الاستخدام الأساسي

SELECT asinh(0)
0

atan

تم تقديمه في: v1.1.0

يُرجع الظل العكسي للوسيطة.

الصياغة

atan(x)

المعاملات

  • x — القيمة المراد إيجاد الظل العكسي لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

الظل العكسي لـ x. Float*

أمثلة

مثال على الاستخدام

SELECT atan(1);
0.7853981633974483

atan2

أُضيفت في: v20.12.0

تعيد الدالة atan2 الزاوية في المستوى الإقليدي، مقاسةً بالراديان، بين المحور السيني الموجب والشعاع الواصل إلى النقطة (x, y) ≠ (0, 0).

الصيغة

atan2(y, x)

الوسائط

القيمة المُعادة

تُرجع الزاوية θ بحيث تكون -π < θ ≤ π، بوحدة الراديان Float64

أمثلة

مثال للاستخدام

SELECT atan2(1, 1)
0.7853981633974483

atanh

أُضيفت في: v20.12.0

تعيد الظل الزائدي العكسي.

الصيغة

atanh(x)

الوسيطات

  • x — الظل الزائدي للزاوية. القيم ضمن المجال: -1 < x < 1. (U)Int* أو Float* أو Decimal*. (U)Int* أو Float* أو Decimal*

القيمة المعادة

تُرجع الزاوية بالراديان. القيم ضمن المجال: -∞ < atanh(x) < +∞ Float64

أمثلة

مثال على الاستخدام

SELECT atanh(0)
0

cbrt

أُضيفت في: v1.1.0

تُرجِع الجذر التكعيبي للوسيط.

الصيغة

cbrt(x)

المعاملات

  • x — القيمة المطلوب إيجاد الجذر التكعيبي لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع الجذر التكعيبي لـ x. Float*

أمثلة

مثال للاستخدام

SELECT cbrt(8);
2

cos

أُضيفت في: v1.1.0

يُرجع جيب تمام الوسيطة.

الصيغة

cos(x)

المعاملات

القيمة المُعادة

تُرجِع جيب تمام x. Float*

أمثلة

مثال على الاستخدام

SELECT cos(0);
1

cosh

أُضيفت في: v20.12.0

تعيد جيب التمام الزائدي للوسيطة.

الصيغة

cosh(x)

الوسيطات

  • x — الزاوية، مقاسة بالراديان. القيم ضمن المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع قيماً ضمن المجال: 1 ≤ cosh(x) < +∞ Float64

أمثلة

الاستخدام الأساسي

SELECT cosh(0)
1

degrees

أُدرجت في: v22.2.0

تحوّل القيم من الراديان إلى درجات.

الصياغة

degrees(x)

المعاملات

القيمة المُعادة

تُرجِع قيمة x بالدرجات. Float64

أمثلة

الاستخدام الأساسي

SELECT degrees(3.141592653589793)
180

e

استُحدث في: v1.1.0

يُرجع ثابت أويلر (e).

البنية

e()

المعاملات

  • لا شيء.

القيمة المُعادة

يُرجع ثابت أويلر Float64

أمثلة

مثال على الاستخدام

SELECT e();
2.718281828459045

erf

تم تقديمه في: v1.1.0

إذا كانت x غير سالبة، فإن erf(x/(σ√2)) تمثل احتمال أن يأخذ متغير عشوائي ذو توزيع طبيعي وانحراف معياري σ قيمةً تبعد عن القيمة المتوقعة بأكثر من x.

الصيغة

erf(x)

الوسيطات

  • x — القيمة المراد حساب قيمة دالة الخطأ لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع قيمة دالة الخطأ من النوع Float*

أمثلة

قاعدة الثلاث سيغما

SELECT erf(3 / sqrt(2))
┌─erf(divide(3, sqrt(2)))─┐
│      0.9973002039367398 │
└─────────────────────────┘

erfc

استُحدثت في: v1.1.0

تعيد عددًا قريبًا من 1-erf(x) من دون فقدان الدقة عند القيم الكبيرة لـ x.

الصيغة

erfc(x)

الوسائط

  • x — القيمة المطلوب إيجاد قيمة دالة الخطأ لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع قيمة دالة الخطأ التكميلية Float*

أمثلة

مثال على الاستخدام

SELECT erfc(0);
1

exp

أُضيفت في: v1.1.0

تعيد قيمة e مرفوعةً إلى الأس x، حيث إن x هو الوسيط المُمرَّر إلى الدالة.

الصياغة

exp(x)

الوسيطات

القيمة المُعادة

تُرجع e^x من النوع Float*

أمثلة

الاستخدام الأساسي

SELECT round(exp(-1), 4)
┌─round(exp(-1), 4)─┐
│            0.3679 │
└───────────────────┘

exp10

ظهر لأول مرة في: v1.1.0

يُرجع 10 مرفوعًا إلى أسّ الوسيطة المُعطاة.

الصيغة

exp10(x)

الوسائط

القيمة المعادة

يعيد القيمة 10^x من النوع Float*

أمثلة

مثال على الاستخدام

SELECT exp10(2);
100

exp2

أُضيفت في: v1.1.0

تُرجِع 2 مرفوعًا إلى أسّ المُعامِل المُعطى.

الصيغة

exp2(x)

الوسائط

القيمة المعادة

ترجع 2^x من النوع Float*

أمثلة

مثال على الاستخدام

SELECT exp2(3);
8

المضروب

أُضيف في: v22.11.0

يحسب مضروب قيمة عدد صحيح. مضروب العدد 0 هو 1. وبالمثل، تُرجِع الدالة factorial() القيمة 1 لأي قيمة سالبة. الحد الأقصى للقيمة الموجبة لوسيطة الإدخال هو 20، وأي قيمة 21 أو أكبر ستتسبب في استثناء.

صيغة

factorial(n)

وسيطة

  • n — قيمة عدد صحيح يُراد حساب مضروبه. الحد الأقصى للقيمة هو 20. (U)Int8/16/32/64

القيمة المُعادة

يُرجع مضروب قيمة الإدخال من النوع UInt64. ويُرجع 1 إذا كانت قيمة الإدخال 0 أو أي قيمة سالبة. UInt64

أمثلة

مثال على الاستخدام

SELECT factorial(10)
3628800

hypot

أُضيفت في: v20.12.0

تُرجِع طول وتر مثلث قائم الزاوية. تتجنب الدالة Hypot المشكلات التي قد تحدث عند تربيع أعداد كبيرة جدًا أو صغيرة جدًا.

الصيغة

hypot(x, y)

الوسائط

القيمة المُعادة

تعيد طول الوتر في مثلث قائم الزاوية. Float64

أمثلة

الاستخدام الأساسي

SELECT hypot(1, 1)
1.4142135623730951

intExp10

أُضيفت في: v1.1.0

مماثلة لـ exp10، لكنها تُرجِع قيمة من النوع UInt64.

البنية

intExp10(x)

الوسائط

القيمة المُعادة

يعيد 10^x. UInt64

أمثلة

مثال على الاستخدام

SELECT intExp10(2);
100

intExp2

أُضيف في: v1.1.0

يشبه exp2، لكنه يُرجع قيمة من النوع UInt64.

الصيغة

intExp2(x)

الوسائط

القيمة المُعادة

يُرجع 2^x. UInt64

أمثلة

مثال على الاستخدام

SELECT intExp2(3);
8

isPrime

أُضيف في: v26.5.0

يعيد 1 إذا كان المُعامل عددًا أوليًا، وإلا فيعيد 0.

يستخدم bitmap بحثٍ دقيق للقيم الصغيرة واختبار Miller-Rabin حتميًا للقيم الأكبر. تكون النتيجة دقيقة مع كل نوع إدخال مدعوم.

بالنسبة إلى أنواع الأعداد الصحيحة غير الموقعة الأوسع (UInt128, UInt256)، استخدم isProbablePrime بدلًا من ذلك.

الصياغة

isPrime(n)

الوسائط

  • n — عدد صحيح غير موقّع لاختبار ما إذا كان عددًا أوليًا. UInt8 أو UInt16 أو UInt32 أو UInt64

القيمة المُعادة

يعيد 1 إذا كان n عددًا أوليًا، و0 خلاف ذلك. UInt8

أمثلة

عدد أولي

SELECT isPrime(17)
1

عدد مركب

SELECT isPrime(18)
0

عدد أولي كبير من النوع UInt64

SELECT isPrime(18446744073709551557)
1

القيمة القصوى لـ UInt64

SELECT isPrime(18446744073709551615)
0

isProbablePrime

أُضيف في: v26.5.0

تعيد 1 إذا كانت الوسيطة على الأرجح عددًا أوليًا، و0 إذا كان عددًا مركبًا على نحوٍ مؤكد.

بالنسبة إلى UInt8 وUInt16 وUInt32 وUInt64، تكون النتيجة دقيقة وتتطابق مع isPrime. ويتم تجاهل وسيطة rounds.

بالنسبة إلى UInt128 وUInt256، تكون القيمة المعادة 1 احتمالية. وتتحكم وسيطة rounds الاختيارية في عدد جولات Miller-Rabin المستخدمة: فكلما زاد عدد الجولات، انخفض احتمال الإيجابيات الكاذبة وازداد وقت التنفيذ. ومع شواهد عشوائية موزعة بانتظام، يكون معدل الإيجابيات الكاذبة لعدد مركب ثابت محدودًا بـ 4^(-rounds)؛ وتُبقي القيمة الافتراضية 25 هذا الحد دون 10^-15، بينما تُبقيه القيمة القصوى 256 دون 10^-154.

الدالة حتمية: إذ تُشتق الشواهد من n، لذا فإن الزوج نفسه (n, rounds) ينتج دائمًا النتيجة نفسها. ويمثل الحد 4^(-rounds) احتمالًا لكل مُدخل عند استخدام شواهد عشوائية موزعة بانتظام؛ أما مع الاشتقاق الحتمي الذي نعتمده، فهو يصف بدلًا من ذلك نسبةً عبر المُدخلات — فالعدد المركب الذي يخدع تسلسل شواهده سيُرجع 1 بصورة قابلة للتكرار.

الصيغة

isProbablePrime(n[, rounds])

المعاملات

  • n — عدد صحيح غير موقّع لاختبار ما إذا كان أوليًا. UInt8 أو UInt16 أو UInt32 أو UInt64 أو UInt128 أو UInt256
  • rounds — ثابت اختياري لعدد صحيح موجب ضمن [1, 256]. عدد جولات Miller-Rabin لـ UInt128/UInt256 (ويُتجاهل للأنواع الأضيق). القيمة الافتراضية 25. UInt8 أو UInt16 أو UInt32 أو UInt64

القيمة المُعادة

تُعيد 1 إذا كان n على الأرجح عددًا أوليًا، و0 إذا كان عددًا مركبًا بالتأكيد. UInt8

أمثلة

عدد أولي صغير

SELECT isProbablePrime(17)
1

مركّب صغير

SELECT isProbablePrime(18)
0

أكبر عدد أولي من النوع UInt64 (نتيجة دقيقة)

SELECT isProbablePrime(18446744073709551557)
1

عدد ميرسين الأولي M_127 (UInt128)

SELECT isProbablePrime(toUInt128('170141183460469231731687303715884105727'))
1

العدد الأولي للحقل الأساسي لـ Curve25519 2^255 - 19 (UInt256)

SELECT isProbablePrime(toUInt256('57896044618658097711785492504343953926634992332820282019728792003956564819949'))
1

اختبار أسرع بثقة أقل: 5 جولات

SELECT isProbablePrime(toUInt256('57896044618658097711785492504343953926634992332820282019728792003956564819949'), 5)
1

lgamma

قُدِّمت في: v1.1.0

تعيد لوغاريتم دالة غاما.

الصيغة

lgamma(x)

الوسائط

  • x — العدد المراد حساب لوغاريتم دالة غاما له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع لوغاريتم دالة غاما لـ x. Float*

أمثلة

مثال للاستخدام

SELECT lgamma(5);
3.1780538303479458

log

قُدِّم في: v1.1.0

يعيد اللوغاريتم الطبيعي لوسيطة الدالة.

الصيغة

log(x)

الأسماء المستعارة: ln

وسيطات الدالة

  • x — العدد المراد حساب اللوغاريتم الطبيعي له. (U)Int* أو Float* أو Decimal*

القيمة المعادة

تعيد اللوغاريتم الطبيعي لـ x. Float*

أمثلة

مثال على الاستخدام

SELECT log(10);
2.3025850938475476

log10

قُدِّم في: v1.1.0

يعيد اللوغاريتم العشري للوسيطة.

الصياغة

log10(x)

الوسائط

  • x — العدد المراد حساب اللوغاريتم العشري له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

اللوغاريتم العشري للعدد x. Float*

أمثلة

مثال على الاستخدام

SELECT log10(100);
2

log1p

استُحدثت في: v20.12.0

تحسب log(1+x). تكون عملية الحساب log1p(x) أدق من log(1+x) عند القيم الصغيرة لـ x.

الصيغة

log1p(x)

المعاملات

القيمة المرجعة

يعيد قيمة ضمن النطاق: -∞ < log1p(x) < +∞ Float64

أمثلة

مثال على الاستخدام

SELECT log1p(0)
0

log2

قُدِّم في: v1.1.0

يعيد اللوغاريتم الثنائي للوسيطة.

البنية

log2(x)

الوسائط

  • x — العدد المراد حساب اللوغاريتم الثنائي له. (U)Int* أو Float* أو Decimal*

القيمة المعادة

يُرجع اللوغاريتم الثنائي لـ x. Float*

أمثلة

مثال على الاستخدام

SELECT log2(8);
3

pi

تم تقديمها في: v1.1.0

تعيد pi‏ (π).

الصيغة

pi()

المعاملات

  • لا شيء.

القيمة المُعادة

تعيد القيمة pi Float64

أمثلة

مثال على الاستخدام

SELECT pi();
3.141592653589793

pow

أُضيف في: v1.1.0

يُرجع x مرفوعًا للأس y.

الصيغة

pow(x, y)

الأسماء المستعارة: power

الوسيطات

القيمة المعادة

ترجع x^y من النوع Float64

أمثلة

مثال على الاستخدام

SELECT pow(2, 3);
8

proportionsZTest

أُضيفت في: v22.3.0

تعيد إحصاءات اختبار Z لنسبتين، وهو اختبار إحصائي لمقارنة النِّسَب بين مجتمعين إحصائيين x و y. تدعم الدالة طريقتَي التقدير المجمّع وغير المجمّع للخطأ المعياري. في الطريقة المجمّعة، يُؤخذ متوسط النسبتين وتُستخدم نسبة واحدة فقط لتقدير الخطأ المعياري. أما في الطريقة غير المجمّعة، فتُستخدم النسبتان كلٌّ على حدة.

البنية

proportionsZTest(successes_x, successes_y, trials_x, trials_y, conf_level, pool_type)

الوسائط

  • successes_x — عدد النجاحات في المجموعة x. UInt64
  • successes_y — عدد النجاحات في المجموعة y. UInt64
  • trials_x — عدد التجارب في المجموعة x. UInt64
  • trials_y — عدد التجارب في المجموعة y. UInt64
  • conf_level — مستوى الثقة للاختبار. Float64
  • pool_type — اختيار طريقة التجميع لتقدير الخطأ المعياري. يمكن أن تكون إما 'unpooled' أو 'pooled'. String

القيمة المعادة

يعيد Tuple يحتوي على: z_stat (إحصائية Z)، وp_val (قيمة P)، وci_low (الحد الأدنى لفاصل الثقة)، وci_high (الحد الأعلى لفاصل الثقة). Tuple(Float64, Float64, Float64, Float64)

أمثلة

مثال على الاستخدام

SELECT proportionsZTest(10, 11, 100, 101, 0.95, 'unpooled');
┌─proportionsZTest(10, 11, 100, 101, 0.95, 'unpooled')───────────────────────────────┐
│ (-0.20656724435948853,0.8363478437079654,-0.09345975390115283,0.07563797172293502) │
└────────────────────────────────────────────────────────────────────────────────────┘

radians

أُضيفت في: v22.2.0

يحوّل الدرجات إلى راديانات.

البنية

radians(x)

المعاملات

القيمة المُعادة

تُرجِع قيمةً بالراديان Float64

أمثلة

مثال على الاستخدام

SELECT radians(180)
3.141592653589793

sigmoid

استُحدثت في: v20.1.0

تحسب دالة sigmoid: 1 / (1 + exp(-x)). تحوِّل دالة sigmoid أي عدد حقيقي إلى الفترة (0, 1)، وتُستخدم عادةً في تعلّم الآلة.

الصيغة

sigmoid(x)

الوسائط

القيمة المُعادة

يعيد دالة السيغمويد لقيمة الإدخال، ضمن النطاق (0, 1). Float64

أمثلة

الاستخدام الأساسي

SELECT sigmoid(0)
0.5

sign

أُضيف في: v21.2.0

يعيد إشارة عددٍ حقيقي.

الصياغة

sign(x)

الوسيطات

القيمة المُعادة

تُرجِع -1 إذا كان x < 0، و0 إذا كان x = 0، و1 إذا كان x > 0. Int8

أمثلة

إشارة الصفر

SELECT sign(0)
0

علامة الموجب

SELECT sign(1)
1

علامة السالب

SELECT sign(-1)
-1

sin

أُضيف في: v1.1.0

تُرجِع جيبَ الوسيطة.

البنية

sin(x)

المعاملات

القيمة المُعادة

يُرجع جيب x.

أمثلة

بسيط

SELECT sin(1.23)
0.9424888019316975

sinh

أُضيف في: v20.12.0

يعيد الجيب الزائدي.

الصيغة

sinh(x)

الوسيطات

  • x — الزاوية، بوحدة الراديان. تقع القيم ضمن المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تعيد قيماً تقع ضمن المجال: -∞ < sinh(x) < +∞ Float64

أمثلة

مثال على الاستخدام

SELECT sinh(0)
0

sqrt

أُضيفت في: v1.1.0

تُرجِع الجذر التربيعي للوسيطة.

الصياغة

sqrt(x)

المعاملات

  • x — العدد المراد إيجاد الجذر التربيعي له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يعيد الجذر التربيعي لـ x Float*

أمثلة

مثال على الاستخدام

SELECT sqrt(16);
4

tan

تم تقديمه في: v1.1.0

يُرجع ظلّ الوسيطة.

البنية

tan(x)

الوسائط

القيمة المُعادة

يُرجع ظل x. Float*

أمثلة

مثال على الاستخدام

SELECT tan(0);
0

tanh

أُضيف في: v20.1.0

تُرجع قيمة الظل الزائدي.

الصياغة

tanh(x)

الوسائط

  • x — الزاوية بوحدة الراديان. قيم ضمن المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجِع قيماً ضمن المجال: -1 < tanh(x) < 1 Float*

أمثلة

مثال للاستخدام

SELECT tanh(0)
0

tgamma

أُضيفت في: v1.1.0

تعيد دالة غاما.

بنية الجملة

tgamma(x)

الوسائط

القيمة المُعادة

تعيد قيمة دالة غاما من النوع Float*

أمثلة

مثال على الاستخدام

SELECT tgamma(5);
24

widthBucket

أُضيف في: v23.3.0

يعيد رقم الفئة التي تقع فيها المعلمة operand ضمن مُدرَّج تكراري يحتوي على count فئات متساوية العرض تمتد عبر النطاق من low إلى high. ويعيد 0 إذا كانت operand أقل من low، ويعيد count+1 إذا كانت operand أكبر من high أو تساويه. يوجد أيضًا اسم مستعار غير حساس لحالة الأحرف باسم WIDTH_BUCKET لتوفير التوافق مع قواعد البيانات الأخرى.

الصيغة

widthBucket(operand, low, high, count)

الأسماء المستعارة: width_bucket

وسيطات الدالة

  • operand — القيمة المطلوب تحديد الفئة التي تقع ضمنها. (U)Int8/16/32/64
  • low — الحد الأدنى لنطاق المُدرَّج التكراري. (U)Int8/16/32/64
  • high — الحد الأعلى لنطاق المُدرَّج التكراري. (U)Int8/16/32/64
  • count — عدد الفئات متساوية العرض. لا يمكن أن تكون قيمته صفراً. UInt8/16/32/64

القيمة المُعادة

تُعيد رقم الفئة كعدد صحيح. وتُعيد 0 إذا كانت operand < low، وتُعيد count+1 إذا كانت operand >= high. UInt8/16/32/64

أمثلة

مثال على الاستخدام

SELECT widthBucket(10.15, -8.6, 23, 18)
11
Navigation