PARSE_DATA_SIZE

説明

PARSE_DATA_SIZE関数は、ストレージ単位を含む文字列（"1.5GB"など）を解析し、バイト単位の数値に変換します。

構文

PARSE_DATA_SIZE(<str>)

パラメータ

パラメータ	説明
<str>	単位付きデータサイズ文字列（例：「100MB」、「2.5GB」）。型：VARCHAR

戻り値

BIGINT型を返し、バイトに変換された数値を表します。

特殊なケース：

• サポートされている単位（大文字小文字区別なし）：B、kB、MB、GB、TB、PB、EB、ZB、YB
• 単位は1024進を使用（例：1kB = 1024B）
• 小数点をサポート（例：「2.5MB」）
• パラメータの形式が無効な場合、エラーを返します
• パラメータがNULLの場合、NULLを返します

サポートされている単位表：

単位	名前	バイト
B	Bytes	1
kB	Kilobytes	1024
MB	Megabytes	1024²
GB	Gigabytes	1024³
TB	Terabytes	1024⁴
PB	Petabytes	1024⁵
EB	Exabytes	1024⁶

例

1. 基本的な使用方法：バイトを解析

SELECT parse_data_size('1024B');

+--------------------------+
| parse_data_size('1024B') |
+--------------------------+
| 1024                     |
+--------------------------+

2. キロバイトを解析する

SELECT parse_data_size('1kB');

+------------------------+
| parse_data_size('1kB') |
+------------------------+
| 1024                   |
+------------------------+

3. 小数点付きメガバイトを解析する

SELECT parse_data_size('2.5MB');

+--------------------------+
| parse_data_size('2.5MB') |
+--------------------------+
| 2621440                  |
+--------------------------+

4. ギガバイトを解析する

SELECT parse_data_size('1GB');

+------------------------+
| parse_data_size('1GB') |
+------------------------+
| 1073741824             |
+------------------------+

5. テラバイト単位での解析

SELECT parse_data_size('1TB');

+------------------------+
| parse_data_size('1TB') |
+------------------------+
| 1099511627776          |
+------------------------+

6. サポートされていない単位、エラー

SELECT parse_data_size('1iB');

ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]Invalid Input argument "1iB" of function parse_data_size

7. NULL を入力

SELECT parse_data_size(NULL);

+-----------------------+
| parse_data_size(NULL) |
+-----------------------+
| NULL                  |
+-----------------------+

キーワード

PARSE_DATA_SIZE