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

# generate_series (generateSeries)

> يعيد جدولًا يحتوي على عمود واحد هو `generate_series` ‏(UInt64)، ويتضمن أعدادًا صحيحة من start إلى stop، بما في ذلك القيمتان الحدّيتان.

الاسم البديل: `generateSeries`

<div id="syntax">
  ## البنية
</div>

يعيد جدولًا يحتوي على العمود الوحيد 'generate\_series' (`UInt64`) ويتضمن أعدادًا صحيحة من start إلى stop، بشمول الطرفين:

```sql theme={null}
generate_series(START, STOP)
```

يعيد جدولًا يحتوي على العمود الوحيد 'generate\_series' (`UInt64`) ويتضمن أعدادًا صحيحة من start إلى stop، مع تضمين القيمتين، وبفاصل بين القيم يحدده `STEP`:

```sql theme={null}
generate_series(START, STOP, STEP)
```

يمكن أن تكون `STEP` سالبة، وفي هذه الحالة تُنشأ السلسلة بترتيب تنازلي من `START` حتى `STOP`. وإذا كانت `STEP` سالبة وكان `START < STOP`، فستكون النتيجة فارغة.

<div id="examples">
  ## أمثلة
</div>

تُرجِع الاستعلامات التالية جداول لها المحتوى نفسه ولكن بأسماء أعمدة مختلفة:

```sql theme={null}
SELECT * FROM numbers(10, 5);
```

```response theme={null}
┌─number─┐
│     10 │
│     11 │
│     12 │
│     13 │
│     14 │
└────────┘
```

```sql theme={null}
SELECT * FROM generate_series(10, 14);
```

```response theme={null}
┌─generate_series─┐
│              10 │
│              11 │
│              12 │
│              13 │
│              14 │
└─────────────────┘
```

وتُرجِع الاستعلامات التالية جداول ذات المحتوى نفسه ولكن بأسماء أعمدة مختلفة (مع أن الخيار الثاني أكثر كفاءة):

```sql theme={null}
SELECT * FROM numbers(10, 11) WHERE number % 3 == (10 % 3);
```

```response theme={null}
┌─number─┐
│     10 │
│     13 │
│     16 │
│     19 │
└────────┘
```

```sql theme={null}
SELECT * FROM generate_series(10, 20, 3);
```

```response theme={null}
┌─generate_series─┐
│              10 │
│              13 │
│              16 │
│              19 │
└─────────────────┘
```

ولّد متتالية تنازلية:

```sql theme={null}
SELECT * FROM generate_series(9, 0, -1);
```

```response theme={null}
┌─generate_series─┐
│               9 │
│               8 │
│               7 │
│               6 │
│               5 │
│               4 │
│               3 │
│               2 │
│               1 │
│               0 │
└─────────────────┘
```