> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> دالة تجميع تحسب idelta بأسلوب مشابه لـ PromQL لبيانات السلاسل الزمنية على الشبكة المحددة.

# timeSeriesInstantDeltaToGrid

<div id="timeSeriesInstantDeltaToGrid">
  ## timeSeriesInstantDeltaToGrid
</div>

استُحدثت في: v25.6.0

دالة تجميع تأخذ بيانات السلاسل الزمنية على شكل أزواج من الطوابع الزمنية والقيم، وتحسب [idelta على غرار PromQL](https://prometheus.io/docs/prometheus/latest/querying/functions/#idelta) من هذه البيانات على شبكة زمنية منتظمة يحدّدها الطابع الزمني للبداية، والطابع الزمني للنهاية، و`step`.
ولكل نقطة على الشبكة، تؤخذ العينات اللازمة لحساب `idelta` ضمن النافذة الزمنية المحددة.

<Warning>
  هذه الدالة تجريبية، ويمكن تفعيلها بضبط `allow_experimental_ts_to_grid_aggregate_function=true`.
</Warning>

**البنية**

```sql theme={null}
timeSeriesInstantDeltaToGrid(start_timestamp, end_timestamp, grid_step, staleness)(timestamp, value)
```

**المعلمات**

* `start_timestamp` — يحدِّد بداية الشبكة. [`UInt32`](/ar/reference/data-types/int-uint) أو [`DateTime`](/ar/reference/data-types/datetime)
* `end_timestamp` — يحدِّد نهاية الشبكة. [`UInt32`](/ar/reference/data-types/int-uint) أو [`DateTime`](/ar/reference/data-types/datetime)
* `grid_step` — يحدِّد خطوة الشبكة بالثواني. [`UInt32`](/ar/reference/data-types/int-uint)
* `staleness` — يحدِّد الحد الأقصى للتقادم، بالثواني، للعينات المأخوذة في الحسبان. نافذة التقادم هي فترة مفتوحة من اليسار ومغلقة من اليمين. [`UInt32`](/ar/reference/data-types/int-uint)

**الوسيطات**

* `timestamp` — الطابع الزمني للعينة. يمكن أن يكون قيماً مفردة أو مصفوفات. [`UInt32`](/ar/reference/data-types/int-uint) أو [`DateTime`](/ar/reference/data-types/datetime) أو [`Array(UInt32)`](/ar/reference/data-types/array) أو [`Array(DateTime)`](/ar/reference/data-types/array)
* `value` — قيمة السلسلة الزمنية المقابلة للطابع الزمني. يمكن أن تكون قيماً مفردة أو مصفوفات. [`Float*`](/ar/reference/data-types/float) أو [`Array(Float*)`](/ar/reference/data-types/array)

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

تعيد قيم idelta على الشبكة المحددة. تحتوي المصفوفة المُعادة على قيمة واحدة لكل نقطة في الشبكة الزمنية. تكون القيمة NULL إذا لم تكن هناك عينات كافية ضمن النافذة لحساب قيمة delta اللحظية لنقطة شبكة معيّنة. [`Array(Nullable(Float64))`](/ar/reference/data-types/array)

**أمثلة**

**الاستخدام الأساسي مع أزواج الطابع الزمني والقيمة المفردة**

```sql title=Query theme={null}
WITH
    -- NOTE: the gap between 140 and 190 is to show how values are filled for ts = 150, 165, 180 according to window parameter
    [110, 120, 130, 140, 190, 200, 210, 220, 230]::Array(DateTime) AS timestamps,
    [1, 1, 3, 4, 5, 5, 8, 12, 13]::Array(Float32) AS values, -- array of values corresponding to timestamps above
    90 AS start_ts,       -- start of timestamp grid
    90 + 120 AS end_ts,   -- end of timestamp grid
    15 AS step_seconds,   -- step of timestamp grid
    45 AS window_seconds  -- "staleness" window
SELECT timeSeriesInstantDeltaToGrid(start_ts, end_ts, step_seconds, window_seconds)(timestamp, value)
FROM
(
    -- This subquery converts arrays of timestamps and values into rows of `timestamp`, `value`
    SELECT
        arrayJoin(arrayZip(timestamps, values)) AS ts_and_val,
        ts_and_val.1 AS timestamp,
        ts_and_val.2 AS value
);
```

```response title=Response theme={null}
┌─timeSeriesInstantDeltaToGrid(start_ts, end_ts, step_seconds, window_seconds)(timestamp, value)─┐
│ [NULL,NULL,0,2,1,1,NULL,NULL,3]                                                               │
└───────────────────────────────────────────────────────────────────────────────────────────────┘
```

**استخدام الوسيطات من نوع المصفوفة**

```sql title=Query theme={null}
-- it is possible to pass multiple samples of timestamps and values as Arrays of equal size
WITH
    [110, 120, 130, 140, 190, 200, 210, 220, 230]::Array(DateTime) AS timestamps,
    [1, 1, 3, 4, 5, 5, 8, 12, 13]::Array(Float32) AS values,
    90 AS start_ts,
    90 + 120 AS end_ts,
    15 AS step_seconds,
    45 AS window_seconds
SELECT timeSeriesInstantDeltaToGrid(start_ts, end_ts, step_seconds, window_seconds)(timestamps, values);
```

```response title=Response theme={null}
┌─timeSeriesInstantDeltaToGrid(start_ts, end_ts, step_seconds, window_seconds)(timestamps, values)─┐
│ [NULL,NULL,0,2,1,1,NULL,NULL,3]                                                                 │
└─────────────────────────────────────────────────────────────────────────────────────────────────┘
```