MySQL 8.0アダプタ制限事項

サポートする型
テーブル読み取り処理
検索系SQL実行処理
テーブル書き込み処理
更新系SQL実行処理
ストアドプロシージャ実行処理
主な例外

サポートする型

本アダプタでサポートする型は以下の通りです。

型名	サポート	備考
BOOL型 (BOOLEAN型)	○	tinyint(1)のエイリアス
BIT型	△
TINYINT型	○
TINYINT UNSIGNED型	△
MEDIUMINT型	○
MEDIUMINT UNSIGNED型	△
SMALLINT型	○
SMALLINT UNSIGNED型	△
INT型 (INTEGER型)	○
INT UNSIGNED型 (INTEGER UNSIGNED型)	△
BIGINT型	○
BIGINT UNSIGNED型	△
FLOAT型	△
FLOAT UNSIGNED型	△
DOUBLE型 (REAL型)	△
DOUBLE UNSIGNED型 (REAL UNSIGNED型)	△
DECIMAL型 (NUMERIC型)	○
DECIMAL UNSIGNED型 (NUMERIC UNSIGNED型)	△
DATE型	△
DATETIME型	△
TIMESTAMP型	△
TIME型	△
YEAR型	△
CHAR型	△
VARCHAR型	△
BINARY型	○
VARBINARY型	○
TINYBLOB型	○
TINYTEXT型	△
BLOB型	○
TEXT型	△
MEDIUMBLOB型	○
MEDIUMTEXT型	△
LONGBLOB型	○
LONGTEXT型	△
ENUM型	△
SET型	△
JSON型	×

○:サポートします。
△:サポートしますが、制限事項があります。
×:サポートしません。

テーブル読み取り処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DATE型、DATETIME型、TIMESTAMP型
- データが0000-00-00 00:00:00の場合、エラーが発生します。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
テーブル名が引用符で囲われている場合の大文字小文字の区別は、データベースが稼働するOSに依存します。

オプションの拡張属性ZEROFILLが指定されている場合でも、0が除かれた結果が返されます。

[フェッチサイズ]のデフォルト値は「500」です。

検索系SQL実行処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DATE型、DATETIME型、TIMESTAMP型
- データが0000-00-00 00:00:00の場合、エラーが発生します。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
テーブル名が引用符で囲われている場合の大文字小文字の区別は、データベースが稼働するOSに依存します。

オプションの拡張属性ZEROFILLが指定されている場合でも、0が除かれた結果が返されます。

[フェッチサイズ]のデフォルト値は「500」です。

テーブル書き込み処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DATE型、DATETIME型、TIMESTAMP型
- データが存在しない日付の場合、正しく書き込まれません。
  例:「0000年00月00日」の場合、「0002年11月30日」になります。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
テーブル名が引用符で囲われている場合の大文字小文字の区別は、データベースが稼働するOSに依存します。

更新系SQL実行処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DATE型、DATETIME型、TIMESTAMP型
- データが存在しない日付の場合、正しく書き込まれません。
  例:「0000年00月00日」の場合、「0002年11月30日」になります。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
テーブル名が引用符で囲われている場合の大文字小文字の区別は、データベースが稼働するOSに依存します。

ストアドプロシージャ実行処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/8.0/en/numeric-type-overview.html)を参照してください。
CHAR型、VARCHAR型、TEXT型、TINYTEXT型、MEDIUMTEXT型、LONGTEXT型
- マルチバイト文字の入った引数を使用すると、エラーが発生します。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
ENUM型、SET型
- マルチバイト文字の入った引数を使用すると、エラーが発生します。
TINYINT UNSIGNED型、MEDIUMINT UNSIGNED型、SMALLINT UNSIGNED型、INT UNSIGNED型、BIGINT UNSIGNED型、FLOAT UNSIGNED型、DOUBLE UNSIGNED型、DECIMAL UNSIGNED型
- [入力/型]および[出力/型]にはUNSIGNEDなしで表示されます。
テーブル名が引用符で囲われている場合の大文字小文字の区別は、データベースが稼働するOSに依存します。

主な例外

例外名	原因	対策
com.mysql.cj.jdbc.exceptions.CommunicationsException	データベースに接続できません。	グローバルリソースの[ホスト名]または[ポート番号]を確認してください。
java.sql.SQLNonTransientConnectionException	データベースに接続できません。	グローバルリソースの[ホスト名]または[ポート番号]を確認してください。
java.sql.SQLSyntaxErrorException Unknown database '<データベース名>'	データベースが存在しません。	グローバルリソースの[データベース名]で存在するデータベースを指定してください。
java.sql.SQLException Access denied for user '<ユーザ名>'@'<端末名>'(using password: YES)	ユーザ名またはパスワードが不正です。	グローバルリソースの[ユーザ名]または[パスワード]を確認してください。
java.sql.SQLSyntaxErrorException Table '<テーブル名>' doesn't exist	テーブルが存在しません。	[テーブル名]で存在するテーブルを指定してください。