ランダム数生成用の関数

このセクションのすべての関数は、0または1個の引数を受け取ります。引数を提供した場合の唯一の目的は、同じランダム関数が行内で異なる実行を行った際に、異なるランダム値が返されるようにするためです。

rand

一様分布のもとでランダムなUInt32数を返します。

システムから取得した初期状態を使用した線形合同生成器を利用しています。これは、見た目にはランダムですが、実際にはランダムではなく、初期状態が知られている場合は予測可能です。真のランダム性が重要なシナリオでは、システムレベルの呼び出しや外部ライブラリとの統合など、代替手段の使用を検討してください。

構文

rand()

エイリアス: rand32

引数

なし。

戻り値

UInt32型の数値を返します。

例

SELECT rand();

1569354847 -- 注意: 実際の出力はランダムな数値であり、例に示された特定の数字ではありません。

rand64

ランダムなUInt64整数 (UInt64) 数を返します。

構文

rand64()

引数

なし。

戻り値

一様分布のもとでランダムなUInt64数を返します。

例

SELECT rand64();

15030268859237645412 -- 注意: 実際の出力はランダムな数値であり、例に示された特定の数字ではありません。

randCanonical

ランダムなFloat64数を返します。

構文

randCanonical()

引数

なし。

戻り値

0（含む）から1（含まない）の範囲のFloat64値を返します。

例

SELECT randCanonical();

0.3452178901234567 - 注意: 実際の出力は0と1の間のランダムなFloat64数であり、例に示された特定の数字ではありません。

randConstant

ランダムな値で埋められた単一の定数カラムを生成します。randとは異なり、この関数は生成されたカラムの各行に同じランダム値が現れることを保証するため、単一のクエリ内の行間で一貫したランダムシードが必要なシナリオに役立ちます。

構文

randConstant([x]);

引数

[x]（オプション）: 生成されるランダム値に影響を与えるオプションの式です。提供された場合でも、同じクエリ実行内では結果の値は常に一定です。同じ式を使用する異なるクエリでは、異なる定数値が生成される可能性があります。

戻り値

各行に同じランダム値を持つUInt32型のカラムを返します。

実装の詳細

実際の出力は、同じオプション式であっても、各クエリの実行ごとに異なります。オプションのパラメータは、単独でrandConstantを使用するのと比較して生成される値を大きく変更しない場合があります。

例

SELECT randConstant() AS random_value;

| random_value |
|--------------|
| 1234567890   |

SELECT randConstant(10) AS random_value;

| random_value |
|--------------|
| 9876543210   |

randUniform

minからmaxの間の一様に描かれたランダムなFloat64を返します。

構文

randUniform(min, max)

引数

min - Float64 - 範囲の左端、
max - Float64 - 範囲の右端。

戻り値

Float64型のランダムな数を返します。

例

SELECT randUniform(5.5, 10) FROM numbers(5)

┌─randUniform(5.5, 10)─┐
│    8.094978491443102 │
│   7.3181248914450885 │
│    7.177741903868262 │
│    6.483347380953762 │
│    6.122286382885112 │
└──────────────────────┘

randNormal

正規分布から描かれたランダムなFloat64を返します。

構文

randNormal(mean, stddev)

引数

mean - Float64 - 分布の平均値、
stddev - Float64 - 分布の標準偏差。

戻り値

ランダムな数。Float64。

例

SELECT randNormal(10, 2) FROM numbers(5)

結果:

┌──randNormal(10, 2)─┐
│ 13.389228911709653 │
│  8.622949707401295 │
│ 10.801887062682981 │
│ 4.5220192605895315 │
│ 10.901239123982567 │
└────────────────────┘

randLogNormal

対数正規分布から描かれたランダムなFloat64を返します。

構文

randLogNormal(mean, stddev)

引数

mean - Float64 - 分布の平均値、
stddev - Float64 - 標準偏差。

戻り値

ランダムな数。Float64。

例

SELECT randLogNormal(100, 5) FROM numbers(5)

結果:

