ランダム関数
ランダム関数は、評価されるたびに新しい値を生成します。宛先によって割り当てられるキーがないレコード用のUUIDなどの識別子、および重複処理を防ぐ冪等性キーに使用します。
ランダム値は再現できません
呼び出しごとに異なる値が返されます。後続のステップで前のステップの値を再現することはできず、再実行すると新しい値が生成されます。値をフィールドに保存し、下流のステップで必要になったときに再利用します。
同じ理由から、保存も行わない限り、システム間で一致する必要があるものにランダム値を使用しないでください。
各評価で異なる値が返されるため、次の例ではリテラル値ではなく、各関数の出力の長さを示します。
乱数関数はホストからランダム性を取得し、ホスト側のソースが失敗した場合は E450 を送出します。
識別子
次の関数は、レコードまたは冪等性キーに適した新しい識別子を生成します。
uuid
標準の8-4-4-4-12ハイフン区切り形式で、バージョン4 UUIDを36文字の文字列として生成します。
デフォルトではuuidを使用します。その長さにより衝突は現実的ではなく、識別子を受け付けるすべてのシステムがこの形式を認識します。引数は不要です。
uuid()UUIDを生成して長さを測定する
次の例では、UUIDを生成して長さを測定します。
Formula
length(uuid())出力
36生成された値はf81d4fae-7dec-41d0-a765-00a0c91e6bf6のようになります。
random_hex
指定された数のランダムバイトを生成し、その2倍の数の16進文字として返します。
システムが不透明トークンを必要としているものの、UUIDのハイフンを受け付けない場合に使用します。
random_hex(bytes)| パラメーター | 説明 |
|---|---|
| bytes | 生成するランダムバイト数。返される文字列はこの長さの2倍になります。整数以外のデータ型が指定された場合は E100 を送出します。 1~1,048,576 の範囲外の値が指定された場合は E211 を送出します。 |
ランダムな16進文字列を生成して長さを測定する
次の例では、ランダムな16進文字列を生成して長さを測定します。
Formula
length(random_hex(16))出力
32数値
次の関数は、範囲内のランダムな数値を生成します。
random_int
minからmaxまでのランダムな整数を返します。両方とも含まれます。
min と max は、64ビット符号付き整数の範囲内の Integer 値である必要があります。整数以外のデータ型が指定された場合は E100 を送出します。 64ビット符号付き整数の範囲外の値が指定された場合は E211 を送出します。 max が min より小さくなるような値が指定された場合、境界の入れ替えは行わずに E211 を送出します。 min と max が等しい場合、random_int はその値を返します。
random_int(min, max)| パラメーター | 説明 |
|---|---|
| min | 可能な最小値。含まれます。 |
| max | 可能な最大値。含まれます。 |
random_float
下限を含み、上限を含まない、0.0から1.0までのランダムなFloatを返します。結果は 2^-53 の倍数に対して一様分布になります。
Floatが返されるため、正確な10進数演算が必要なものにはrandom_floatを使用しないでください。データ型を参照してください。引数は不要です。
random_float()生バイト
次の関数は、ソルトまたは初期化ベクトル用の生ランダムバイトを生成します。
random_bytes
指定された数のランダムバイトをBinary値として返します。
暗号関数のソルトや初期化ベクトルなど、本当にバイトシーケンスが必要な場合に使用します。フィールドまたはURLに入れる識別子には、random_hexまたはuuidを使用すると文字列を直接取得できます。
random_bytes(count)| パラメーター | 説明 |
|---|---|
| count | 生成するバイト数。整数以外のデータ型が指定された場合は E100 を送出します。 1~1,048,576 の範囲外の値が指定された場合は E211 を送出します。 |
ランダムバイトを生成して長さを測定する
次の例では、ランダムバイトを生成して長さを測定します。
Formula
byte_length(random_bytes(8))出力
8関連情報
- 暗号関数: ランダムバイトをソルトおよび初期化ベクトルとして使用する方法に関する情報。
- Binary関数:
byte_lengthに関する情報、およびBinaryを16進またはbase64テキストに変換する方法。 - データ型:
Binary、Float、Decimalに関する情報。 - Error codes:
E100、E211、E450などのジョブ失敗のトラブルシューティング。
最終更新日: