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

dotProduct

مُستحدثة في: v21.11.0 تحسب الضرب النقطي (الجداء القياسي) لمتجهين (tupleين أو مصفوفتين متساويتين في الحجم). وتُرجِع مجموع نواتج ضرب العناصر المناظرة. الصيغة
الأسماء المستعارة: scalarProduct الوسائط
  • vector1 — المتجه الأول. Array(T) أو Tuple(T)
  • vector2 — المتجه الثاني. يجب أن يكون بالحجم نفسه للمتجه الأول. Array(T) أو Tuple(T)
القيمة المُعادة تعيد حاصل الضرب النقطي للمتجهين. (U)Int* أو Float* أو Decimal أمثلة الاستخدام الأساسي
Query
Response

flattenTuple

أُضيفت في: v22.6.0 تُسطِّح Tuple مُسمّى ومتداخلاً. تكون عناصر الـ Tuple المُعادة هي مسارات الـ Tuple المُدخلة. البنية
الوسائط القيمة المُعادة يُرجع Tuple ناتجًا تكون عناصره مسارات من الإدخال الأصلي. 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 تحتوي على جميع العناصر من قيم Tuple المُدخلة. Tuple(T) أمثلة مثال على الاستخدام
Query
Response

tupleDivide

قُدِّمت في: v21.11.0 تحسب القسمة عنصرًا بعنصر لـ tupleين أو أكثر من الحجم نفسه، وتُطبَّق من اليسار إلى اليمين.
ستُرجع القسمة على صفر القيمة inf.
البنية
الوسيطات القيمة المعادة تعيد قيمة Tuple تحتوي على نواتج القسمة عنصرًا بعنصر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة قيمتا Tuple
Query
Response
ثلاثة tuples
Query
Response

tupleDivideByNumber

أُضيف في: v21.11.0 يُرجع قيمة Tuple تكون جميع عناصرها مقسومة على عدد.
ستُرجع القسمة على صفر القيمة inf.
البنية
الوسيطات القيمة المعادة تعيد قيمة Tuple تحتوي على عناصر مقسومة. 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/64
  • name — اسم العنصر. const String
  • default_value — القيمة الافتراضية التي تُعاد عندما يكون الفهرس خارج النطاق أو عندما لا يكون العنصر موجودًا. Any
القيمة المُعادة يُعاد العنصر عند الفهرس أو الاسم المحدد. Any أمثلة الوصول بالفهرس
Query
Response
الفهرسة بالمؤشرات السالبة
Query
Response
Tuple مُسمّاة مع جدول
Query
Response
مع القيمة الافتراضية
Query
Response
صيغة المعامل
Query
Response

tupleHammingDistance

أُضيفت في: v21.1.0 تعيد مسافة هامينغ بين قيمتَي Tuple لهما العدد نفسه من العناصر.
يُحدَّد نوع النتيجة بالطريقة نفسها المتبعة في الدوال الحسابية، وذلك بناءً على عدد العناصر في قيمتَي Tuple المُدخلتَين.
الصيغة
الوسائط القيمة المُعادة تعيد مسافة هامينغ. UInt8/16/32/64 أمثلة مثال على الاستخدام
Query
Response
باستخدام MinHash لاكتشاف السلاسل النصية شبه المتطابقة
Query
Response

tupleIntDiv

تم تقديمه في: v23.8.0 يجري قسمة صحيحة على مستوى كل عنصر لاثنين أو أكثر من عناصر Tuple ذات الحجم نفسه، مع التطبيق من اليسار إلى اليمين. ويُرجع Tuple من نواتج القسمة. إذا كان أي Tuple يحتوي على عناصر غير صحيحة، فتُحسب النتيجة بتقريب كل بسط أو مقسوم عليه غير صحيح إلى أقرب عدد صحيح. تؤدي القسمة على 0 إلى طرح استثناء. البنية
الوسيطات القيمة المعادة تعيد Tuple من نواتج القسمة الصحيحة. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة Tupleان
Query
Response
مع القيم العشرية
Query
Response
ثلاثة Tuples
Query
Response

tupleIntDivByNumber

أُضيفت في: v23.8.0 تُجري قسمة صحيحة على Tuple من البسوط باستخدام مقام معيّن، وتُرجع Tuple من نواتج القسمة. إذا احتوت أيّ من معلمات الإدخال على عناصر غير صحيحة، فستُحسب النتيجة بتقريب كل بسط أو مقسوم عليه غير صحيح إلى أقرب عدد صحيح. سيتم طرح خطأ عند القسمة على 0. البنية
الوسائط القيمة المعادة تعيد Tuple من نواتج القسمة. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة الاستخدام الأساسي
Query
Response
مع قيم Decimal
Query
Response

tupleIntDivOrZero

أُضيف في: v23.8.0 مثل tupleIntDiv، يُجري قسمة صحيحة على مستوى كل عنصر لاثنين أو أكثر من قيم Tuple ذات الحجم نفسه، مع التطبيق من اليسار إلى اليمين. في حالة القسمة على 0، يُرجِع 0 لذلك العنصر بدلًا من إثارة استثناء. إذا احتوى أي Tuple على عناصر غير صحيحة، فتُحتسب النتيجة عبر التقريب إلى أقرب عدد صحيح لكل بسط أو مقسوم عليه غير صحيح. الصياغة
الوسائط القيمة المعادة تعيد قيمة Tuple من نواتج القسمة الصحيحة، مع 0 لأي عنصر يكون فيه المقسوم عليه 0. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة مع مقسوم عليه يساوي صفرًا
Query
Response
ثلاث قيم Tuple
Query
Response

