Amazon RDS for MySQL 5.7アダプタ制限事項

サポートする型
テーブル読み取り処理
検索系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型	△
DOUBLE UNSIGNED型	△
REAL型	△
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/5.7/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/5.7/en/numeric-type-overview.html)を参照してください。
DATE型、DATETIME型、TIMESTAMP型
- データが0000-00-00 00:00:00の場合、エラーが発生します。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
オプションの拡張属性ZEROFILLが指定されている場合でも、0が除かれた結果が返されます。

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

検索系SQL実行処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/5.7/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/5.7/en/numeric-type-overview.html)を参照してください。
DATE型、DATETIME型、TIMESTAMP型
- データが0000-00-00 00:00:00の場合、エラーが発生します。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
オプションの拡張属性ZEROFILLが指定されている場合でも、0が除かれた結果が返されます。

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

テーブル書き込み処理

仕様制限

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

更新系SQL実行処理

仕様制限

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

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

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/5.7/en/numeric-type-overview.html)を参照してください。
DOUBLE型、DOUBLE UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/5.7/en/numeric-type-overview.html)を参照してください。
CHAR型、VARCHAR型、TEXT型、TINYTEXT型、MEDIUMTEXT型、LONGTEXT型
- マルチバイト文字の入った引数を使用すると、エラーが発生します。
TIME型
- 00:00:00から23:59:59までの範囲をサポートします。それ以外の場合、エラーが発生します。
YEAR型
- Stringとしてデータを扱います。
ENUM型、SET型
- マルチバイト文字の入った引数を使用すると、エラーが発生します。

主な例外

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