┌─randLogNormal(100, 5)─┐
│  1.295699673937363e48 │
│  9.719869109186684e39 │
│  6.110868203189557e42 │
│  9.912675872925529e39 │
│ 2.3564708490552458e42 │
└───────────────────────┘

randBinomial

二項分布から描かれたランダムなUInt64を返します。

構文

randBinomial(experiments, probability)

引数

experiments - UInt64 - 実験の数、
probability - Float64 - 各実験での成功の確率、0から1の間の値。

戻り値

ランダムな数。UInt64。

例

SELECT randBinomial(100, .75) FROM numbers(5)

結果:

┌─randBinomial(100, 0.75)─┐
│                      74 │
│                      78 │
│                      76 │
│                      77 │
│                      80 │
└─────────────────────────┘

randNegativeBinomial

負の二項分布から描かれたランダムなUInt64を返します。

構文

randNegativeBinomial(experiments, probability)

引数

experiments - UInt64 - 実験の数、
probability - Float64 - 各実験での失敗の確率、0から1の間の値。

戻り値

ランダムな数。UInt64。

例

SELECT randNegativeBinomial(100, .75) FROM numbers(5)

結果:

┌─randNegativeBinomial(100, 0.75)─┐
│                              33 │
│                              32 │
│                              39 │
│                              40 │
│                              50 │
└─────────────────────────────────┘

randPoisson

ポアソン分布から描かれたランダムなUInt64を返します。

構文

randPoisson(n)

引数

n - UInt64 - 発生の平均回数。

戻り値

ランダムな数。UInt64。

例

SELECT randPoisson(10) FROM numbers(5)

結果:

┌─randPoisson(10)─┐
│               8 │
│               8 │
│               7 │
│              10 │
│               6 │
└─────────────────┘

randBernoulli

ベルヌーイ分布から描かれたランダムなUInt64を返します。

構文

randBernoulli(probability)

引数

probability - Float64 - 成功の確率、0から1の間の値。

戻り値

ランダムな数。UInt64。

例

SELECT randBernoulli(.75) FROM numbers(5)

結果:

┌─randBernoulli(0.75)─┐
│                   1 │
│                   1 │
│                   0 │
│                   1 │
│                   1 │
└─────────────────────┘

randExponential

指数分布から描かれたランダムなFloat64を返します。

構文

randExponential(lambda)

引数

lambda - Float64 - ラムダ値。

戻り値

ランダムな数。Float64。

例

SELECT randExponential(1/10) FROM numbers(5)

結果:

┌─randExponential(divide(1, 10))─┐
│              44.71628934340778 │
│              4.211013337903262 │
│             10.809402553207766 │
│              15.63959406553284 │
│             1.8148392319860158 │
└────────────────────────────────┘

randChiSquared

カイ二乗分布から描かれたランダムなFloat64を返します - k個の独立した標準正規分布の乱数の平方の合計の分布です。

構文

randChiSquared(degree_of_freedom)

引数

degree_of_freedom - Float64 - 自由度。

戻り値

ランダムな数。Float64。

例

SELECT randChiSquared(10) FROM numbers(5)

結果:

┌─randChiSquared(10)─┐
│ 10.015463656521543 │
│  9.621799919882768 │
│   2.71785015634699 │
│ 11.128188665931908 │
│  4.902063104425469 │
└────────────────────┘

randStudentT

スチューデントのt分布から描かれたランダムなFloat64を返します。

構文

randStudentT(degree_of_freedom)

引数

degree_of_freedom - Float64 - 自由度。

戻り値

ランダムな数。Float64。

例

SELECT randStudentT(10) FROM numbers(5)

結果:

┌─────randStudentT(10)─┐
│   1.2217309938538725 │
│   1.7941971681200541 │
│ -0.28192176076784664 │
│   0.2508897721303792 │
│  -2.7858432909761186 │
└──────────────────────┘

randFisherF

F分布から描かれたランダムなFloat64を返します。

構文

randFisherF(d1, d2)

引数

d1 - Float64 - X = (S1 / d1) / (S2 / d2)におけるd1自由度、
d2 - Float64 - X = (S1 / d1) / (S2 / d2)におけるd2自由度。

