تم إنشاء الوثائق أدناه استنادًا إلى جدول النظام
system.functions.dotProduct
مُستحدثة في: v21.11.0 تحسب الضرب النقطي (الجداء القياسي) لمتجهين (tupleين أو مصفوفتين متساويتين في الحجم). وتُرجِع مجموع نواتج ضرب العناصر المناظرة. الصيغةscalarProduct
الوسائط
vector1— المتجه الأول.Array(T)أوTuple(T)vector2— المتجه الثاني. يجب أن يكون بالحجم نفسه للمتجه الأول.Array(T)أوTuple(T)
BFloat16 باستخدام Float32 وتُرجعان قيمة من النوع Float32. (U)Int* أو Float* أو Decimal
أمثلة
الاستخدام الأساسي
Query
Response
flattenTuple
أُضيفت في: v22.6.0 تُسطِّح Tuple مُسمّى ومتداخلاً. تكون عناصر الـ Tuple المُعادة هي مسارات الـ Tuple المُدخلة. الصيغةinput— Tuple مُسمّى ومتداخل يُراد تسطيحه.Tuple(n1 T1[, n2 T2, ... ])
Tuple(T)
أمثلة
مثال على الاستخدام
Query
Response
tuple
ظهر في: v1.1.0 يعيد tuple من خلال تجميع معاملات الإدخال. بالنسبة إلى الأعمدة C1 وC2 و… ذات الأنواع T1 وT2 و…، فإنه يعيد tuple من النوع المسمى Tuple(C1 T1, C2 T2, …) يحتوي على هذه الأعمدة إذا كانت أسماؤها فريدة ويمكن التعامل معها كمُعرِّفات غير مقتبسة، وإلا فسيُعاد Tuple(T1, T2, …). لا توجد أي تكلفة لتنفيذ هذه الدالة. تُستخدم Tuples عادةً كقيم وسيطة لوسيط من معاملات IN، أو لإنشاء قائمة بالمعاملات الصورية لدوال lambda. ولا يمكن كتابة Tuples في جدول. تُنفِّذ الدالة العامل(x, y, ...).
البنية
- لا يوجد.
Query
Response
tupleConcat
قُدِّمت في: v23.8.0 تدمج قيم Tuple الممرَّرة كوسائط. البنيةtupleN— عدد غير محدد من المعاملات من النوع Tuple.Tuple(T)
Tuple(T)
أمثلة
مثال على الاستخدام
Query
Response
tupleDivide
قُدِّمت في: v21.11.0 تحسب القسمة عنصرًا بعنصر لـ tupleين أو أكثر من الحجم نفسه، وتُطبَّق من اليسار إلى اليمين.ستُرجع القسمة على صفر القيمة
inf.t1— قيمة Tuple الأولى للإدخال.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— قيمة Tuple إضافية واحدة أو أكثر للإدخال. يجب أن تكون جميع قيم Tuple بالحجم نفسه.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
قيمتا Tuple
Query
Response
Query
Response
tupleDivideByNumber
أُضيف في: v21.11.0 يُرجع قيمة Tuple تكون جميع عناصرها مقسومة على عدد.ستُرجع القسمة على صفر القيمة
inf.tuple— قيمة Tuple المطلوب قسمتها.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)number— القاسم.(U)Int*أوFloat*أوDecimal
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
tupleElement
أُضيفت في: v1.1.0 تستخرج عنصرًا من Tuple باستخدام الفهرس أو الاسم. للوصول باستخدام الفهرس، يُتوقع فهرس رقمي يبدأ العد فيه من 1. وللوصول باستخدام الاسم، يمكن تمرير اسم العنصر كسلسلة نصية (يعمل هذا فقط مع Tuple المُسمّاة). الفهارس السالبة مدعومة. في هذه الحالة، يُحدَّد العنصر المقابل مع ترقيم يبدأ من النهاية. على سبيل المثال،tuple.-1 هو العنصر الأخير في Tuple.
تحدّد وسيطة ثالثة اختيارية قيمة افتراضية تُعاد بدلًا من إطلاق استثناء عندما لا يكون العنصر المطلوب الوصول إليه موجودًا.
يجب أن تكون جميع الوسيطات ثوابت.
هذه الدالة لا تترتب عليها أي كلفة وقت تشغيل، وتنفّذ المعاملين x.index و x.name.
البنية
tuple— قيمة من النوع Tuple أو مصفوفة من قيم Tuple.Tuple(T)أوArray(Tuple(T))index— فهرس العمود، بدءًا من 1.const UInt8/16/32/64name— اسم العنصر.const Stringdefault_value— القيمة الافتراضية التي تُعاد عندما يكون الفهرس خارج النطاق أو عندما لا يكون العنصر موجودًا.Any
Any
أمثلة
الوصول بالفهرس
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
أُضيفت في: v21.1.0 تعيد مسافة هامينغ بين قيمتَي Tuple لهما العدد نفسه من العناصر.يُحدَّد نوع النتيجة بالطريقة نفسها المتبعة في الدوال الحسابية، وذلك بناءً على عدد العناصر في قيمتَي Tuple المُدخلتَين.
UInt8/16/32/64
أمثلة
مثال على الاستخدام
Query
Response
Query
Response
tupleIntDiv
تم تقديمه في: v23.8.0 يجري قسمة صحيحة على مستوى كل عنصر لاثنين أو أكثر من عناصر Tuple ذات الحجم نفسه، مع التطبيق من اليسار إلى اليمين. ويُرجع Tuple من نواتج القسمة. إذا كان أي Tuple يحتوي على عناصر غير صحيحة، فتُحسب النتيجة بتقريب كل بسط أو مقسوم عليه غير صحيح إلى أقرب عدد صحيح. تؤدي القسمة على 0 إلى طرح استثناء. البنيةt1— أول Tuple مُدخل.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— واحد أو أكثر من قيم Tuple المُدخلة الإضافية. يجب أن يكون حجم جميع قيم Tuple متماثلًا.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
Tupleان
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
أُضيفت في: v23.8.0 تُجري قسمة صحيحة على Tuple من البسوط باستخدام مقام معيّن، وتُرجع Tuple من نواتج القسمة. إذا احتوت أيّ من معلمات الإدخال على عناصر غير صحيحة، فستُحسب النتيجة بتقريب كل بسط أو مقسوم عليه غير صحيح إلى أقرب عدد صحيح. سيتم طرح خطأ عند القسمة على 0. البنيةtuple_num— Tuple لقيم البسط.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)div— قيمة المقسوم عليه.(U)Int*أوFloat*أوDecimal
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
Query
Response
tupleIntDivOrZero
أُضيف في: v23.8.0 مثلtupleIntDiv، يُجري قسمة صحيحة على مستوى كل عنصر لاثنين أو أكثر من قيم Tuple ذات الحجم نفسه، مع التطبيق من اليسار إلى اليمين.
في حالة القسمة على 0، يُرجِع 0 لذلك العنصر بدلًا من إثارة استثناء.
إذا احتوى أي Tuple على عناصر غير صحيحة، فتُحتسب النتيجة عبر التقريب إلى أقرب عدد صحيح لكل بسط أو مقسوم عليه غير صحيح.
الصياغة
t1— قيمة Tuple الأولى للإدخال.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— قيمة Tuple إضافية واحدة أو أكثر للإدخال. يجب أن تكون جميع قيم Tuple بالحجم نفسه.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
مع مقسوم عليه يساوي صفرًا
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
قُدِّم في: v23.8.0 مثلtupleIntDivByNumber، يُجري هذا الدالّة قسمةً صحيحة لعناصر Tuple من البسوط على مقام معيّن، ويُرجع Tuple من نواتج القسمة.
ولا يُنتج خطأً إذا كان القاسم صفراً، بل يُرجع ناتج القسمة صفراً.
إذا احتوى Tuple أو القاسم على عناصر غير صحيحة، فتُحسب النتيجة بتقريب كل بسط أو قاسم غير صحيح إلى أقرب عدد صحيح.
البنية
tuple_num— Tuple لقيم البسط.Tuple((U)Int*)orTuple(Float*)orTuple(Decimal)div— قيمة المقسوم عليه.(U)Int*orFloat*orDecimal
0 للنواتج التي يكون فيها المقسوم عليه 0. Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
Query
Response
tupleMinus
قُدِّمت في: v21.11.0 يحسب الفرق عنصرًا بعنصر بين قيمتي Tuple أو أكثر من الحجم نفسه، ويُطبَّق من اليسار إلى اليمين. الصياغةvectorDifference
الوسيطات
t1— قيمة الإدخال الأولى من النوعTuple.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— قيمة إدخال إضافية واحدة أو أكثر من النوعTuple. يجب أن تكون جميع قيمTupleبالحجم نفسه.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple تحتوي على الفروق عنصرًا بعنصر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
زوج من قيم Tuple
Query
Response
Query
Response
tupleModulo
قُدِّمت في: v23.8.0 يعيد Tuple يحتوي على بواقي القسمة المحسوبة عنصرًا بعنصر من قسمة مجموعتي Tuple أو أكثر من الحجم نفسه، مع تطبيق العملية من اليسار إلى اليمين. البنيةt1— أول Tuple مُدخل.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— قيمة Tuple مُدخلة إضافية واحدة أو أكثر. يجب أن تكون جميع قيم Tuple بالحجم نفسه.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
قيمتا Tuple
Query
Response
Query
Response
tupleModuloByNumber
أُضيف في: v23.8.0 تُرجِع Tuple تحتوي على نواتج باقي القسمة (البواقي) لعمليات القسمة بين Tuple ومقسوم عليه معيّن. الصياغةtuple_num— Tuple لعناصر البسط.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)div— قيمة القاسم.(U)Int*أوFloat*أوDecimal
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
tupleMultiply
أُضيف في: v21.11.0 يحسب حاصل الضرب عنصرًا بعنصر لاثنين أو أكثر من قيم Tuple ذات الحجم نفسه. البنيةt1— Tuple الإدخال الأول.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— قيمة Tuple إضافية واحدة أو أكثر للإدخال. يجب أن تكون جميع قيم Tuple بالحجم نفسه.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
قيمتا Tuple
Query
Response
Query
Response
tupleMultiplyByNumber
أُضيف في: v21.11.0 يُرجع Tuple تكون جميع عناصرها مضروبة في عدد. البنيةtuple— قيمة Tuple المراد ضربها.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)number— المُضاعِف.(U)Int*أوFloat*أوDecimal
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
tupleNames
أُضيفت في: v24.8.0 يحوّل Tuple إلى مصفوفة من أسماء الأعمدة. وبالنسبة إلى Tuple بالصيغةTuple(a T, b T, ...)، فإنه يعيد مصفوفة من السلاسل النصية التي تمثل الأعمدة المسمّاة في الـ Tuple. وإذا لم تكن لعناصر الـ Tuple أسماء صريحة، فستُستخدم فهارسها بدلًا منها كأسماء للأعمدة.
البنية
- لا شيء.
Query
Response
tupleNegate
أُضيفت في: v21.11.0 تحسب القيمة السالبة لعناصر الـ Tuple. الصيغةt— قيمة Tuple المراد نفيها.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
tuplePlus
طُرح في: v21.11.0 يحسب مجموع العناصر المناظرة في tupleين أو أكثر من الحجم نفسه. الصيغةvectorSum
الوسائط
t1— Tuple الإدخال الأول.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)t2, ..., tN— Tuple إدخال إضافي واحد أو أكثر. يجب أن تكون جميع قيم Tuple بالحجم نفسه.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
Tupleان
Query
Response
Query
Response
tuplePositiveModuloByNumber
أُضيف في: v26.4.0 يعيد Tuple يحتوي على البواقي الموجبة (remainders) لعمليات قسمة عناصر Tuple على مقسوم عليه معيّن. وعلى خلاف tupleModuloByNumber، تكون النتيجة دائمًا غير سالبة. البنيةtuple_num— Tuple لقيم المقسوم.Tuple((U)Int*)أوTuple(Float*)أوTuple(Decimal)div— قيمة المقسوم عليه.(U)Int*أوFloat*أوDecimal
Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal)
أمثلة
الاستخدام الأساسي
Query
Response
tupleToNameValuePairs
تم تقديمها في: v21.9.0 تحوّل Tuple إلى Array من أزواج(name, value).
على سبيل المثال، يُحوَّل الـ Tuple Tuple(n1 T1, n2 T2, ...) إلى Array(Tuple('n1', T1), Tuple('n2', T2), ...).
يجب أن تكون جميع القيم في الـ Tuple من النوع نفسه.
الصياغة
tuple— Tuple مُسمّى يحتوي على قيم من أي أنواع.Tuple(n1 T1[, n2 T2, ...])
(name, value). Array(Tuple(String, T))
أمثلة
Tuple مُسمّى
Query
Response
Query
Response
untuple
ينفّذ استبدالًا نحويًا لعناصر tuple في موضع الاستدعاء. تعتمد أسماء الأعمدة الناتجة على التنفيذ وقد تتغير. لا تفترض أسماء أعمدة محددة بعدuntuple.
الصيغة
EXCEPT لتخطي الأعمدة من نتيجة الاستعلام.
الوسائط
x— دالةtuple، أو عمود، أو Tuple من العناصر. Tuple.
- لا شيء.
Tuple بصفته معلمة للدالة untuple:
Query
Response
EXCEPT:
Query
Response