ランダム関数 ​

ランダム関数は、評価されるたびに新しい値を生成します。宛先によって割り当てられるキーがないレコード用のUUIDなどの識別子、および重複処理を防ぐ冪等性キーに使用します。

各評価で異なる値が返されるため、次の例ではリテラル値ではなく、各関数の出力の長さを示します。

識別子 ​

次の関数は、レコードまたは冪等性キーに適した新しい識別子を生成します。

uuid ​

標準の8-4-4-4-12ハイフン区切り形式で、バージョン4 UUIDを36文字の文字列として生成します。

デフォルトではuuidを使用します。その長さにより衝突は現実的ではなく、識別子を受け付けるすべてのシステムがこの形式を認識します。引数は不要です。

uuid()

length(uuid())

36

生成された値はf81d4fae-7dec-41d0-a765-00a0c91e6bf6のようになります。

random_hex ​

指定された数のランダムバイトを生成し、その2倍の数の16進文字として返します。

システムが不透明トークンを必要としているものの、UUIDのハイフンを受け付けない場合に使用します。

random_hex(bytes)

length(random_hex(16))

32

数値 ​

次の関数は、範囲内のランダムな数値を生成します。

random_int ​

minからmaxまでのランダムな整数を返します。両方とも含まれます。

random_int(min, max)

random_float ​

下限を含み、上限を含まない、0.0から1.0までのランダムなFloatを返します。

Floatが返されるため、正確な10進数演算が必要なものにはrandom_floatを使用しないでください。データ型を参照してください。引数は不要です。

random_float()

生バイト ​

次の関数は、ソルトまたは初期化ベクトル用の生ランダムバイトを生成します。

random_bytes ​

指定された数のランダムバイトをBinary値として返します。

暗号関数のソルトや初期化ベクトルなど、本当にバイトシーケンスが必要な場合に使用します。フィールドまたはURLに入れる識別子には、random_hexまたはuuidを使用すると文字列を直接取得できます。

random_bytes(count)

byte_length(random_bytes(8))

8

関連情報 ​

• 暗号関数: ランダムバイトをソルトおよび初期化ベクトルとして使用する方法に関する情報。
• Binary関数: byte_lengthに関する情報、およびBinaryを16進またはbase64テキストに変換する方法。
• データ型: Binary、Float、Decimalに関する情報。