戻り値

ランダムな数。Float64。

例

SELECT randFisherF(10, 3) FROM numbers(5)

結果:

┌──randFisherF(10, 3)─┐
│   7.286287504216609 │
│ 0.26590779413050386 │
│ 0.22207610901168987 │
│  0.7953362728449572 │
│ 0.19278885985221572 │
└─────────────────────┘

randomString

指定された長さのランダムバイト（ゼロバイトを含む）で埋められた文字列を生成します。すべての文字が表示可能であるとは限りません。

構文

randomString(length)

引数

length — バイト単位の文字列の長さ。正の整数。

戻り値

ランダムなバイトで埋められた文字列。String。

例

クエリ:

SELECT randomString(30) AS str, length(str) AS len FROM numbers(2) FORMAT Vertical;

結果:

Row 1:
──────
str: 3 G  :   pT ?w тi  k aV f6
len: 30

Row 2:
──────
str: 9 ,]    ^   )  ]??  8
len: 30

randomFixedString

指定された長さのランダムバイト（ゼロバイトを含む）で埋められたバイナリ文字列を生成します。すべての文字が表示可能であるとは限りません。

構文

randomFixedString(length);

引数

length — バイト単位の文字列の長さ。UInt64。

戻り値

ランダムなバイトで埋められた文字列。FixedString。

例

クエリ:

SELECT randomFixedString(13) as rnd, toTypeName(rnd)

結果:

┌─rnd──────┬─toTypeName(randomFixedString(13))─┐
│ j▒h㋖HɨZ'▒ │ FixedString(13)                 │
└──────────┴───────────────────────────────────┘

randomPrintableASCII

ランダムなセットのASCII文字で埋められた文字列を生成します。すべての文字が表示可能です。 length < 0を渡すと、関数の動作は未定義です。

構文

randomPrintableASCII(length)

引数

length — バイト単位の文字列の長さ。正の整数。

戻り値

ランダムなセットのASCII表示可能な文字で埋められた文字列。String

例

SELECT number, randomPrintableASCII(30) as str, length(str) FROM system.numbers LIMIT 3

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

randomStringUTF8

指定された長さのランダムな文字列を生成します。結果の文字列は有効なUTF-8コードポイントを含みます。コードポイントの値は、割り当てられたUnicodeの範囲の外にある場合があります。

構文

randomStringUTF8(length);

引数

length — コードポイント単位の文字列の長さ。UInt64。

戻り値

UTF-8のランダムな文字列。String。

例

クエリ:

SELECT randomStringUTF8(13)

結果:

┌─randomStringUTF8(13)─┐
│ 𘤗𙉝д兠庇󡅴󱱎󦐪􂕌𔊹𓰛   │
└──────────────────────┘

fuzzBits

構文

文字列またはFixedString sのビットを、確率probで反転します。

構文

fuzzBits(s, prob)

引数

s - StringまたはFixedString、
prob - 定数 Float32/64 0.0と1.0の間。

戻り値

sと同じ型のノイズを加えた文字列。

例

SELECT fuzzBits(materialize('abacaba'), 0.1)
FROM numbers(3)

結果:

┌─fuzzBits(materialize('abacaba'), 0.1)─┐
│ abaaaja                               │
│ a*cjab+                               │
│ aeca2A                                │
└───────────────────────────────────────┘

rand​

rand64​

randCanonical​

randConstant​

randUniform​

randNormal​

randLogNormal​

randBinomial​

randNegativeBinomial​

randPoisson​

randBernoulli​

randExponential​

randChiSquared​

randStudentT​

randFisherF​

randomString​

randomFixedString​

randomPrintableASCII​

randomStringUTF8​

fuzzBits​

rand

rand64

randCanonical

randConstant

randUniform

randNormal

randLogNormal

randBinomial

randNegativeBinomial

randPoisson

randBernoulli

randExponential

randChiSquared

randStudentT

randFisherF

randomString

randomFixedString

randomPrintableASCII

randomStringUTF8

fuzzBits