acos
أُضيف في: v1.1.0
تُرجِع دالة جيب التمام العكسي للوسيطة.
صيغة
acos(x)وسيطة
القيمة المُعادة
تعيد جيب التمام العكسي لـ x من النوع Float*
أمثلة
مثال للاستخدام
SELECT acos(0.5);1.0471975511965974acosh
أُضيف في: v20.12.0
يعيد جيب التمام الزائدي العكسي.
البنية
acosh(x)الوسيطات
القيمة المُعادة
يُرجع الزاوية بالراديان. القيم ضمن المجال: 0 ≤ acosh(x) < +∞. Float64
أمثلة
مثال على الاستخدام
SELECT acosh(1)0asin
أُضيف في: v1.1.0
تحسب دالة الجيب العكسي للوسيطة المقدَّمة.
وبالنسبة إلى الوسائط ضمن النطاق [-1, 1]، فإنها تُرجِع قيمة ضمن النطاق [-pi() / 2, pi() / 2].
صيغة
asin(x)وسيطة
القيمة المُعادة
تعيد قيمة قوس الجيب للوسيطة المقدَّمة x من النوع Float64
أمثلة
المعكوس
SELECT asin(1.0) = pi() / 2, sin(asin(1)), asin(sin(1))1 1 0.9999999999999999float32
SELECT toTypeName(asin(1.0::Float32))Float64nan
SELECT asin(1.1), asin(-2), asin(inf), asin(nan)nan nan nan nanasinh
قُدِّم في: v20.12.0
تُرجع الجيب الزائدي العكسي.
الصيغة
asinh(x)الوسائط
القيمة المعادة
يعيد الزاوية بوحدة الراديان. القيم من المجال: -∞ < asinh(x) < +∞. Float64
أمثلة
الاستخدام الأساسي
SELECT asinh(0)0atan
تم تقديمه في: v1.1.0
يُرجع الظل العكسي للوسيطة.
الصياغة
atan(x)المعاملات
القيمة المُعادة
الظل العكسي لـ x. Float*
أمثلة
مثال على الاستخدام
SELECT atan(1);0.7853981633974483atan2
أُضيفت في: v20.12.0
تعيد الدالة atan2 الزاوية في المستوى الإقليدي، مقاسةً بالراديان، بين المحور السيني الموجب والشعاع الواصل إلى النقطة (x, y) ≠ (0, 0).
الصيغة
atan2(y, x)الوسائط
y— الإحداثيyللنقطة التي يمرّ عبرها الشعاع.(U)Int*أوFloat*أوBFloat16أوDecimal*x— الإحداثيxللنقطة التي يمرّ عبرها الشعاع.(U)Int*أوFloat*أوBFloat16أوDecimal*
القيمة المُعادة
تُرجع الزاوية θ بحيث تكون -π < θ ≤ π، بوحدة الراديان Float64
أمثلة
مثال للاستخدام
SELECT atan2(1, 1)0.7853981633974483atanh
أُضيفت في: v20.12.0
تعيد الظل الزائدي العكسي.
الصيغة
atanh(x)الوسيطات
x— الظل الزائدي للزاوية. القيم ضمن المجال: -1 < x < 1.(U)Int*أوFloat*أوDecimal*.(U)Int*أوFloat*أوDecimal*
القيمة المعادة
تُرجع الزاوية بالراديان. القيم ضمن المجال: -∞ < atanh(x) < +∞ Float64
أمثلة
مثال على الاستخدام
SELECT atanh(0)0cbrt
أُضيفت في: v1.1.0
تُرجِع الجذر التكعيبي للوسيط.
الصيغة
cbrt(x)المعاملات
القيمة المُعادة
يُرجع الجذر التكعيبي لـ x. Float*
أمثلة
مثال للاستخدام
SELECT cbrt(8);2cos
أُضيفت في: v1.1.0
يُرجع جيب تمام الوسيطة.
الصيغة
cos(x)المعاملات
القيمة المُعادة
تُرجِع جيب تمام x. Float*
أمثلة
مثال على الاستخدام
SELECT cos(0);1cosh
أُضيفت في: v20.12.0
تعيد جيب التمام الزائدي للوسيطة.
الصيغة
cosh(x)الوسيطات
القيمة المُعادة
تُرجع قيماً ضمن المجال: 1 ≤ cosh(x) < +∞ Float64
أمثلة
الاستخدام الأساسي
SELECT cosh(0)1degrees
أُدرجت في: v22.2.0
تحوّل القيم من الراديان إلى درجات.
الصياغة
degrees(x)المعاملات
القيمة المُعادة
تُرجِع قيمة x بالدرجات. Float64
أمثلة
الاستخدام الأساسي
SELECT degrees(3.141592653589793)180e
استُحدث في: v1.1.0
يُرجع ثابت أويلر (e).
البنية
e()المعاملات
- لا شيء.
القيمة المُعادة
يُرجع ثابت أويلر Float64
أمثلة
مثال على الاستخدام
SELECT e();2.718281828459045erf
تم تقديمه في: v1.1.0
إذا كانت x غير سالبة، فإن erf(x/(σ√2)) تمثل احتمال أن يأخذ متغير عشوائي ذو توزيع طبيعي وانحراف معياري σ قيمةً تبعد عن القيمة المتوقعة بأكثر من x.
الصيغة
erf(x)الوسيطات
القيمة المُعادة
تُرجع قيمة دالة الخطأ من النوع Float*
أمثلة
قاعدة الثلاث سيغما
SELECT erf(3 / sqrt(2))┌─erf(divide(3, sqrt(2)))─┐
│ 0.9973002039367398 │
└─────────────────────────┘erfc
استُحدثت في: v1.1.0
تعيد عددًا قريبًا من 1-erf(x) من دون فقدان الدقة عند القيم الكبيرة لـ x.
الصيغة
erfc(x)الوسائط
القيمة المُعادة
تُرجع قيمة دالة الخطأ التكميلية Float*
أمثلة
مثال على الاستخدام
SELECT erfc(0);1exp
أُضيفت في: 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);100exp2
أُضيفت في: 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)3628800hypot
أُضيفت في: v20.12.0
تُرجِع طول وتر مثلث قائم الزاوية. تتجنب الدالة Hypot المشكلات التي قد تحدث عند تربيع أعداد كبيرة جدًا أو صغيرة جدًا.
الصيغة
hypot(x, y)الوسائط
x— الضلع القائم الأول في مثلث قائم الزاوية.(U)Int*أوFloat*أوBFloat16أوDecimal*y— الضلع القائم الثاني في مثلث قائم الزاوية.(U)Int*أوFloat*أوBFloat16أوDecimal*
القيمة المُعادة
تعيد طول الوتر في مثلث قائم الزاوية. Float64
أمثلة
الاستخدام الأساسي
SELECT hypot(1, 1)1.4142135623730951intExp10
أُضيفت في: v1.1.0
مماثلة لـ exp10، لكنها تُرجِع قيمة من النوع UInt64.
البنية
intExp10(x)الوسائط
القيمة المُعادة
يعيد 10^x. UInt64
أمثلة
مثال على الاستخدام
SELECT intExp10(2);100intExp2
أُضيف في: v1.1.0
يشبه exp2، لكنه يُرجع قيمة من النوع UInt64.
الصيغة
intExp2(x)الوسائط
القيمة المُعادة
يُرجع 2^x. UInt64
أمثلة
مثال على الاستخدام
SELECT intExp2(3);8isPrime
أُضيف في: v26.5.0
يعيد 1 إذا كان المُعامل عددًا أوليًا، وإلا فيعيد 0.
يستخدم bitmap بحثٍ دقيق للقيم الصغيرة واختبار Miller-Rabin حتميًا للقيم الأكبر. تكون النتيجة دقيقة مع كل نوع إدخال مدعوم.
بالنسبة إلى أنواع الأعداد الصحيحة غير الموقعة الأوسع (UInt128, UInt256)، استخدم isProbablePrime بدلًا من ذلك.
الصياغة
isPrime(n)الوسائط
القيمة المُعادة
يعيد 1 إذا كان n عددًا أوليًا، و0 خلاف ذلك. UInt8
أمثلة
عدد أولي
SELECT isPrime(17)1عدد مركب
SELECT isPrime(18)0عدد أولي كبير من النوع UInt64
SELECT isPrime(18446744073709551557)1القيمة القصوى لـ UInt64
SELECT isPrime(18446744073709551615)0isProbablePrime
أُضيف في: 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أوUInt256rounds— ثابت اختياري لعدد صحيح موجب ضمن[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)1lgamma
قُدِّمت في: v1.1.0
تعيد لوغاريتم دالة غاما.
الصيغة
lgamma(x)الوسائط
القيمة المُعادة
يُرجع لوغاريتم دالة غاما لـ x. Float*
أمثلة
مثال للاستخدام
SELECT lgamma(5);3.1780538303479458log
قُدِّم في: v1.1.0
يعيد اللوغاريتم الطبيعي لوسيطة الدالة.
الصيغة
log(x)الأسماء المستعارة: ln
وسيطات الدالة
القيمة المعادة
تعيد اللوغاريتم الطبيعي لـ x. Float*
أمثلة
مثال على الاستخدام
SELECT log(10);2.3025850938475476log10
قُدِّم في: v1.1.0
يعيد اللوغاريتم العشري للوسيطة.
الصياغة
log10(x)الوسائط
القيمة المُعادة
اللوغاريتم العشري للعدد x. Float*
أمثلة
مثال على الاستخدام
SELECT log10(100);2log1p
استُحدثت في: v20.12.0
تحسب log(1+x).
تكون عملية الحساب log1p(x) أدق من log(1+x) عند القيم الصغيرة لـ x.
الصيغة
log1p(x)المعاملات
القيمة المرجعة
يعيد قيمة ضمن النطاق: -∞ < log1p(x) < +∞ Float64
أمثلة
مثال على الاستخدام
SELECT log1p(0)0log2
قُدِّم في: v1.1.0
يعيد اللوغاريتم الثنائي للوسيطة.
البنية
log2(x)الوسائط
القيمة المعادة
يُرجع اللوغاريتم الثنائي لـ x. Float*
أمثلة
مثال على الاستخدام
SELECT log2(8);3pi
تم تقديمها في: v1.1.0
تعيد pi (π).
الصيغة
pi()المعاملات
- لا شيء.
القيمة المُعادة
تعيد القيمة pi Float64
أمثلة
مثال على الاستخدام
SELECT pi();3.141592653589793pow
أُضيف في: v1.1.0
يُرجع x مرفوعًا للأس y.
الصيغة
pow(x, y)الأسماء المستعارة: power
الوسيطات
x— الأساس.(U)Int8/16/32/64أوFloat*أوBFloat16أوDecimal*y— الأسّ.(U)Int8/16/32/64أوFloat*أوBFloat16أوDecimal*
القيمة المعادة
ترجع x^y من النوع Float64
أمثلة
مثال على الاستخدام
SELECT pow(2, 3);8proportionsZTest
أُضيفت في: v22.3.0
تعيد إحصاءات اختبار Z لنسبتين، وهو اختبار إحصائي لمقارنة النِّسَب بين مجتمعين إحصائيين x و y. تدعم الدالة طريقتَي التقدير المجمّع وغير المجمّع للخطأ المعياري. في الطريقة المجمّعة، يُؤخذ متوسط النسبتين وتُستخدم نسبة واحدة فقط لتقدير الخطأ المعياري. أما في الطريقة غير المجمّعة، فتُستخدم النسبتان كلٌّ على حدة.
البنية
proportionsZTest(successes_x, successes_y, trials_x, trials_y, conf_level, pool_type)الوسائط
successes_x— عدد النجاحات في المجموعة x.UInt64successes_y— عدد النجاحات في المجموعة y.UInt64trials_x— عدد التجارب في المجموعة x.UInt64trials_y— عدد التجارب في المجموعة y.UInt64conf_level— مستوى الثقة للاختبار.Float64pool_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.141592653589793sigmoid
استُحدثت في: v20.1.0
تحسب دالة sigmoid: 1 / (1 + exp(-x)). تحوِّل دالة sigmoid أي عدد حقيقي إلى الفترة (0, 1)، وتُستخدم عادةً في تعلّم الآلة.
الصيغة
sigmoid(x)الوسائط
القيمة المُعادة
يعيد دالة السيغمويد لقيمة الإدخال، ضمن النطاق (0, 1). Float64
أمثلة
الاستخدام الأساسي
SELECT sigmoid(0)0.5sign
أُضيف في: 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)-1sin
أُضيف في: v1.1.0
تُرجِع جيبَ الوسيطة.
البنية
sin(x)المعاملات
القيمة المُعادة
يُرجع جيب x.
أمثلة
بسيط
SELECT sin(1.23)0.9424888019316975sinh
أُضيف في: v20.12.0
يعيد الجيب الزائدي.
الصيغة
sinh(x)الوسيطات
القيمة المُعادة
تعيد قيماً تقع ضمن المجال: -∞ < sinh(x) < +∞ Float64
أمثلة
مثال على الاستخدام
SELECT sinh(0)0sqrt
أُضيفت في: v1.1.0
تُرجِع الجذر التربيعي للوسيطة.
الصياغة
sqrt(x)المعاملات
القيمة المُعادة
يعيد الجذر التربيعي لـ x Float*
أمثلة
مثال على الاستخدام
SELECT sqrt(16);4tan
تم تقديمه في: v1.1.0
يُرجع ظلّ الوسيطة.
البنية
tan(x)الوسائط
القيمة المُعادة
يُرجع ظل x. Float*
أمثلة
مثال على الاستخدام
SELECT tan(0);0tanh
أُضيف في: v20.1.0
تُرجع قيمة الظل الزائدي.
الصياغة
tanh(x)الوسائط
القيمة المُعادة
تُرجِع قيماً ضمن المجال: -1 < tanh(x) < 1 Float*
أمثلة
مثال للاستخدام
SELECT tanh(0)0tgamma
أُضيفت في: v1.1.0
تعيد دالة غاما.
بنية الجملة
tgamma(x)الوسائط
القيمة المُعادة
تعيد قيمة دالة غاما من النوع Float*
أمثلة
مثال على الاستخدام
SELECT tgamma(5);24widthBucket
أُضيف في: 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/64low— الحد الأدنى لنطاق المُدرَّج التكراري.(U)Int8/16/32/64high— الحد الأعلى لنطاق المُدرَّج التكراري.(U)Int8/16/32/64count— عدد الفئات متساوية العرض. لا يمكن أن تكون قيمته صفراً.UInt8/16/32/64
القيمة المُعادة
تُعيد رقم الفئة كعدد صحيح. وتُعيد 0 إذا كانت operand < low، وتُعيد count+1 إذا كانت operand >= high. UInt8/16/32/64
أمثلة
مثال على الاستخدام
SELECT widthBucket(10.15, -8.6, 23, 18)11