generateRandom

Gera dados aleatórios com um schema especificado. Permite preencher tabelas de teste com esses dados. Há suporte para todos os tipos de dados que podem ser armazenados em uma tabela, incluindo JSON, Dynamic, Variant, BFloat16, Time e Time64. Não há suporte para os tipos AggregateFunction, Interval, Nothing e QBit.

Sintaxe

generateRandom(['name TypeName[, name TypeName]...', [, 'random_seed'[, 'max_string_length'[, 'max_array_length']]]][, SETTINGS setting = value[, ...]])

Argumentos

Argumento	Descrição
`name`	Nome da coluna correspondente.
`TypeName`	Tipo da coluna correspondente.
`random_seed`	Defina manualmente a semente aleatória para gerar resultados estáveis. Se `NULL` — a semente é gerada aleatoriamente.
`max_string_length`	Comprimento máximo de todas as strings geradas. O padrão é `10`.
`max_array_length`	Número máximo de elementos de todos os arrays ou maps gerados. O padrão é `10`.

Configurações

SETTINGS é o último argumento da chamada e controla como são gerados os valores Nullable, Variant, Dynamic e JSON.

Configuração	Tipo	Padrão	Descrição
`null_ratio`	`Float`	`0.0625`	Probabilidade de um valor `Nullable`, `Variant` ou `Dynamic` ser `NULL` e probabilidade inicial de uma chave `JSON` estar ausente de uma linha — uma minoria das chaves esparsas fica ausente com frequência várias vezes maior. Deve estar em `[0, 1]`.
`max_json_depth`	`UInt64`	`3`	Profundidade máxima de aninhamento dos objetos `JSON` gerados: `1` significa objetos sem aninhamento; objetos dentro de arrays contam como um nível. Deve estar em `[1, 32]`.
`max_json_keys_per_object`	`UInt64`	`8`	Número máximo de chaves geradas em um nível de um objeto `JSON`; o objeto raiz recebe pelo menos metade desse número. `0` significa que apenas caminhos tipados são gerados. No máximo `1000`.

SELECT * FROM generateRandom('x JSON', 3, 4, 2, SETTINGS max_json_depth = 1, max_json_keys_per_object = 3) LIMIT 3 FORMAT JSONEachRow;

{"x":{"cursor":"","id":[],"parent":-3723905664592977020}}
{"x":{"cursor":"","id":[7037090064212902336]}}
{"x":{"id":[287913403506346525],"parent":-4417942528676528098}}

SETTINGS também pode ser o único argumento, preservando a estrutura da tabela de inserção:

INSERT INTO test_table SELECT * FROM generateRandom(SETTINGS null_ratio = 0.5) LIMIT 10;

Valor retornado

Um objeto de tabela com o esquema solicitado.

Exemplo de uso

SELECT * FROM generateRandom('a Array(Int8), d Decimal32(4), c Tuple(DateTime64(3), UUID)', 1, 10, 2) LIMIT 3;

┌─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') │
└──────────┴──────────────┴────────────────────────────────────────────────────────────────────┘

CREATE TABLE random (a Array(Int8), d Decimal32(4), c Tuple(DateTime64(3), UUID)) ENGINE=Memory;
INSERT INTO random SELECT * FROM generateRandom() LIMIT 2;
SELECT * FROM random;

┌─a────────────────────────────┬────────────d─┬─c──────────────────────────────────────────────────────────────────┐
│ []                           │   68091.8197 │ ('2037-10-02 12:44:23.368','039ecab7-81c2-45ee-208c-844e5c6c5652') │
│ [8,-83,0,-22,65,9,-30,28,64] │ -186233.4909 │ ('2062-01-11 00:06:04.124','69563ea1-5ad1-f870-16d8-67061da0df25') │
└──────────────────────────────┴──────────────┴────────────────────────────────────────────────────────────────────┘

Em conjunto com generateRandomStructure:

SELECT * FROM generateRandom(generateRandomStructure(4, 101), 101) LIMIT 3;

┌──────────────────c1─┬──────────────────c2─┬─c3─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬─c4──────────────────────────────────────┐
│ 1996-04-15 06:40:05 │ 33954608387.2844801 │ ['232.78.216.176','9.244.59.211','211.21.80.152','44.49.94.109','165.77.195.182','68.167.134.239','212.13.24.185','1.197.255.35','192.55.131.232'] │ 45d9:2b52:ab6:1c59:185b:515:c5b6:b781   │
│ 2063-01-13 01:22:27 │ 36155064970.9514454 │ ['176.140.188.101']                                                                                                                                │ c65a:2626:41df:8dee:ec99:f68d:c6dd:6b30 │
│ 2090-02-28 14:50:56 │  3864327452.3901373 │ ['155.114.30.32']                                                                                                                                  │ 57e9:5229:93ab:fbf3:aae7:e0e4:d1eb:86b  │
└─────────────────────┴─────────────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────┘

Sem informar o argumento structure (neste caso, a estrutura é aleatória):

SELECT * FROM generateRandom() LIMIT 3;

┌───c1─┬─────────c2─┬─────────────────────c3─┬──────────────────────c4─┬─c5───────┐
│ -128 │  317300854 │ 2030-08-16 08:22:20.65 │ 1994-08-16 12:08:56.745 │ R0qgiC46 │
│   40 │ -744906827 │ 2059-04-16 06:31:36.98 │ 1975-07-16 16:28:43.893 │ PuH4M*MZ │
│  -55 │  698652232 │ 2052-08-04 20:13:39.68 │ 1998-09-20 03:48:29.279 │          │
└──────┴────────────┴────────────────────────┴─────────────────────────┴──────────┘

