Wiki: ページの作成:「== 概要 == MySQLでは、データ型間の変換が頻繁に発生する。
型変換には、暗黙的な変換と明示的な変換の2種類が存在する。

暗黙的な型変換は、演算や比較の際にMySQLが自動的に実行する変換である。
明示的な型変換は、`CAST` 関数や `CONVERT` 関数を使用してユーザが指定する変換である。

暗黙的な型変換は、便利で…」

2026-02-16T07:40:58Z

ページの作成:「== 概要 == MySQLでは、データ型間の変換が頻繁に発生する。 型変換には、暗黙的な変換と明示的な変換の2種類が存在する。 暗黙的な型変換は、演算や比較の際にMySQLが自動的に実行する変換である。 明示的な型変換は、<code>CAST</code> 関数や <code>CONVERT</code> 関数を使用してユーザが指定する変換である。 暗黙的な型変換は、便利で…」

新規ページ

== 概要 ==
MySQLでは、データ型間の変換が頻繁に発生する。 
型変換には、暗黙的な変換と明示的な変換の2種類が存在する。 
 
暗黙的な型変換は、演算や比較の際にMySQLが自動的に実行する変換である。 
明示的な型変換は、<code>CAST</code> 関数や <code>CONVERT</code> 関数を使用してユーザが指定する変換である。 
 
暗黙的な型変換は、便利である一方で、予期しない結果やパフォーマンスの低下を引き起こす場合がある。 
特に、WHERE句でカラムに対して型変換が適用されると、インデックスが使用されなくなる可能性が高い。 
 
MySQL 8.0.17以降では、<code>CAST</code> 関数および <code>CONVERT</code> 関数で使用可能な型が拡張されている。 
<code>FLOAT</code> 型、<code>DOUBLE</code> 型への変換がサポートされ、精度指定も可能になった。 
 
また、MySQL 8.0.22以降では、<code>YEAR</code> 型への変換、および <code>AT TIME ZONE</code> 演算子が追加された。 
 
型変換の動作を正確に理解することは、データの整合性を保ち、パフォーマンスを最適化する上で重要である。 
 

== 暗黙的な型変換 ==
暗黙的な型変換は、MySQLが自動的に実行する型変換である。 
演算子や関数が異なる型の引数を受け取った場合、MySQLは自動的に型を変換して処理を行う。 
 
==== 暗黙的変換が発生する場面 ====
暗黙的な型変換は、以下に示す場面で発生する。 
 
<center>
{| class="wikitable"
|+ 暗黙的な型変換が発生する場面
|-
! 場面 !! 説明
|-
| 比較演算子を使用する場合 || <code>=</code>、<code>!=</code>、<code><</code>、<code>></code>、<code><=</code>、<code>>=</code> 等
|-
| 算術演算子を使用する場合 || <code>+</code>、<code>-</code>、<code>*</code>、<code>/</code>、<code>%</code> 等
|-
| 関数の引数として使用する場合 || <code>CONCAT</code> 関数、<code>SUBSTRING</code> 関数等
|-
| INSERT文またはUPDATE文での値代入 || カラムの型と異なる型の値を挿入または更新する場合
|-
| WHERE句での条件評価 || カラムと異なる型の値で比較する場合
|}
</center>
 
暗黙的変換の例を以下に示す。 
 
暗黙的変換は、コードの記述を簡潔にする一方で、予期しない動作を引き起こす可能性がある。 
 
<syntaxhighlight lang="mysql">
SELECT '100' + 50;
-- 結果: 150 (文字列 '100' が数値 100 に変換される)

SELECT CONCAT(123, ' items');
-- 結果: '123 items' (数値 123 が文字列 '123' に変換される)

SELECT * FROM users WHERE user_id = '42';
-- user_idが整数型の場合、文字列 '42' が数値 42 に変換される
</syntaxhighlight>
 
==== 文字列から数値への暗黙変換 ====
文字列が数値として解釈される場合、MySQLは文字列の先頭から数値として読み取れる部分までを変換する。 
 
