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

> Документация по функциям, используемым для генерации случайных чисел

# Функции для генерации случайных чисел

Все функции в этом разделе принимают ноль или один аргумент. Единственное назначение аргумента (если он указан) — предотвратить [устранение общих
подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), чтобы два разных вызова одной и той же функции генерации случайных
чисел в пределах одной строки возвращали разные случайные значения.

Связанные материалы

* Руководство: [Генерация случайных данных в ClickHouse](/ru/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`](/ru/reference/data-types/string) или [`FixedString`](/ru/reference/data-types/fixedstring)
* `p` — Вероятность инверсии каждого бита, число от `0.0` до `1.0` [`Float*`](/ru/reference/data-types/float)

**Возвращаемое значение**

Возвращает строку с фаззинг-искажением того же типа, что и `s`: [`String`](/ru/reference/data-types/string) или [`FixedString`](/ru/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` — необязательный, игнорируется. Единственное назначение этого аргумента — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), если один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа `UInt32`. [`UInt32`](/ru/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` — необязательный аргумент, который игнорируется. Единственное назначение этого аргумента — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа UInt64 с равномерным распределением. [`UInt64`](/ru/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`](/ru/reference/data-types/float)
* `x` — Необязательный аргумент, который игнорируется. Его единственное назначение — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число `Float64`, сгенерированное из указанного распределения Бернулли. [`UInt64`](/ru/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`](/ru/reference/data-types/int-uint)
* `probability` — Вероятность успеха в каждом испытании, значение от `0` до `1` [`Float64`](/ru/reference/data-types/float)
* `x` — Необязательный аргумент, который игнорируется. Его единственное назначение — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), если один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число `Float64`, сгенерированное по указанному биномиальному распределению. [`UInt64`](/ru/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` — необязательный аргумент, который игнорируется. Его единственное назначение — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64. [`Float64`](/ru/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`](/ru/reference/data-types/float)
* `x` — Необязательный параметр, который игнорируется. Его единственная цель — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется несколько раз в запросе. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64 из указанного распределения хи-квадрат. [`Float64`](/ru/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` — необязательный и игнорируется. Единственное назначение этого аргумента — предотвращать [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает столбец типа `UInt32`, содержащий одно и то же случайное значение в каждой строке. [`UInt32`](/ru/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`](/ru/reference/data-types/float)
* `x` — Необязательный, игнорируется. Единственное назначение этого аргумента — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64 из указанного экспоненциального распределения. [`Float64`](/ru/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`](/ru/reference/data-types/float)
* `d2` — число степеней свободы d2 в `X = (S1 / d1) / (S2 / d2)`. [`Float64`](/ru/reference/data-types/float)
* `x` — Необязателен и игнорируется. Единственное назначение этого аргумента — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64 из указанного F-распределения [`Float64`](/ru/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`](/ru/reference/data-types/float)
* `stddev` — Стандартное отклонение распределения. [`Float64`](/ru/reference/data-types/float)
* `x` — Необязательный аргумент, который игнорируется. Единственное назначение этого аргумента — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), если один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64 из указанного логнормального распределения. [`Float64`](/ru/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`](/ru/reference/data-types/int-uint)
* `probability` — `Вероятность неудачи в каждом эксперименте, задаваемая значением от `0`до`1`. [`Float64\`]\(/reference/data-types/float)
* `x` — Необязательный и игнорируется. Единственное назначение этого аргумента — предотвращать [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64 из указанного отрицательного биномиального распределения [`UInt64`](/ru/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`](/ru/reference/data-types/float)
* `stddev` — Стандартное отклонение распределения [`Float64`](/ru/reference/data-types/float)
* `x` — Необязательный аргумент, который игнорируется. Его единственное назначение — предотвращать [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число `Float64`, выбранное из указанного нормального распределения. [`Float64`](/ru/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`](/ru/reference/data-types/int-uint)
* `x` — Необязательный аргумент, который игнорируется. Его единственное назначение — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется несколько раз в запросе. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число `Float64`, полученное из указанного распределения Пуассона. [`UInt64`](/ru/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`](/ru/reference/data-types/float)
* `x` — Необязательный аргумент, который игнорируется. Его единственное назначение — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число типа Float64, сгенерированное из указанного t-распределения Стьюдента. [`Float64`](/ru/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`](/ru/reference/data-types/float)
* `max` — Правая граница диапазона (включительно). [`Float64`](/ru/reference/data-types/float)
* `x` — Необязателен и игнорируется. Единственная цель этого аргумента — предотвратить [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется несколько раз в запросе. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает случайное число с равномерным распределением на интервале между `min` и `max`. [`Float64`](/ru/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*`](/ru/reference/data-types/int-uint)

**Возвращаемое значение**

Возвращает строку, заполненную случайными байтами. [`FixedString`](/ru/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*`](/ru/reference/data-types/int-uint)
* `x` — Необязательный игнорируемый параметр. Единственное назначение этого аргумента — предотвращать [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает строку со случайным набором печатных символов ASCII. [`String`](/ru/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*`](/ru/reference/data-types/int-uint)
* `x` — Необязательный аргумент, который игнорируется. Его единственное назначение — предотвращать [устранение общих подвыражений](/ru/reference/functions/regular-functions/overview#common-subexpression-elimination), когда один и тот же вызов функции используется в запросе несколько раз. [`Any`](/ru/reference/data-types/index)

**Возвращаемое значение**

Возвращает строку, заполненную случайными байтами. [`String`](/ru/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*`](/ru/reference/data-types/int-uint)

**Возвращаемое значение**

Возвращает строку из случайных кодовых точек UTF-8. [`String`](/ru/reference/data-types/string)

**Примеры**

**Пример использования**

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

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