Amazon Aurora 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)を参照してください。
- 桁数の多い値の場合、正しい値が取得できない場合があります。
  例:「2.14748365E9」の場合、「2.14748006E9」が取得されます。
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の場合、nullとして取得します。
TIME型
- 00:00:00から23:59:59の範囲外の場合、時間のみが00から23の間に変換された値を取得します。
  例:「27:15:00」の場合、「03:15:00」になります。
  例:「-04:20:00」の場合、「20:20:00」になります。「19:40:00」にはなりません。
YEAR型
- Stringとしてデータを扱います。
TINYINT UNSIGNED型、FLOAT UNSIGNED型、DOUBLE UNSIGNED型、REAL UNSIGNED型、DECIMAL UNSIGNED型
- [スキーマ定義/型]にはUNSIGNEDなしで表示されます。
オプションの拡張属性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)を参照してください。
- 桁数の多い値の場合、正しい値が取得できない場合があります。
  例:「2.14748365E9」の場合、「2.14748006E9」が取得されます。
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の場合、nullとして取得します。
TIME型
- 00:00:00から23:59:59の範囲外の場合、時間のみが00から23の間に変換された値を取得します。
  例:「27:15:00」の場合、「03:15:00」になります。
  例:「-04:20:00」の場合、「20:20:00」になります。「19:40:00」にはなりません。
YEAR型
- Stringとしてデータを扱います。
TINYINT UNSIGNED型、FLOAT UNSIGNED型、DOUBLE UNSIGNED型、REAL UNSIGNED型、DECIMAL UNSIGNED型
- [出力スキーマ定義/型]にはUNSIGNEDなしで表示されます。
オプションの拡張属性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)を参照してください。
- 最大値または最小値付近の値を書き込むことができません。
  例:「3.402823466E+38」の場合、エラーになります。
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型
- エポック秒が負の値になる日時の場合、正しく書き込まれません。
  例:「1950年01月01日08時59分59秒」の場合、「-08:59:59」になります。
YEAR型
- Stringとしてデータを扱います。
TINYINT UNSIGNED型、FLOAT UNSIGNED型、DOUBLE UNSIGNED型、REAL UNSIGNED型、DECIMAL UNSIGNED型
- [スキーマ定義/型]にはUNSIGNEDなしで表示されます。

更新系SQL実行処理

仕様制限

BIT型
- サイズが1のBIT型はbooleanとしてデータを扱います。それ以外のサイズのBIT型はサポートしません。
FLOAT型、FLOAT UNSIGNED型
- MySQLの浮動小数点数には精度に関する注意事項があります。
  詳細については、「MySQLリファレンスマニュアル」(https://dev.mysql.com/doc/refman/5.7/en/numeric-type-overview.html)を参照してください。
- 最大値または最小値付近の値を書き込むことができません。
  例:「3.402823466E+38」の場合、エラーになります。
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型
- エポック秒が負の値になる日時の場合、正しく書き込まれません。
  例:「1950年01月01日08時59分59秒」の場合、「-08: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)を参照してください。
- 桁数の多い値の場合、正しい値が取得できない場合があります。
  例:「2.14748365E9」の場合、「2.14748006E9」が取得されます。
- 最大値または最小値付近の値を書き込むことができません。
  例:「3.402823466E+38」の場合、エラーになります。
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の範囲外の場合、時間のみが00から23の間に変換された値を取得します。
  例:「27:15:00」の場合、「03:15:00」になります。
  例:「-04:20:00」の場合、「20:20:00」になります。「19:40:00」にはなりません。
- エポック秒が負の値になる日時の場合、正しく書き込まれません。
  例:「1950年01月01日08時59分59秒」の場合、「-08:59:59」になります。
YEAR型
- Stringとしてデータを扱います。
ENUM型、SET型
- マルチバイト文字の入った引数を使用すると、エラーが発生します。
TINYINT UNSIGNED型、MEDIUMINT UNSIGNED型、SMALLINT UNSIGNED型、INT UNSIGNED型、BIGINT UNSIGNED型、FLOAT UNSIGNED型、DOUBLE UNSIGNED型、REAL UNSIGNED型、DECIMAL UNSIGNED型
- [入力/型]および[出力/型]にはUNSIGNEDなしで表示されます。

主な例外

例外名		原因	対策
java.sql.SQLNonTransientConnectionException		データベースに接続できません。	グローバルリソースの[クラスターエンドポイント]または[ポート番号]を確認してください。
java.sql.SQLException	Communications link failure with primary. No active connection found for master. Caused by: java.sql.SQLException: Access denied for user '<ユーザ名>'@'%' to database '<データベース名>'	データベースが存在しません。	グローバルリソースの[データベース名]で存在するデータベースを指定してください。
java.sql.SQLException	Communications link failure with primary. No active connection found for master. java.sql.SQLException: Access denied for user '<ユーザ名>'@'<IPアドレス>' (using password: YES)	ユーザ名、パスワードまたはSSL接続が不正です。	グローバルリソースの[ユーザ名]、[パスワード]または[SSL接続]を確認してください。
java.sql.SQLSyntaxErrorException	Table '<テーブル名>' doesn't exist	テーブルが存在しません。	[テーブル名]で存在するテーブルを指定してください。