変換ルールを以下に示す。 
 
<center>
{| class="wikitable"
|+ 文字列から数値への変換規則
|-
! 条件 !! 説明
|-
| 先頭が数字の場合 || 数値として読み取れる部分まで変換
|-
| 先頭が数字でない場合 || 0に変換
|-
| 指数表記 (科学的表記法) をサポート || <code>1.5e2</code> は 150 に変換
|-
| カンマ区切りは数値として認識されない || <code>1,234,567</code> は 1 に変換 (カンマで終了)
|}
</center>
 
文字列から数値への変換例を以下に示す。 
 
このルールにより、予期しない結果が生じる可能性がある。 
例えば、<code>'1,234,567'</code> という文字列は、1に変換される。 
 
<syntaxhighlight lang="mysql">
SELECT '123' + 0;
-- 結果: 123

SELECT '123abc' + 0;
-- 結果: 123 (先頭の数値部分のみ変換)

SELECT 'abc123' + 0;
-- 結果: 0 (先頭が数字でないため0に変換)

SELECT '1.5e2' + 0;
-- 結果: 150 (指数表記を解釈)

SELECT '1,234,567' + 0;
-- 結果: 1 (カンマで数値部分が終了)

SELECT ' 456 ' + 0;
-- 結果: 456 (前後の空白は無視)
</syntaxhighlight>
 
==== 数値から文字列への暗黙変換 ====
数値が文字列として解釈される場面では、MySQLは数値を文字列に自動変換する。 
 
数値から文字列への変換は、比較的直感的である。 
 
文字列コンテキストの例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CONCAT(2, ' items');
-- 結果: '2 items' (数値 2 が文字列 '2' に変換)

SELECT CONCAT(123.45, ' dollars');
-- 結果: '123.45 dollars'

SELECT CONCAT(NULL, ' test');
-- 結果: NULL
</syntaxhighlight>
 
==== 日付型の暗黙変換 ====
MySQLは、日付型の文字列表現を"緩やかな"フォーマットで受け入れる。 
 
日付型の暗黙変換の特徴を以下に示す。 
 
<center>
{| class="wikitable"
|+ 文字列から日付/時刻への変換規則
|-
! 規則 !! 説明
|-
| 区切り文字の柔軟性 || <code>-</code>、<code>/</code>、<code>#</code> 等の区切り文字を使用可能
|-
| 区切り文字なしの形式 || <code>20240815</code> のような形式も認識
|-
| 時刻部分のオプション || 日付のみ、または日付と時刻の両方を指定可能
|}
</center>
 
日付型の暗黙変換の例を以下に示す。 
 
ただし、日本語の日付表記 (例: <code>2024年8月15日</code>) は認識されない。 
このような形式の日付を変換する場合は、<code>STR_TO_DATE</code> 関数を使用する。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('2024-08-15' AS DATE);
-- 結果: 2024-08-15

SELECT CAST('2024/08/15' AS DATE);
-- 結果: 2024-08-15 (区切り文字 / を認識)

