RANDOM_BYTES

説明

RANDOM_BYTES関数は、指定された長さのランダムなバイト列を生成します。返されるバイト列は16進数文字列として表現されます。

構文

RANDOM_BYTES(<len>)

パラメータ

Parameter	デスクリプション
<len>	生成するランダムバイト数。型：INT

Return Value

VARCHAR型を返します。16進数でエンコードされたランダムバイトシーケンス（0xが前に付与されます）。

特殊なケース：

• <len>は0より大きい値である必要があり、そうでない場合はエラーを返します
• パラメータがNULLの場合、NULLを返します
• 呼び出すたびにランダムな結果が生成されます

Examples

1. 基本的な使用方法：8バイトのランダムシーケンスを生成

SELECT random_bytes(8);

+--------------------+
| random_bytes(8)    |
+--------------------+
| 0x1a2b3c4d5e6f7089 |
+--------------------+

2. 短いシーケンスを生成する

SELECT random_bytes(4);

+----------------+
| random_bytes(4) |
+----------------+
| 0xab12cd34     |
+----------------+

3. 無効なパラメータ：負の数

SELECT random_bytes(-1);

ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]argument -1 of function random_bytes at row 0 was invalid.

4. NULL値の処理

SELECT random_bytes(NULL);

+--------------------+
| random_bytes(NULL) |
+--------------------+
| NULL               |
+--------------------+

5. より長いシーケンス（16バイト）を生成する

SELECT random_bytes(16);

+------------------------------------+
| random_bytes(16)                   |
+------------------------------------+
| 0x1a2b3c4d5e6f708192a3b4c5d6e7f809 |
+------------------------------------+

Keywords

RANDOM_BYTES