tupleIntDivOrZeroByNumber

قُدِّم في: v23.8.0 مثل tupleIntDivByNumber، يُجري هذا الدالّة قسمةً صحيحة لعناصر Tuple من البسوط على مقام معيّن، ويُرجع Tuple من نواتج القسمة. ولا يُنتج خطأً إذا كان القاسم صفراً، بل يُرجع ناتج القسمة صفراً. إذا احتوى Tuple أو القاسم على عناصر غير صحيحة، فتُحسب النتيجة بتقريب كل بسط أو قاسم غير صحيح إلى أقرب عدد صحيح. البنية
الوسيطات القيمة المعادة تُرجِع Tuple من نواتج القسمة، مع 0 للنواتج التي يكون فيها المقسوم عليه 0. Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal) أمثلة الاستخدام الأساسي
Query
Response
عند كون القاسم صفرًا
Query
Response

tupleMinus

قُدِّمت في: v21.11.0 يحسب الفرق عنصرًا بعنصر بين قيمتي Tuple أو أكثر من الحجم نفسه، ويُطبَّق من اليسار إلى اليمين. الصياغة
الأسماء البديلة: vectorDifference الوسيطات القيمة المعادة تعيد قيمة Tuple تحتوي على الفروق عنصرًا بعنصر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة زوج من قيم Tuple
Query
Response
ثلاثة Tuples
Query
Response

tupleModulo

قُدِّمت في: v23.8.0 يعيد Tuple يحتوي على بواقي القسمة المحسوبة عنصرًا بعنصر من قسمة مجموعتي Tuple أو أكثر من الحجم نفسه، مع تطبيق العملية من اليسار إلى اليمين. البنية
الوسيطات القيمة المُعادة تُعيد Tuple يحتوي على بواقي القسمة محسوبةً عنصرًا بعنصر. يتم طرح استثناء عند القسمة على صفر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة قيمتا Tuple
Query
Response
ثلاثة Tuples
Query
Response

tupleModuloByNumber

أُضيف في: v23.8.0 تُرجِع Tuple تحتوي على نواتج باقي القسمة (البواقي) لعمليات القسمة بين Tuple ومقسوم عليه معيّن. الصياغة
الوسيطات القيمة المعادة تُرجِع Tuple من بواقي القسمة. ويتم طرح خطأ عند القسمة على صفر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة الاستخدام الأساسي
Query
Response

tupleMultiply

أُضيف في: v21.11.0 يحسب حاصل الضرب عنصرًا بعنصر لاثنين أو أكثر من قيم Tuple ذات الحجم نفسه. البنية
الوسيطات القيمة المعادة تعيد قيمة Tuple تحتوي على نواتج الضرب على مستوى العناصر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة قيمتا Tuple
Query
Response
ثلاثة tuples
Query
Response

tupleMultiplyByNumber

أُضيف في: v21.11.0 يُرجع Tuple تكون جميع عناصرها مضروبة في عدد. البنية
المعاملات القيمة المُعادة يُرجع قيمة Tuple بعناصر مضروبة. 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. الصيغة
الوسيطات القيمة المعادة تُرجِع قيمة Tuple تحتوي على نتيجة النفي. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة الاستخدام الأساسي
Query
Response

tuplePlus

طُرح في: v21.11.0 يحسب مجموع العناصر المناظرة في tupleين أو أكثر من الحجم نفسه. الصيغة
الأسماء البديلة: vectorSum الوسائط القيمة المُعادة تُرجِع قيمة Tuple تحتوي على المجاميع عنصرًا بعنصر. Tuple((U)Int*) أو Tuple(Float*) أو Tuple(Decimal) أمثلة Tupleان
Query
Response
ثلاثة Tuples
Query
Response

tuplePositiveModuloByNumber

أُضيف في: v26.4.0 يعيد Tuple يحتوي على البواقي الموجبة (remainders) لعمليات قسمة عناصر Tuple على مقسوم عليه معيّن. وعلى خلاف tupleModuloByNumber، تكون النتيجة دائمًا غير سالبة. البنية
الوسيطات القيمة المعادة تُرجع Tuple من البواقي غير السالبة. 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 من النوع نفسه. الصياغة
الوسيطات القيمة المعادة تعيد مصفوفة من أزواج (name, value). Array(Tuple(String, T)) أمثلة Tuple مُسمّى
Query
Response
Tuple غير مُسمّى
Query
Response

untuple

ينفّذ استبدالًا نحويًا لعناصر tuple في موضع الاستدعاء. تعتمد أسماء الأعمدة الناتجة على التنفيذ وقد تتغير. لا تفترض أسماء أعمدة محددة بعد untuple. الصيغة
يمكنك استخدام التعبير EXCEPT لتخطي الأعمدة من نتيجة الاستعلام. الوسائط
  • x — دالة tuple، أو عمود، أو Tuple من العناصر. Tuple.
القيمة المُعادة
  • لا شيء.
أمثلة جدول الإدخال:
مثال على استخدام عمود من نوع Tuple بصفته معلمة للدالة untuple:
Query
Response
مثال على استخدام تعبير EXCEPT:
Query
Response

دوال المسافة

ترد جميع الدوال المدعومة في وثائق دوال المسافة.
آخر تعديل في ٢٥ يونيو ٢٠٢٦