に最終更新
UNIFORM
説明
指定した乱数シードを使用して、特定の範囲内の乱数を一様にサンプリングして生成します。
構文
UNIFORM( <min> , <max> , <gen> )
パラメータ
| パラメータ | 説明 |
|---|---|
<min> | 乱数の下限。数値型を受け付けます。リテラルである必要があります。 |
<max> | 乱数の上限。数値型を受け付けます。リテラルである必要があります。 |
<gen> | 整数型の乱数シード。通常は RANDOM 関数でランダムに生成します。 |
戻り値
[<min>, <max>] の範囲内の乱数を返します。<min> と <max> が両方とも整数の場合、戻り値の型は BIGINT です。それ以外の場合は DOUBLE です。
Snowflake での 一般的な使い方 とは異なり、Doris の RANDOM 関数はデフォルトで 0 から 1 の範囲の浮動小数点数を返します。そのため、RANDOM() を乱数シードとして使用する場合は、結果が整数の範囲に分布するように乗数を掛ける必要があります。詳しくは例を参照してください。
例
入力パラメータがすべて整数の場合は、整数を返します。
select uniform(-100, 100, random() * 10000) as result from numbers("number" = "10");
+--------+
| result |
+--------+
| -82 |
| -79 |
| 21 |
| 19 |
| 50 |
| 53 |
| -100 |
| -67 |
| 46 |
| 40 |
+--------+
入力パラメータがすべて整数ではない場合は、DOUBLE 型を返します。
select uniform(1, 100., random() * 10000) as result from numbers("number" = "10");
+-------------------+
| result |
+-------------------+
| 84.25057360297031 |
| 63.34296160793329 |
| 81.8770598286311 |
| 26.53334147605743 |
| 17.42787914185705 |
| 2.532901549399078 |
| 63.72223367924216 |
| 78.42165786093118 |
| 18.913688179943 |
| 41.73057334477316 |
+-------------------+
パラメータはリテラルである必要があります。
select uniform(1, unix_timestamp(), random() * 10000) as result from numbers("number" = "10");
ERROR 1105 (HY000): errCode = 2, detailMessage = The second parameter (max) of uniform function must be literal
パラメータはリテラルである必要があります。
select uniform(1, ksint, random()) from fn_test;
ERROR 1105 (HY000): errCode = 2, detailMessage = The second parameter (max) of uniform function must be literal
シードを固定すると、結果も一定になります（random() の結果は 0 から 1 の範囲に分布するため、そのまま使用すると uniform のシード引数は常に 0 になります）。
select uniform(-100, 100, random()) as result from numbers("number" = "10");
+--------+
| result |
+--------+
| -68 |
| -68 |
| -68 |
| -68 |
| -68 |
| -68 |
| -68 |
| -68 |
| -68 |
| -68 |
+--------+
いずれかの入力が NULL の場合、出力も NULL になります。
select uniform(-100, NULL, random() * 10000) as result from numbers("number" = "10");
+--------+
| result |
+--------+
| NULL |
| NULL |
| NULL |
| NULL |
| NULL |
| NULL |
| NULL |
| NULL |
| NULL |
| NULL |
+--------+
select k0, uniform(0, 1000, k0) from it order by k0;
+------+----------------------+
| k0 | uniform(0, 1000, k0) |
+------+----------------------+
| NULL | NULL |
| 1 | 134 |
| 2 | 904 |
| 3 | 559 |
| 4 | 786 |
| 5 | 673 |
+------+----------------------+