> ## 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.

> توثيق الدوال المستخدمة لتوليد الأرقام العشوائية

# دوال توليد الأرقام العشوائية

تقبل جميع الدوال في هذا القسم صفرًا أو وسيطةً واحدة. والاستخدام الوحيد للوسيطة (إن وُجدت) هو منع [إزالة التعبيرات الفرعية المشتركة
](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) بحيث تُرجِع عمليتا تنفيذ مختلفتان داخل صف واحد للدالة العشوائية نفسها
قيمًا عشوائية مختلفة.

محتوى ذو صلة

* الدليل: [توليد بيانات عشوائية في ClickHouse](/ar/guides/clickhouse/data-modelling/generating-test-data)
* المدونة: [توليد بيانات عشوائية في ClickHouse](https://clickhouse.com/blog/generating-random-test-distribution-data-for-clickhouse)

<Note>
  تُولَّد الأرقام العشوائية باستخدام خوارزميات غير مخصّصة للتشفير.
</Note>

<Note>
  يُولَّد التوثيق أدناه من جدول النظام `system.functions`.
</Note>

{/*AUTOGENERATED_START*/}

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

أُضيف في: v20.5.0

يقلب بتّات سلسلة الإدخال `s`، باحتمال `p` لكل بت.

**الصيغة**

```sql theme={null}
fuzzBits(s, p)
```

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

* `s` — سلسلة من النوع `String` أو `FixedString` لإجراء التشويش على البِتّات في [`String`](/ar/reference/data-types/string) أو [`FixedString`](/ar/reference/data-types/fixedstring)
* `p` — احتمال قلب كل بِتّ، ويكون رقمًا بين `0.0` و `1.0` من النوع [`Float*`](/ar/reference/data-types/float)

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

تعيد سلسلة خضعت للتشويش ومن النوع نفسه مثل `s`. [`String`](/ar/reference/data-types/string) أو [`FixedString`](/ar/reference/data-types/fixedstring)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT fuzzBits(materialize('abacaba'), 0.1)
FROM numbers(3)
```

```response title=Response theme={null}
┌─fuzzBits(materialize('abacaba'), 0.1)─┐
│ abaaaja                               │
│ a*cjab+                               │
│ aeca2A                                │
└───────────────────────────────────────┘
```

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

أُضيف في: v1.1.0

يعيد قيمة `UInt32` عشوائية بتوزيع منتظم.

يستخدم مولِّد توافق خطي بحالة ابتدائية يحصل عليها من النظام، ما يعني أنه رغم أنه يبدو عشوائيًا، فإنه ليس عشوائيًا حقيقيًا وقد يمكن التنبؤ به إذا كانت الحالة الابتدائية معروفة.
في الحالات التي تكون فيها العشوائية الحقيقية بالغة الأهمية، فكّر في استخدام أساليب بديلة مثل استدعاءات على مستوى نظام التشغيل أو التكامل مع مكتبات خارجية.

**الصياغة**

```sql theme={null}
rand([x])
```

**الأسماء البديلة**: `rand32`

**الوسائط**

* `x` — اختياري ويتم تجاهله. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

يعيد رقمًا عشوائيًا من النوع `UInt32`. [`UInt32`](/ar/reference/data-types/int-uint)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT rand();
```

```response title=Response theme={null}
1569354847
```

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

أُدخل في: v1.1.0

يعيد عددًا عشوائيًا من النوع `UInt64` يتبع توزيعًا منتظمًا.

يستخدم مولّدًا توافقيًا خطيًا بحالة ابتدائية تُستمد من النظام، ما يعني أنه رغم أنه يبدو عشوائيًا، فإنه ليس عشوائيًا فعليًا وقد يكون قابلًا للتنبؤ إذا كانت الحالة الابتدائية معروفة.
في الحالات التي تكون فيها العشوائية الحقيقية ضرورية، فكّر في استخدام أساليب بديلة مثل استدعاءات على مستوى النظام أو التكامل مع مكتبات خارجية.

**البنية**

```sql theme={null}
rand64([x])
```

**الوسائط**

* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذا الوسيط هو منع [إزالة التعبيرات الفرعية الشائعة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

يُرجع عددًا عشوائيًا من نوع UInt64 بتوزيع منتظم. [`UInt64`](/ar/reference/data-types/int-uint)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT rand64();
```

```response title=Response theme={null}
15030268859237645412
```

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

أُضيف في: v22.10.0

يعيد عددًا عشوائيًا من نوع Float64 مولّدًا وفق [توزيع برنولي](https://en.wikipedia.org/wiki/Bernoulli_distribution).

**البنية**

```sql theme={null}
randBernoulli(probability[, x])
```

**الوسائط**

* `probability` — احتمال النجاح، على شكل قيمة بين `0` و`1`. [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [حذف التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في query. [`Any`](/ar/reference/data-types/index)

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

تُرجع عددًا عشوائيًا من نوع Float64 مولّدًا من توزيع برنولي المحدد. [`UInt64`](/ar/reference/data-types/int-uint)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randBernoulli(.75) FROM numbers(5)
```

```response title=Response theme={null}
┌─randBernoulli(0.75)─┐
│                   1 │
│                   1 │
│                   0 │
│                   1 │
│                   1 │
└─────────────────────┘
```

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

أُضيفت في: v22.10.0

تعيد عددًا عشوائيًا من النوع Float64 مأخوذًا من [التوزيع ذي الحدين](https://en.wikipedia.org/wiki/Binomial_distribution).

**البنية**

```sql theme={null}
randBinomial(experiments, probability[, x])
```

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

* `experiments` — عدد التجارب [`UInt64`](/ar/reference/data-types/int-uint)
* `probability` — احتمال النجاح في كل تجربة، كقيمة بين `0` و`1` [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا من نوع Float64 مأخوذًا من التوزيع ذي الحدين المحدد. [`UInt64`](/ar/reference/data-types/int-uint)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randBinomial(100, .75) FROM numbers(5)
```

```response title=Response theme={null}
┌─randBinomial(100, 0.75)─┐
│                      74 │
│                      78 │
│                      76 │
│                      77 │
│                      80 │
└─────────────────────────┘
```

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

أُضيفت في: v22.11.0

يُرجِع عددًا عشوائيًا من النوع `Float64` بتوزيع منتظم بين `0` (شامل) و`1` (غير شامل).

**البنية**

```sql theme={null}
randCanonical([x])
```

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

* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذا المعامل هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد رقمًا عشوائيًا من النوع Float64. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randCanonical();
```

```response title=Response theme={null}
0.345217890123456
```

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

أُضيف في: v22.10.0

يعيد عددًا عشوائيًا من نوع Float64 مُستمدًا من [توزيع كاي-تربيع](https://en.wikipedia.org/wiki/Chi-squared_distribution).

**البنية**

```sql theme={null}
randChiSquared(degree_of_freedom[, x])
```

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

* `degree_of_freedom` — درجات الحرية. [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا من النوع Float64 مأخوذًا من توزيع كاي-تربيع المحدد. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randChiSquared(10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randChiSquared(10)─┐
│ 10.015463656521543 │
│  9.621799919882768 │
│   2.71785015634699 │
│ 11.128188665931908 │
│  4.902063104425469 │
└────────────────────┘
```

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

أُضيفت في: v1.1.0

تولّد قيمة عشوائية واحدة تبقى ثابتة في جميع الصفوف أثناء تنفيذ الاستعلام الحالي.

هذه الدالة:

* تُرجع القيمة العشوائية نفسها لكل صف ضمن الاستعلام الواحد
* تُنتج قيماً مختلفة بين عمليات تنفيذ الاستعلام المنفصلة

وهي مفيدة لتطبيق بذور عشوائية أو معرّفات متسقة على جميع الصفوف في مجموعة البيانات

**الصياغة**

```sql theme={null}
randConstant([x])
```

**الوسائط**

* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذا الوسيط هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عمودًا من النوع `UInt32` يحتوي على القيمة العشوائية نفسها في كل صف. [`UInt32`](/ar/reference/data-types/int-uint)

**أمثلة**

**الاستخدام الأساسي**

```sql title=Query theme={null}
SELECT randConstant() AS random_value;
```

```response title=Response theme={null}
| random_value |
|--------------|
| 1234567890   |
```

**الاستخدام مع معامل**

```sql title=Query theme={null}
SELECT randConstant(10) AS random_value;
```

```response title=Response theme={null}
| random_value |
|--------------|
| 9876543210   |
```

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

أُضيفت في: v22.10.0

تعيد عددًا عشوائيًا من نوع Float64 يتبع [توزيعًا أسيًا](https://en.wikipedia.org/wiki/Exponential_distribution).

**الصياغة**

```sql theme={null}
randExponential(lambda[, x])
```

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

* `lambda` — معلمة المعدّل أو قيمة لامدا للتوزيع [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية الشائعة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في query. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا من نوع Float64 مأخوذًا من التوزيع الأسي المحدد. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randExponential(1/10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randExponential(divide(1, 10))─┐
│              44.71628934340778 │
│              4.211013337903262 │
│             10.809402553207766 │
│              15.63959406553284 │
│             1.8148392319860158 │
└────────────────────────────────┘
```

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

أُضيف في: v22.10.0

يعيد عددًا عشوائيًا من نوع Float64 مُولَّدًا من [توزيع F](https://en.wikipedia.org/wiki/F-distribution).

**البنية**

```sql theme={null}
randFisherF(d1, d2[, x])
```

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

* `d1` — درجة الحرية `d1` في `X = (S1 / d1) / (S2 / d2)`. [`Float64`](/ar/reference/data-types/float)
* `d2` — درجة الحرية `d2` في `X = (S1 / d1) / (S2 / d2)`. [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويتم تجاهله. الغرض الوحيد من هذه الوسيطة هو منع [حذف التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا من نوع Float64 مأخوذًا من توزيع F المحدد [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randFisherF(10, 3) FROM numbers(5)
```

```response title=Response theme={null}
┌─randFisherF(10, 20)─┐
│  0.7204609609506184 │
│  0.9926258472572916 │
│  1.4010752726735863 │
│ 0.34928401507025556 │
│  1.8216216009473598 │
└─────────────────────┘
```

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

أُضيف في: v22.10.0

يُرجع عددًا عشوائيًا من نوع Float64 مُولَّدًا من [توزيع لوغ-طبيعي](https://en.wikipedia.org/wiki/Log-normal_distribution).

**الصيغة**

```sql theme={null}
randLogNormal(mean, stddev[, x])
```

**الوسائط**

* `mean` — متوسط التوزيع. [`Float64`](/ar/reference/data-types/float)
* `stddev` — الانحراف المعياري للتوزيع. [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويتم تجاهله. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام الاستدعاء نفسه للدالة عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا من نوع Float64 مأخوذًا من التوزيع اللوغاريتمي الطبيعي المحدد. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randLogNormal(100, 5) FROM numbers(5)
```

```response title=Response theme={null}
┌─randLogNormal(100, 5)─┐
│  1.295699673937363e48 │
│  9.719869109186684e39 │
│  6.110868203189557e42 │
│  9.912675872925529e39 │
│ 2.3564708490552458e42 │
└───────────────────────┘
```

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

أُضيف في: v22.10.0

يعيد عددًا عشوائيًا من نوع Float64 مُستمدًّا من [توزيع ذي الحدين السالب](https://en.wikipedia.org/wiki/Negative_binomial_distribution).

**البنية**

```sql theme={null}
randNegativeBinomial(experiments, probability[, x])
```

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

* `experiments` — عدد التجارب. [`UInt64`](/ar/reference/data-types/int-uint)
* `probability` — `احتمال الفشل في كل تجربة، كقيمة بين `0` و`1`. [`Float64\`]\(/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [حذف التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

يُرجع عددًا عشوائيًا من نوع Float64 مأخوذًا من توزيع ذي الحدين السالب المحدد [`UInt64`](/ar/reference/data-types/int-uint)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randNegativeBinomial(100, .75) FROM numbers(5)
```

```response title=Response theme={null}
┌─randNegativeBinomial(100, 0.75)─┐
│                              33 │
│                              32 │
│                              39 │
│                              40 │
│                              50 │
└─────────────────────────────────┘
```

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

أُضيفت في: v22.10.0

تُرجع عددًا عشوائيًا من نوع Float64 مأخوذًا من [التوزيع الطبيعي](https://en.wikipedia.org/wiki/Normal_distribution).

**الصيغة**

```sql theme={null}
randNormal(mean, stddev[, x])
```

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

* `mean` — متوسط التوزيع [`Float64`](/ar/reference/data-types/float)
* `stddev` — الانحراف المعياري للتوزيع [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويتم تجاهله. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام الاستدعاء نفسه للدالة عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا من نوع Float64 مولدًا من التوزيع الطبيعي المحدد. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randNormal(10, 2) FROM numbers(5)
```

```response title=Response theme={null}
┌──randNormal(10, 2)─┐
│ 13.389228911709653 │
│  8.622949707401295 │
│ 10.801887062682981 │
│ 4.5220192605895315 │
│ 10.901239123982567 │
└────────────────────┘
```

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

أُضيفت في: v22.10.0

تُرجع عددًا عشوائيًا من نوع Float64 مُولَّدًا وفق [توزيع بواسون](https://en.wikipedia.org/wiki/Poisson_distribution).

**الصيغة**

```sql theme={null}
randPoisson(n[, x])
```

**الوسائط**

* `n` — متوسط عدد مرات الحدوث. [`UInt64`](/ar/reference/data-types/int-uint)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذا الوسيط هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في query. [`Any`](/ar/reference/data-types/index)

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

يعيد رقمًا عشوائيًا من النوع Float64 مولَّدًا من توزيع بواسون المحدد. [`UInt64`](/ar/reference/data-types/int-uint)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randPoisson(10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randPoisson(10)─┐
│               8 │
│               8 │
│               7 │
│              10 │
│               6 │
└─────────────────┘
```

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

قُدِّم في: v22.10.0

يعيد عددًا عشوائيًا من نوع Float64 مأخوذًا من [توزيع ستودنت t](https://en.wikipedia.org/wiki/Student%27s_t-distribution).

**البنية**

```sql theme={null}
randStudentT(degree_of_freedom[, x])
```

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

* `degree_of_freedom` — درجات الحرية. [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

يعيد عددًا عشوائيًا من نوع Float64 مأخوذًا من توزيع t لستودنت المحدد. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randStudentT(10) FROM numbers(5)
```

```response title=Response theme={null}
┌─────randStudentT(10)─┐
│   1.2217309938538725 │
│   1.7941971681200541 │
│ -0.28192176076784664 │
│   0.2508897721303792 │
│  -2.7858432909761186 │
└──────────────────────┘
```

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

قُدِّم في: v22.10.0

يعيد عددًا عشوائيًا من النوع Float64 مأخوذًا بتوزيع منتظم من المجال $[\min, \max]$.

**البنية**

```sql theme={null}
randUniform(min, max[, x])
```

**الوسائط**

* `min` — الحد الأيسر للنطاق (شامل). [`Float64`](/ar/reference/data-types/float)
* `max` — الحد الأيمن للنطاق (شامل). [`Float64`](/ar/reference/data-types/float)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية المشتركة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد عددًا عشوائيًا موزعًا بانتظام ضمن الفترة المحصورة بين `min` و`max`. [`Float64`](/ar/reference/data-types/float)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randUniform(5.5, 10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randUniform(5.5, 10)─┐
│    8.094978491443102 │
│   7.3181248914450885 │
│    7.177741903868262 │
│    6.483347380953762 │
│    6.122286382885112 │
└──────────────────────┘
```

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

استُحدثت في: v20.5.0

يولّد سلسلة نصية عشوائية ثابتة الطول بعدد الأحرف المحدد.
ولا يُشترط أن تكون الأحرف المُعادة من نوع ASCII، أي إنها قد لا تكون قابلة للطباعة.

**البنية**

```sql theme={null}
randomFixedString(length)
```

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

* `length` — طول السلسلة بالبايت. [`UInt*`](/ar/reference/data-types/int-uint)

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

يُرجع سلسلة مملوءة ببايتات عشوائية. [`FixedString`](/ar/reference/data-types/fixedstring)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randomFixedString(13) AS rnd, toTypeName(rnd)
```

```response title=Response theme={null}
┌─rnd──────┬─toTypeName(randomFixedString(13))─┐
│ j▒h㋖HɨZ'▒ │ FixedString(13)                 │
└──────────┴───────────────────────────────────┘
```

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

أُضيفت في: v20.1.0

تُنشئ سلسلة [ASCII](https://en.wikipedia.org/wiki/ASCII#Printable_characters) عشوائية بعدد الأحرف المحدد.

إذا مرّرت `length < 0`، فسيكون سلوك الدالة غير معرّف.

**الصيغة**

```sql theme={null}
randomPrintableASCII(length[, x])
```

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

* `length` — طول السلسلة بالبايت. [`(U)Int*`](/ar/reference/data-types/int-uint)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية الشائعة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تُرجع سلسلة تتكوّن من مجموعة عشوائية من محارف ASCII القابلة للطباعة. [`String`](/ar/reference/data-types/string)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT number, randomPrintableASCII(30) AS str, length(str) FROM system.numbers LIMIT 3
```

```response title=Response theme={null}
┌─number─┬─str────────────────────────────┬─length(randomPrintableASCII(30))─┐
│      0 │ SuiCOSTvC0csfABSw=UcSzp2.`rv8x │                               30 │
│      1 │ 1Ag NlJ &RCN:*>HVPG;PE-nO"SUFD │                               30 │
│      2 │ /"+<"with:=LjJ Vm!c&hI*m#XTfzz │                               30 │
└────────┴────────────────────────────────┴──────────────────────────────────┘
```

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

أُضيفت في: v20.5.0

يُنشئ سلسلة نصية عشوائية بعدد الأحرف المحدد.
الأحرف المُعادة ليست بالضرورة من نوع ASCII، أي إنها قد لا تكون قابلة للطباعة.

**البنية**

```sql theme={null}
randomString(length[, x])
```

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

* `length` — طول السلسلة بالبايت. [`(U)Int*`](/ar/reference/data-types/int-uint)
* `x` — اختياري ويُتجاهل. الغرض الوحيد من هذه الوسيطة هو منع [إزالة التعبيرات الفرعية الشائعة](/ar/reference/functions/regular-functions/overview#common-subexpression-elimination) عند استخدام استدعاء الدالة نفسه عدة مرات في استعلام. [`Any`](/ar/reference/data-types/index)

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

تعيد سلسلة مملوءة ببايتات عشوائية. [`String`](/ar/reference/data-types/string)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randomString(5) AS str FROM numbers(2)
```

```response title=Response theme={null}
���
�v6B�
```

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

أُضيفت في: v20.5.0

ينشئ سلسلة [UTF-8](https://en.wikipedia.org/wiki/UTF-8) عشوائية بعدد نقاط الترميز المحدد.
لا يُعاد أيٌّ من نقاط الترميز من [المستويات](https://en.wikipedia.org/wiki/Plane_\(Unicode\)) غير المعيّنة (المستويات من 4 إلى 13).
ومع ذلك، قد لا يتمكن العميل الذي يتفاعل مع خادم ClickHouse من عرض سلسلة UTF-8 الناتجة بشكل صحيح.

**الصيغة**

```sql theme={null}
randomStringUTF8(length)
```

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

* `length` — طول السلسلة بنقاط الترميز. [`(U)Int*`](/ar/reference/data-types/int-uint)

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

يعيد سلسلة مملوءة بنقاط ترميز UTF-8 عشوائية. [`String`](/ar/reference/data-types/string)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT randomStringUTF8(13)
```

```response title=Response theme={null}
┌─randomStringUTF8(13)─┐
│ 𘤗𙉝д兠庇󡅴󱱎󦐪􂕌𔊹𓰛       │
└──────────────────────┘
```