Com semente aleatória tanto para a estrutura aleatória quanto para os dados aleatórios:

SELECT * FROM generateRandom(11) LIMIT 3;

┌───────────────────────────────────────c1─┬─────────────────────────────────────────────────────────────────────────────c2─┬─────────────────────────────────────────────────────────────────────────────c3─┬─────────c4─┬─────────────────────────────────────────────────────────────────────────────c5─┬──────────────────────c6─┬─c7──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬─c8──────────────────────────────────────┬─────────c9─┐
│  -77422512305044606600216318673365695785 │   636812099959807642229.503817849012019401335326013846687285151335352272727523 │ -34944452809785978175157829109276115789694605299387223845886143311647505037529 │  544473976 │ 111220388331710079615337037674887514156741572807049614590010583571763691328563 │       22016.22623506465 │ {'2052-01-31 20:25:33':4306400876908509081044405485378623663,'1993-04-16 15:58:49':164367354809499452887861212674772770279,'2101-08-19 03:07:18':-60676948945963385477105077735447194811,'2039-12-22 22:31:39':-59227773536703059515222628111999932330} │ a7b2:8f58:4d07:6707:4189:80cf:92f5:902d │ 1950-07-14 │
│ -159940486888657488786004075627859832441 │  629206527868163085099.8195700356331771569105231840157308480121506729741348442 │ -53203761250367440823323469081755775164053964440214841464405368882783634063735 │ 2187136525 │  94881662451116595672491944222189810087991610568040618106057495823910493624275 │ 1.3095786748458954e-104 │ {}                                                                                                                                                                                                                                                      │ a051:e3da:2e0a:c69:7835:aed6:e8b:3817   │ 1943-03-25 │
│   -5239084224358020595591895205940528518 │ -529937657954363597180.1709207212648004850138812370209091520162977548101577846 │  47490343304582536176125359129223180987770215457970451211489086575421345731671 │ 1637451978 │ 101899445785010192893461828129714741298630410942962837910400961787305271699002 │  2.4344456058391296e223 │ {'2013-12-22 17:42:43':80271108282641375975566414544777036006,'2041-03-08 10:28:17':169706054082247533128707458270535852845,'1986-08-31 23:07:38':-54371542820364299444195390357730624136,'2094-04-23 21:26:50':7944954483303909347454597499139023465}  │ 1293:a726:e899:9bfc:8c6f:2aa1:22c9:b635 │ 1924-11-20 │
└──────────────────────────────────────────┴────────────────────────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────────────────────────┴────────────┴────────────────────────────────────────────────────────────────────────────────┴─────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────┴────────────┘

generateRandom(generateRandomStructure(), [random seed], max_string_length, max_array_length) com um max_array_length grande o suficiente pode gerar uma saída realmente enorme devido à profundidade potencialmente grande de aninhamento (até 16) de tipos complexos (Array, Tuple, Map, Nested).

Gerando JSON

Uma coluna JSON gerada se comporta como um fluxo de documentos com o mesmo schema: o conjunto de chaves e o tipo de cada chave são determinados pela semente aleatória e permanecem iguais em toda a coluna, enquanto os valores, as chaves ausentes e os tamanhos dos arrays variam de uma linha para outra. A profundidade dos objetos é limitada por max_json_depth, o número de chaves por nível por max_json_keys_per_object, e cada chave tem uma probabilidade null_ratio de estar ausente em uma linha. Os valores nas folhas assumem os tipos que o parser de JSON infere em documentos reais: Int64, UInt64, Float64, Bool, String, Date, DateTime, arrays desses tipos, arrays de objetos e arrays mistos; algumas chaves têm um tipo diferente em uma pequena fração das linhas, como acontece com dados coletados de uma aplicação. A declaração de tipo determina o schema gerado: os caminhos tipados estão sempre presentes com o tipo declarado, os caminhos excluídos por SKIP e SKIP REGEXP nunca são gerados, e os limites de max_dynamic_paths e max_dynamic_types são respeitados. Assim, os caminhos que excedem max_dynamic_paths ficam nos dados compartilhados da coluna.

SELECT * FROM generateRandom('x JSON', 1) LIMIT 3 FORMAT JSONEachRow;

{"x":{"product_id":"2050-12-17 01:46:35","stage":"g|(&Ql","started":{"group":-80611897324989285}}}
{"x":{"product_id":"2013-10-17 22:35:26","stage":"^ipx|,=a5N","started":{"group":-1326235429680389454}}}
{"x":{"product_id":"1974-11-17 22:22:46","stage":"(U]p'l`","started":{"group":-344141642787805595}}}

A definição da estrutura também pode ficar a cargo da tabela de inserção, o que é útil para preencher uma tabela com colunas dos tipos JSON, Dynamic ou Variant:

CREATE TABLE t (x JSON) ENGINE = MergeTree ORDER BY tuple();
INSERT INTO t SELECT * FROM generateRandom() LIMIT 10;

Blog: Como gerar dados aleatórios no ClickHouse

Referência de SQL

Tipos de dados

Motores

Funções

Formatos

Configurações

Tabelas de sistema

Lagos de dados

Sintaxe

Argumentos

Configurações

Valor retornado

Exemplo de uso

Gerando JSON

​Sintaxe

​Argumentos

​Configurações

​Valor retornado

​Exemplo de uso

​Gerando JSON

​Conteúdo relacionado

Sintaxe

Argumentos

Configurações

Valor retornado

Exemplo de uso

Gerando JSON

Conteúdo relacionado