SELECT CAST('2024#08#15' AS DATE);
-- 結果: 2024-08-15 (区切り文字 # を認識)

SELECT CAST('20240815' AS DATE);
-- 結果: 2024-08-15 (区切り文字なしも認識)

SELECT CAST('2024-08-15 14:30:00' AS DATETIME);
-- 結果: 2024-08-15 14:30:00
</syntaxhighlight>
 

== 比較時の型変換ルール ==
MySQLは、異なる型の値を比較する際に、一定のルールに従って型変換を実行する。 
 
==== 型変換の優先順位 ====
MySQLは、以下に示す優先順位で型変換を実行する。 
 
<center>
{| class="wikitable"
|+ 型変換の優先順位
|-
! 優先順位 !! 条件 !! 変換規則
|-
| 1 || NULLの場合 || 結果は <code>NULL</code> (<code><=></code> 演算子は例外)
|-
| 2 || 両方が文字列の場合 || 文字列として比較
|-
| 3 || 両方が整数の場合 || 整数として比較
|-
| 4 || DECIMALが含まれる場合 || DECIMAL精度ルールに従って比較
|-
| 5 || その他の場合 || 浮動小数点数として比較
|}
</center>
 
比較時の型変換の例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT 1 = '1';
-- 結果: 1 (true) (文字列 '1' が数値 1 に変換)

SELECT 0 = 'abc';
-- 結果: 1 (true) (文字列 'abc' が数値 0 に変換)

SELECT 1 = 1.0;
-- 結果: 1 (true) (整数と浮動小数点の比較)

SELECT 'abc' = 'ABC';
-- 結果: 1 (true) (デフォルトの照合順序は大文字小文字を区別しない)
</syntaxhighlight>
 
==== 文字列と数値の比較 ====
文字列と数値を比較する場合、文字列が数値に変換 される。 
 
文字列と数値の比較例を以下に示す。 
 
この動作により、予期しない比較結果が生じる可能性がある。 
特に、'abc' = 0 が true となる点に注意すること。 
 
<syntaxhighlight lang="mysql">
SELECT 1 > '6x';
-- 結果: 0 (false) ('6x' は 6 に変換、1 > 6 は false)

SELECT 7 > '6x';
-- 結果: 1 (true) ('6x' は 6 に変換、7 > 6 は true)

SELECT 0 = 'x6';
-- 結果: 1 (true) ('x6' は 0 に変換、0 = 0 は true)

SELECT 'abc' = 0;
-- 結果: 1 (true) ('abc' は 0 に変換)

SELECT '123' > 99;
-- 結果: 1 (true) ('123' は 123 に変換、123 > 99 は true)
</syntaxhighlight>
 
==== 照合順序と比較 ====
文字列同士の比較では、照合順序 (Collation) が比較結果に影響する。 
 
大文字小文字を区別する比較を行う場合は、<code>BINARY</code> 演算子または <code>COLLATE utf8mb4_bin</code> を使用する。 
 
照合順序の影響を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT 'abc' = 'ABC';
-- 結果: 1 (true) (デフォルトの照合順序は大文字小文字を区別しない)

SELECT 'abc' = 'ABC' COLLATE utf8mb4_bin;
-- 結果: 0 (false) (バイナリ比較では区別)

SELECT BINARY 'abc' = 'ABC';
-- 結果: 0 (false) (BINARY演算子でバイナリ比較を強制)
</syntaxhighlight>
 

== 明示的な型変換 ==
明示的な型変換は、<code>CAST</code> 関数または <code>CONVERT</code> 関数を使用して実行する。 
これらの関数により、ユーザが意図した型変換を明確に指定できる。 
 
==== CAST関数 ====
<code>CAST</code> 関数は、SQL標準の型変換関数である。 
 
基本構文を以下に示す。 
 
<syntaxhighlight lang="mysql">
CAST(expr AS type [ARRAY])
</syntaxhighlight>
 
<center>
{| class="wikitable"
|+ <code>CAST</code>関数の引数
! 引数 !! 説明
|-
| <code>expr</code> || 変換する値または式
|-
| <code>type</code> || 変換先の型
|-
| <code>ARRAY</code> || JSON配列への変換 (オプション、MySQL 8.0.17以降)
|}
</center>
 
<code>CAST</code> 関数の使用例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('123' AS SIGNED);
-- 結果: 123 (文字列を符号付き整数に変換)

SELECT CAST(123.456 AS DECIMAL(5,2));
-- 結果: 123.46 (浮動小数点数を固定小数点数に変換、四捨五入)

SELECT CAST('2024-08-15' AS DATE);
-- 結果: 2024-08-15 (文字列を日付型に変換)

SELECT CAST('2024-08-15 14:30:00' AS DATETIME);
-- 結果: 2024-08-15 14:30:00 (文字列を日時型に変換)

SELECT CAST(123 AS CHAR);
-- 結果: '123' (数値を文字列に変換)
</syntaxhighlight>
 
==== CONVERT関数 ====
<code>CONVERT</code> 関数は、MySQL独自の型変換関数である。 
<code>CONVERT</code> 関数には、2つの構文が存在する。 
 
基本構文を以下に示す。 
 
<syntaxhighlight lang="mysql">
CONVERT(expr, type)
CONVERT(expr USING transcoding_name)
</syntaxhighlight>
 
<center>
{| class="wikitable"
|+ <code>CONVERT</code>関数の構文
! 構文 !! 説明
|-
| <code>CONVERT(expr, type)</code> || <code>CAST</code>関数と同様の型変換
|-
| <code>CONVERT(expr USING transcoding_name)</code> || 文字セット変換
|}
</center>
 
<code>CONVERT</code> 関数の使用例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CONVERT('123', SIGNED);
-- 結果: 123

SELECT CONVERT(123.456, DECIMAL(5,2));
-- 結果: 123.46

SELECT CONVERT('Hello' USING utf8mb4);
-- 結果: 'Hello' (文字セットをutf8mb4に変換)

SELECT CONVERT('データ' USING latin1);
-- エラーまたは文字化け (latin1は日本語をサポートしない)
</syntaxhighlight>
 
文字セット指定付き <code>CAST</code> 関数の構文を以下に示す。 
 
<syntaxhighlight lang="mysql">
CAST(expr AS CHAR CHARACTER SET charset_name)
</syntaxhighlight>
 
文字セット指定の例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('Hello' AS CHAR CHARACTER SET utf8mb4);
-- 結果: 'Hello'

SELECT CAST('データベース' AS CHAR CHARACTER SET utf8mb4);
-- 結果: 'データベース'
</syntaxhighlight>
 
==== CAST / CONVERTで使用可能な型の詳細 ====
<code>CAST</code> 関数および <code>CONVERT</code> 関数では、以下に示す型への変換がサポートされている。 
 
<center>
{| class="wikitable"
|+ サポートされる型の一覧
! 型 !! 説明 !! 追加されたバージョン
|-
| <code>BINARY[(N)]</code> || バイナリ文字列型 ||
|-
| <code>CHAR[(N)]</code> || 固定長文字列型 ||
|-
| <code>DATE</code> || 日付型 ||
|-
| <code>DATETIME</code> || 日時型 ||
|-
| <code>TIME</code> || 時刻型 ||
|-
| <code>DECIMAL[(M[,D])]</code> || 固定小数点型 ||
|-
| <code>SIGNED [INTEGER]</code> || 符号付き整数型 ||
|-
| <code>UNSIGNED [INTEGER]</code> || 符号なし整数型 ||
|-
| <code>FLOAT[(p)]</code> || 単精度浮動小数点型 || MySQL 8.0.17以降
|-
| <code>DOUBLE</code> || 倍精度浮動小数点型 || MySQL 8.0.17以降
|-
| <code>REAL</code> || REAL型 (FLOATまたはDOUBLE) || MySQL 8.0.17以降
|-
| <code>JSON</code> || JSON型 ||
|-
| <code>YEAR</code> || 年型 || MySQL 8.0.22以降
|-
| 空間型 || Point、LineString等 || MySQL 8.0.24以降
|}
</center>
 
===== BINARY / CHAR =====
<code>BINARY</code> 型および <code>CHAR</code> 型への変換は、文字列またはバイナリ文字列を生成する。 
 
<code>BINARY[(N)]</code> の場合、<code>N</code> はバイト数を指定する。 
<code>CHAR[(N)]</code> の場合、<code>N</code> は文字数ではなくバイト数を指定する点に注意すること。 
 
<syntaxhighlight lang="mysql">
SELECT CAST(123 AS CHAR);
-- 結果: '123'

SELECT CAST('Hello' AS BINARY(10));
-- 結果: 'Hello\0\0\0\0\0' (10バイトに拡張、NULLバイトでパディング)

SELECT CAST('Hello World' AS CHAR(5));
-- 結果: 'Hello' (5バイトに切り詰め)
</syntaxhighlight>
 
===== 数値型 =====
数値型への変換には、整数型、固定小数点型、浮動小数点型が含まれる。 
 
<center>
{| class="wikitable"
|+ 数値型への変換
! 型 !! 説明
|-
| <code>SIGNED [INTEGER]</code> || 符号付き整数型 (-9223372036854775808 ～ 9223372036854775807)
|-
| <code>UNSIGNED [INTEGER]</code> || 符号なし整数型 (0 ～ 18446744073709551615)
|-
| <code>DECIMAL[(M[,D])]</code> || 固定小数点型 (M: 精度、D: 小数点以下桁数)
|-
| <code>FLOAT[(p)]</code> || 単精度浮動小数点型 (p: 精度 0-53)
|-
| <code>DOUBLE</code> || 倍精度浮動小数点型
|-
| <code>REAL</code> || REAL型 (REAL_AS_FLOATモード設定時はFLOAT、それ以外はDOUBLE)
|}
</center>
 
<code>FLOAT[(p)]</code> の精度指定について以下に示す。 
 
<center>
{| class="wikitable"
|+ <code>FLOAT[(p)]</code> の精度指定
|-
! 精度 <code>p</code> の範囲 !! 変換先
|-
| 0〜24 || <code>FLOAT</code> 型 (単精度浮動小数点)
|-
| 25〜53 || <code>DOUBLE</code> 型 (倍精度浮動小数点)
|}
</center>
 
数値型への変換の例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('123' AS SIGNED);
-- 結果: 123

SELECT CAST('-456' AS SIGNED);
-- 結果: -456

SELECT CAST('789' AS UNSIGNED);
-- 結果: 789

SELECT CAST('-123' AS UNSIGNED);
-- 結果: 18446744073709551493 (オーバーフロー)

SELECT CAST(123.456 AS DECIMAL(5,2));
-- 結果: 123.46 (四捨五入)

SELECT CAST('123.456' AS FLOAT);
-- 結果: 123.456

SELECT CAST('123.456' AS DOUBLE);
-- 結果: 123.456

SELECT CAST('1.23e2' AS DOUBLE);
-- 結果: 123 (指数表記を解釈)
</syntaxhighlight>
 
===== 日付・時刻型 =====
日付型および時刻型への変換には、以下に示す型が含まれる。 
 
<center>
{| class="wikitable"
|+ 日付・時刻型への変換
! 型 !! 形式 !! 説明
|-
| <code>DATE</code> || YYYY-MM-DD || 日付型
|-
| <code>TIME</code> || HH:MM:SS || 時刻型
|-
| <code>DATETIME</code> || YYYY-MM-DD HH:MM:SS || 日時型
|-
| <code>YEAR</code> || YYYY || 年型 (MySQL 8.0.22以降)
|}
</center>
 
日付・時刻型への変換の例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('2024-08-15' AS DATE);
-- 結果: 2024-08-15

SELECT CAST('14:30:00' AS TIME);
-- 結果: 14:30:00

SELECT CAST('2024-08-15 14:30:00' AS DATETIME);
-- 結果: 2024-08-15 14:30:00

SELECT CAST('2024' AS YEAR);
-- 結果: 2024 (MySQL 8.0.22以降)

SELECT CAST('2024-08-15 14:30:00' AS DATE);
-- 結果: 2024-08-15 (時刻部分は切り捨て)

SELECT CAST('2024-08-15 14:30:00' AS TIME);
-- 結果: 14:30:00 (日付部分は切り捨て)
</syntaxhighlight>
 
<code>AT TIME ZONE</code> 演算子による時刻変換 (MySQL 8.0.22以降) を以下に示す。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('2024-08-15 14:30:00' AS DATETIME) AT TIME ZONE '+00:00';
-- 結果: UTCタイムゾーンに変換
</syntaxhighlight>
 
===== JSON =====
<code>JSON</code> 型への変換は、文字列、数値、オブジェクト、配列をJSON形式に変換する。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('{}' AS JSON);
-- 結果: {} (空のJSONオブジェクト)

SELECT CAST('[1,2,3]' AS JSON);
-- 結果: [1,2,3] (JSON配列)

SELECT CAST(123 AS JSON);
-- 結果: 123 (JSON数値)

SELECT CAST('"Hello"' AS JSON);
-- 結果: "Hello" (JSON文字列)

SELECT CAST('{"name":"Alice","age":30}' AS JSON);
-- 結果: {"name":"Alice","age":30} (JSONオブジェクト)
</syntaxhighlight>
 

== JSON関連の型変換 ==
MySQL 8.0では、JSON型と他の型の間での変換が強化されている。 
 
==== JSON型への変換 ====
JSON型への変換は、<code>CAST</code> 関数を使用して実行する。 
 
<syntaxhighlight lang="mysql">
SELECT CAST('{"name":"Alice"}' AS JSON);
-- 結果: {"name":"Alice"}

SELECT CAST('[1,2,3,4,5]' AS JSON);
-- 結果: [1,2,3,4,5]

SELECT CAST(123 AS JSON);
-- 結果: 123

SELECT CAST(true AS JSON);
-- 結果: true

SELECT CAST(NULL AS JSON);
-- 結果: null (JSONのnull値)
</syntaxhighlight>
 
==== JSON型からの変換 ====
JSON型から他の型への変換には、<code>JSON_UNQUOTE</code> 関数と <code>JSON_EXTRACT</code> 関数を組み合わせる方法がある。 
 
<syntaxhighlight lang="mysql">
SET @json = '{"name":"Alice","age":30}';

SELECT JSON_EXTRACT(@json, '$.name');
-- 結果: "Alice" (JSON文字列、ダブルクォート付き)

SELECT JSON_UNQUOTE(JSON_EXTRACT(@json, '$.name'));
-- 結果: Alice (ダブルクォートを除去)

SELECT CAST(JSON_EXTRACT(@json, '$.age') AS SIGNED);
-- 結果: 30 (数値に変換)
</syntaxhighlight>
 
MySQL 8.0.21以降では、<code>JSON_VALUE</code> 関数が利用可能である。 
 
<code>JSON_VALUE</code> 関数の構文を以下に示す。 
 
<syntaxhighlight lang="mysql">
JSON_VALUE(json_doc, path [RETURNING type] [on_empty] [on_error])
</syntaxhighlight>
 
<center>
{| class="wikitable"
|+ <code>JSON_VALUE</code>関数の引数
! 引数 !! 説明
|-
| <code>json_doc</code> || JSON文書
|-
| <code>path</code> || JSONパス式
|-
| <code>RETURNING type</code> || 戻り型 (オプション、デフォルト: VARCHAR(512))
|-
| <code>on_empty</code> || 値が存在しない場合の動作
|-
| <code>on_error</code> || エラー発生時の動作
|}
</center>
 
<code>JSON_VALUE</code> 関数で使用可能な型を以下に示す。 
 
<center>
{| class="wikitable"
|+ JSON_VALUE関数で使用可能な型
|-
! 分類 !! 型
|-
| 数値型 || <code>FLOAT</code>、<code>DOUBLE</code>、<code>DECIMAL</code>、<code>SIGNED</code>、<code>UNSIGNED</code>
|-
| 日付・時刻型 || <code>DATE</code>、<code>TIME</code>、<code>DATETIME</code>、<code>YEAR</code>
|-
| 文字列型 || <code>CHAR</code>
|-
| その他 || <code>JSON</code>
|}
</center>
 
<code>JSON_VALUE</code> 関数の使用例を以下に示す。 
 
<syntaxhighlight lang="mysql">
SET @json = '{"name":"Alice","age":30,"salary":50000.50}';

SELECT JSON_VALUE(@json, '$.name');
-- 結果: 'Alice' (デフォルトはVARCHAR(512))

SELECT JSON_VALUE(@json, '$.age' RETURNING SIGNED);
-- 結果: 30 (符号付き整数に変換)

SELECT JSON_VALUE(@json, '$.salary' RETURNING DECIMAL(10,2));
-- 結果: 50000.50 (固定小数点数に変換)

SELECT JSON_VALUE(@json, '$.unknown' RETURNING SIGNED NULL ON EMPTY);
-- 結果: NULL (値が存在しない場合はNULLを返す)

SELECT JSON_VALUE(@json, '$.unknown' RETURNING SIGNED DEFAULT 0 ON EMPTY);
-- 結果: 0 (値が存在しない場合は0を返す)

SELECT JSON_VALUE(@json, '$.invalid' RETURNING SIGNED ERROR ON ERROR);
-- エラー発生 (変換エラー時にエラーを返す)
</syntaxhighlight>
 
<code>ON EMPTY</code> 句および <code>ON ERROR</code> 句の動作を以下に示す。 
 
<center>
{| class="wikitable"
|+ ON EMPTY / ON ERROR句の動作
! 句 !! 説明
|-
| <code>NULL ON EMPTY</code> || 値が存在しない場合、NULLを返す (デフォルト)
|-
| <code>DEFAULT value ON EMPTY</code> || 値が存在しない場合、指定したデフォルト値を返す
|-
| <code>ERROR ON EMPTY</code> || 値が存在しない場合、エラーを発生
|-
| <code>NULL ON ERROR</code> || 変換エラー時、NULLを返す (デフォルト)
|-
| <code>DEFAULT value ON ERROR</code> || 変換エラー時、指定したデフォルト値を返す
|-
| <code>ERROR ON ERROR</code> || 変換エラー時、エラーを発生
|}
</center>
 
※注意 
<code>ON EMPTY</code> 句は、<code>ON ERROR</code> 句より前に置く必要がある。 
 
==== JSONと他の型の比較 ====
JSON型と他の型を比較する場合、MySQLは自動的に型変換を実行する。 
 
<syntaxhighlight lang="mysql">
SET @json = '{"value":123}';

SELECT JSON_EXTRACT(@json, '$.value') = 123;
-- 結果: 1 (true) (JSON数値と整数を比較)

SELECT JSON_EXTRACT(@json, '$.value') = '123';
-- 結果: 1 (true) (JSON数値と文字列を比較)
</syntaxhighlight>
 

== 型変換に関する注意点 ==
==== データ損失のリスク ====
型変換により、データが損失または変更される場合がある。 
 
データ損失が発生する例を以下に示す。 
 
* 固定小数点数から整数への変換
*: 小数部が切り捨てられる
*: <syntaxhighlight lang="mysql">
SELECT CAST(123.456 AS SIGNED);
-- 結果: 123 (小数部 .456 が切り捨て)
</syntaxhighlight>
*: 
* 浮動小数点数から固定小数点数への変換
*: 丸め誤差が発生する可能性
*: <syntaxhighlight lang="mysql">
SELECT CAST(123.456789 AS DECIMAL(5,2));
-- 結果: 123.46 (四捨五入)
</syntaxhighlight>
*: 
* 文字列から整数への変換
*: 数値以外の文字が喪失
*: <syntaxhighlight lang="mysql">
SELECT CAST('123abc' AS SIGNED);
-- 結果: 123 ('abc' が喪失)

SELECT CAST('abc123' AS SIGNED);
-- 結果: 0 (全ての文字が喪失)
</syntaxhighlight>
*: 
* 日時型から日付型への変換
*: 時刻部分が切り捨てられる
*: <syntaxhighlight lang="mysql">
SELECT CAST('2024-08-15 14:30:00' AS DATE);
-- 結果: 2024-08-15 (時刻部分 14:30:00 が切り捨て)
</syntaxhighlight>
 
==== インデックスへの影響 ====
WHERE句でカラムに対して型変換を適用すると、インデックスが使用されなくなる。 
これにより、クエリのパフォーマンスが大幅に低下する可能性がある。 
 
* 良い例
*: <syntaxhighlight lang="mysql">
-- 値側で型変換を行う
SELECT * FROM users WHERE user_id = 123;
-- インデックスが使用される

-- または、CASTを使わずに比較
SELECT * FROM users WHERE user_id = CAST('123' AS SIGNED);
-- インデックスが使用される
</syntaxhighlight>
*: 
* 悪い例
*: <syntaxhighlight lang="mysql">
-- user_idが整数型の場合
SELECT * FROM users WHERE CAST(user_id AS CHAR) = '123';
-- インデックスが使用されない
</syntaxhighlight>
 
カラムに対して関数または型変換を適用しないことが、インデックスを有効活用するための基本原則である。 
 
==== NULLの扱い ====
<code>CAST</code> 関数および <code>CONVERT</code> 関数は、<code>NULL</code> を変換すると <code>NULL</code> を返す。 
 
<syntaxhighlight lang="mysql">
SELECT CAST(NULL AS SIGNED);
-- 結果: NULL

SELECT CAST(NULL AS CHAR);
-- 結果: NULL

SELECT CAST(NULL AS DATE);
-- 結果: NULL
</syntaxhighlight>
 
<code>NULL</code> を別の値に置き換える場合は、<code>COALESCE</code> 関数または <code>IFNULL</code> 関数を使用する。 
 
<syntaxhighlight lang="mysql">
SELECT COALESCE(CAST(NULL AS SIGNED), 0);
-- 結果: 0

SELECT IFNULL(CAST(NULL AS SIGNED), -1);
-- 結果: -1
</syntaxhighlight>
 
==== 文字列と数値の比較でインデックスが使用されない ====
<syntaxhighlight lang="mysql">
-- user_idが整数型インデックスの場合
SELECT * FROM users WHERE user_id = '42';
-- 文字列 '42' が数値 42 に変換されるが、インデックスは使用される

-- しかし、以下はインデックスが使用されない
SELECT * FROM users WHERE CAST(user_id AS CHAR) = '42';
</syntaxhighlight>
 
==== カンマ区切り数値の変換 ====
<syntaxhighlight lang="mysql">
SELECT '1,234,567' + 0;
-- 結果: 1 (カンマで数値部分が終了)

-- 正しく変換するには、カンマを除去する
SELECT CAST(REPLACE('1,234,567', ',', '') AS SIGNED);
-- 結果: 1234567
</syntaxhighlight>
 
==== 浮動小数点数の比較 ====
<syntaxhighlight lang="mysql">
SELECT 0.1 + 0.2 = 0.3;
-- 結果: 0 (false) (浮動小数点誤差により不一致)

SELECT ABS((0.1 + 0.2) - 0.3) < 0.0001;
-- 結果: 1 (true) (誤差を考慮した比較)

-- または、DECIMAL型を使用
SELECT CAST(0.1 AS DECIMAL(10,2)) + CAST(0.2 AS DECIMAL(10,2)) = CAST(0.3 AS DECIMAL(10,2));
-- 結果: 1 (true)
</syntaxhighlight>
 
==== 日本語日付のCAST不可 ====
<syntaxhighlight lang="mysql">
SELECT CAST('2024年8月15日' AS DATE);
-- 結果: NULL (日本語日付は認識されない)

-- STR_TO_DATE関数を使用
SELECT STR_TO_DATE('2024年8月15日', '%Y年%m月%d日');
-- 結果: 2024-08-15
</syntaxhighlight>
 
==== 大きな整数と浮動小数点の比較 ====
<syntaxhighlight lang="mysql">
SELECT 9223372036854775807 = 9223372036854775808.0;
-- 結果: 1 (true) (浮動小数点の精度制限により誤った結果)

-- 整数同士で比較する
SELECT 9223372036854775807 = CAST(9223372036854775808.0 AS SIGNED);
-- 結果: 0 (false) (ただし、オーバーフローに注意)
</syntaxhighlight>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,MySQL,Database,SQL,Type Conversion,Cast,Convert,Implicit Conversion,Explicit Conversion,型変換,キャスト,データベース,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - MySQLの型変換・キャストに関する包括的なリファレンス | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:MySQL]]

MySQL - 数値関数 - 版の履歴

2026年2月16日 (月) 08:25にWikiによる