generateRandom

지정된 스키마로 무작위 데이터를 생성합니다. 이 데이터로 테스트 테이블을 채울 수 있습니다. JSON, Dynamic, Variant, BFloat16, Time, Time64를 포함하여 테이블에 저장할 수 있는 모든 데이터 타입을 지원합니다. AggregateFunction, Interval, Nothing, QBit 타입은 지원하지 않습니다.

구문

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

인수

인수	설명
`name`	대응하는 컬럼의 이름입니다.
`TypeName`	대응하는 컬럼의 유형입니다.
`random_seed`	일관된 결과를 얻도록 랜덤 시드를 수동으로 지정합니다. `NULL`이면 시드는 무작위로 생성됩니다.
`max_string_length`	생성되는 모든 문자열의 최대 길이입니다. 기본값은 `10`입니다.
`max_array_length`	생성되는 모든 배열 또는 맵의 최대 요소 수입니다. 기본값은 `10`입니다.

설정

SETTINGS는 호출의 마지막 인수로, Nullable, Variant, Dynamic, JSON 값이 생성되는 방식을 제어합니다.

설정	유형	기본값	설명
`null_ratio`	`Float`	`0.0625`	`Nullable`, `Variant`, `Dynamic` 값이 `NULL`일 확률이자 `JSON` 키가 행에 존재하지 않을 기본 확률입니다. 일부 희소 키는 이보다 몇 배 더 자주 누락됩니다. `[0, 1]` 범위의 값이어야 합니다.
`max_json_depth`	`UInt64`	`3`	생성되는 `JSON` 객체의 최대 중첩 깊이입니다. `1`은 중첩되지 않은 객체를 뜻하며, 배열 안의 객체도 깊이를 계산할 때 하나의 수준으로 셉니다. `[1, 32]` 범위의 값이어야 합니다.
`max_json_keys_per_object`	`UInt64`	`8`	`JSON` 객체의 한 수준에서 생성되는 키의 최대 개수입니다. 루트 객체에는 이 값의 절반 이상의 키가 생성됩니다. `0`이면 타입이 지정된 경로만 생성됩니다. 최대 `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만 인수로 지정하면 삽입 테이블의 구조가 유지됩니다.

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

반환 값

요청한 스키마의 테이블 객체입니다.

사용 예시

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

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

structure 인수가 없으면(이 경우 구조는 임의로 정해집니다):

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

무작위 구조와 무작위 데이터 모두에 대해 랜덤 시드를 사용하는 경우:

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

충분히 큰 max_array_length를 사용하는 generateRandom(generateRandomStructure(), [random seed], max_string_length, max_array_length)는 복합 타입(Array, Tuple, Map, Nested)의 중첩 깊이가 커질 수 있어(최대 16) 매우 큰 출력을 생성할 수 있습니다.

JSON 생성

생성된 JSON 컬럼은 단일 스키마를 따르는 문서 스트림처럼 읽힙니다. 키의 집합과 각 키의 타입은 랜덤 시드에 따라 결정되어 컬럼 전체에서 동일하게 유지되지만, 값과 누락되는 키, 배열 길이는 행마다 달라집니다. 객체의 깊이는 max_json_depth, 각 계층의 키 수는 max_json_keys_per_object로 제한되며, 각 키는 null_ratio의 확률로 행에서 누락됩니다. 최하위 값에는 JSON 파서가 실제 문서에서 추론하는 타입이 사용됩니다. 여기에는 Int64, UInt64, Float64, Bool, String, Date, DateTime, 이러한 타입의 배열, 객체 배열, 혼합 배열이 포함됩니다. 애플리케이션에서 수집한 데이터와 마찬가지로 일부 키는 소수의 행에서 다른 타입을 가집니다. 타입 선언에 따라 생성되는 스키마가 달라집니다. 타입이 지정된 경로는 선언된 타입으로 항상 존재하고, SKIP과 SKIP REGEXP로 제외된 경로는 생성되지 않습니다. 또한 max_dynamic_paths와 max_dynamic_types 제한이 모두 적용되므로 max_dynamic_paths를 초과하는 경로는 컬럼의 공유 데이터에 저장됩니다.

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}}}

데이터 구조를 삽입 테이블의 스키마에 맡길 수도 있습니다. JSON, Dynamic, Variant 컬럼이 있는 테이블에 데이터를 삽입할 때 유용합니다.

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

블로그: ClickHouse에서 무작위 데이터 생성

SQL 참고

데이터 타입

엔진

함수

포맷

설정

시스템 테이블

데이터 레이크

구문

인수

설정

반환 값

사용 예시

JSON 생성

​구문

​인수

​설정

​반환 값

​사용 예시

​JSON 생성

​관련 콘텐츠

구문

인수

설정

반환 값

사용 예시

JSON 생성

관련 콘텐츠