Skip to main content

timeSeriesPresentToGrid

أُضيف في: v26.9.0 دالة تجميعية تتحقق من وجود بيانات السلاسل الزمنية على الشبكة المحددة. فلكل نقطة على الشبكة، تُرجع الدالة القيمة 1 إذا وُجدت عيّنة واحدة على الأقل ضمن النافذة الزمنية المحددة، وإلا فتُرجع NULL.
هذه الدالة في مرحلة المعاينة الخاصة، ويمكنك تفعيلها بضبط الإعداد enable_time_series_aggregate_functions=true.
الصيغة
المعلمات
  • start_timestamp — يحدد بداية الشبكة الزمنية. ويمكن أن يكون أيضًا عددًا كسريًا، أو سلسلة نصية تحتوي على عدد أو على نص يمثّل تاريخًا ووقتًا. UInt32 أو DateTime أو DateTime64 أو Float* أو Decimal* أو String
  • end_timestamp — يحدد نهاية الشبكة الزمنية. ويمكن أن يكون أيضًا عددًا كسريًا، أو سلسلة نصية تحتوي على عدد أو على نص يمثّل تاريخًا ووقتًا. UInt32 أو DateTime أو DateTime64 أو Float* أو Decimal* أو String
  • grid_step — يحدد خطوة الشبكة الزمنية بالثواني. ويمكن أن يكون أيضًا عددًا كسريًا، أو سلسلة نصية تحتوي على عدد أو على مدة مثل ’15s’ أو ‘1m’. UInt32 أو Float* أو Decimal* أو String
  • staleness — يحدد الحد الأقصى لـ”تقادم” العينات المعتبرة بالثواني. ونافذة التقادم فاصل زمني مفتوح من اليسار ومغلق من اليمين. ويمكن أن يكون أيضًا عددًا كسريًا، أو سلسلة نصية تحتوي على عدد أو على مدة مثل ’15s’ أو ‘1m’. UInt32 أو Float* أو Decimal* أو String
الوسيطات
  • timestamp — الطابع الزمني للعينة. يمكن أن يكون قيمًا مفردة أو مصفوفات. UInt32 أو DateTime أو DateTime64 أو Array(UInt32) أو Array(DateTime) أو Array(DateTime64)
  • value — قيمة السلسلة الزمنية المقابلة للطابع الزمني. يمكن أن تكون قيمًا مفردة أو مصفوفات. Float* أو Array(Float*)
  • samples — عينات السلسلة الزمنية، وتُمرَّر على هيئة مصفوفة من الصفوف المرتبة (timestamp, value)، تكون عناصرها من أنواع الطابع الزمني والقيمة المذكورة أعلاه. وهي بديل عن تمرير الطوابع الزمنية والقيم في وسيطتين منفصلتين. Array(Tuple(T1, T2))
القيمة المعادة تُرجع 1 لكل نقطة في الشبكة الزمنية تحتوي نافذتها على عينة واحدة على الأقل، وإلا فتُرجع NULL. Array(Nullable(UInt8)) أمثلة
آخر تعديل في ١٤ أكتوبر ٢٠٢٦