ClickHouse/docs/ru/sql-reference/table-functions/generate.md

42 lines
2.5 KiB
Markdown
Raw Normal View History

---
sidebar_position: 47
sidebar_label: generateRandom
---
# generateRandom {#generaterandom}
2020-02-04 10:59:26 +00:00
Генерирует случайные данные с заданной схемой.
Позволяет заполнять тестовые таблицы данными.
2020-02-04 12:25:09 +00:00
Поддерживает все типы данных, которые могут храниться в таблице, за исключением `LowCardinality` и `AggregateFunction`.
2020-02-04 10:59:26 +00:00
``` sql
generateRandom('name TypeName[, name TypeName]...', [, 'random_seed'[, 'max_string_length'[, 'max_array_length']]])
2020-02-04 10:59:26 +00:00
```
**Аргументы**
2020-02-04 10:59:26 +00:00
- `name` — название соответствующего столбца.
- `TypeName` — тип соответствующего столбца.
- `max_array_length` — максимальная длина массива для всех сгенерированных массивов. По умолчанию `10`.
- `max_string_length` — максимальная длина строки для всех генерируемых строк. По умолчанию `10`.
2020-04-24 21:47:27 +00:00
- `random_seed` — укажите состояние генератора случайных чисел вручную, чтобы получить стабильные результаты. Если значение равно `NULL` - генератор инициализируется случайным состоянием.
2020-02-04 10:59:26 +00:00
**Возвращаемое значение**
Объект таблицы с запрошенной схемой.
## Пример {#primer}
2020-02-04 10:59:26 +00:00
``` sql
2020-04-24 21:47:27 +00:00
SELECT * FROM generateRandom('a Array(Int8), d Decimal32(4), c Tuple(DateTime64(3), UUID)', 1, 10, 2) LIMIT 3;
2020-02-04 10:59:26 +00:00
```
``` text
2020-02-04 10:59:26 +00:00
┌─a────────┬────────────d─┬─c──────────────────────────────────────────────────────────────────┐
│ [77] │ -124167.6723 │ ('2061-04-17 21:59:44.573','3f72f405-ec3e-13c8-44ca-66ef335f7835') │
│ [32,110] │ -141397.7312 │ ('1979-02-09 03:43:48.526','982486d1-5a5d-a308-e525-7bd8b80ffa73') │
│ [68] │ -67417.0770 │ ('2080-03-12 14:17:31.269','110425e5-413f-10a6-05ba-fa6b3e929f15') │
└──────────┴──────────────┴────────────────────────────────────────────────────────────────────┘
```