概要

Nablarchには、MySQL用のDialectがない。
このようなケースにおいてMySQL用のDialectを設定する方法を整理する

やることのまとめ

JDBCドライバの登録

ダイアレクトを追加

実装リファレンスの整理

javadoc

dialect側

postgres(nablarch-core-jdbc)

mysql(hibarnate)

アプリケーション側

その他：大文字小文字関連の取り扱い

collation（照合順序）

決めなければならないこと

※前提：DefaultDialectと同一実装の場合は、オーバーライド不要

No	項目	影響を受けるメソッド	Oracleの場合	MySQLの場合
1	シーケンスオブジェクトの次の値を取得するSQL文	buildSequenceGeneratorSql(java.lang.String sequenceName)	オーバーライド(NEXTVAL)	オーバーライド(?)、ただし、TiDBの場合NEXTVALでよい
2	レコード数取得用のSQL文	convertCountSql(java.lang.String sql)	デフォルト	デフォルト
3	SQLIDからレコード数取得用のSQL文	convertCountSql(java.lang.String sqlId, java.lang.Object condition, StatementFactory statementFactory)	デフォルト	デフォルト
4	SQL文をページング用のSQL文に変換するSQL文	convertPaginationSql(java.lang.String sql, SelectOption selectOption)	オーバーライド(ROWNUM)	オーバーライド(LIMIT,OFFSET)
5	ping用SQL文	getPingSql()	`select 1 from dual`	`select 1`
6	ResultSetから値を取得するための変換クラス	getResultSetConvertor()	オーバーライド	(実地テストで確認)
7	一意制約違反を表す例外のエラーコード	isDuplicateException(java.sql.SQLException sqlException)	1	1062
8	Query Timeアウト時に発生する例外のエラーコード	isTransactionTimeoutError(java.sql.SQLException sqlException)	1013	3024(TiDBも同様)
9	IDENTITY(オートインクリメントカラム)が使用できるか	supportsIdentity()	true	true
10	batch insert時にIDENTITY(オートインクリメントカラム)が使用できるか	supportsIdentityWithBatchInsert()	true	true
11	SQL文でのオフセット指定が使用できるか	supportsOffset()	true	true
12	シーケンスオブジェクトが使用できるか	supportsSequence()	true	false(TiDBはtrue)

オーバーライドが必要そうな機能のチェックポイント

buildSequenceGeneratorSql

デフォルト実装はUnsupportedOperationException
よってシーケンスオブジェクトが使用可能な場合、オーバーライド必須。
NEXTVALを使用できる場合は、NEXTVALを使用する。
- NEXTVALを使用できない場合、代用実装とする。

convertCountSql&convertCountSql

デフォルト実装はSELECT COUNT(*) COUNT_ FROM ('引数のSQL') SUB_
デフォルト実装で事足りるため、基本的にはオーバーライド不要。全ての既存Dialectはオーバーライドをしていない。
- 単にCOUNT文が宣言できれば良い

convertPaginationSql

デフォルト実装はSQL文を変換せずに返すので、ページングされない
よって可能な限りオーバーライドすべき。
offsetとlimitを使用できる場合、offsetとlimitを使用するSQL文に変換
- offsetとlimitを使用できない場合、ROWNUMなどで代用する。

getResultSetConvertor

デフォルト実装はSQL文を変換せずに返す。
利用する型に関して、利用に支障がないならばオーバーライドは不要。
主に、ResultSet#getObject(int)を使用した場合にアプリケーションで処理する際に不都合なデータ型が返却される場合に必要となる。詳細は下記参照。

lower_case_table_names(識別子の大文字と小文字の区別)

lower_case_table_names=1 を全システムで使用してください。 
これの主な欠点は、SHOW TABLES または SHOW DATABASES を使用したときに、  
元の大文字または小文字で名前が表示されないことです。  

Unix 上では lower_case_table_names=0 を、Windows 上では lower_case_table_names=2 を使用してください。   
これでデータベース名とテーブル名の大文字と小文字の区別が保持されます。   
この欠点は、ユーザーのステートメントが、Windows 上で正しい大文字または小文字でデータベース名およびテーブル名を常に参照していることを確認する必要があることです。   
大文字と小文字が区別される Unix にステートメントを転送する場合、大文字と小文字が正しくなければこのステートメントは機能しません。

エラーリファレンス

一意制約違反(ERROR 1062)

クエリタイムアウト(ERROR 3024)

MYSQLには、シーケンスオブジェクトのサポ－トがない

hibarnate-mysql

補足：TiDB,MariaDBの場合はシーケンスオブジェクトを使用できる

TiDBのタイムアウトSQLは、以前は差異があったが現在は同じ

TiDBのベース実装は、基本的にMysqlベースでよい(参考：Hibarnate)

TiDBは、NEXTVALが使える