bulk insert文が複数行の時に実行エラー

[clappers-yokoyama]

mybatis-migrations-3.3.11を使用して、localhostのmysql Ver 8.3.0 for Win64 on x86_64に対してsqlファイルを流した際
文字列内に半角セミコロン（;）があり、かつその後に改行されてsql文が続く場合に下記の実行エラーが発生します。

エラー内容：

ERROR: Error executing command.  Cause: java.lang.RuntimeException: Error executing: INSERT INTO `_text` (`id`, `japanese`, `english`, `datetime`)
	VALUES
		('A', 'ａ;Ａ', 'a
.  Cause: java.sql.SQLSyntaxErrorException: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ''a' at line 3

---

_textテーブル定義は

CREATE TABLE IF NOT EXISTS _text (
	`id` VARCHAR(255) NOT NULL,
	`japanese` TEXT NOT NULL,
	`english` TEXT NOT NULL,
	`datetime` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP() ON UPDATE CURRENT_TIMESTAMP(),
	PRIMARY KEY (`id`) USING BTREE
);

となっており、このテーブルに対して以下のbulk insert文を投げる事でエラーが発生します。

SET @now = '2025-06-20 12:00:00';

INSERT INTO `_text` (`id`, `japanese`, `english`, `datetime`)
	VALUES
		('A', 'ａ;Ａ', 'a;A', @now),
		('B', 'ｂ;Ｂ', 'b;B', @now);

この時"japanese"と"english"カラムに入れる文字列をセミコロンのみ「('A', ';', ';', @now),」にしてもエラーが発生します。
ですが上記sqlを下記のように改行を削除する修正でエラーは発生せず正しく動作します。

SET @now = '2025-06-20 12:00:00';

INSERT INTO `_text` (`id`, `japanese`, `english`, `datetime`)
	VALUES
		('A', 'ａ;Ａ', 'a;A', @now), ('B', 'ｂ;Ｂ', 'b;B', @now);

このように回避方法はありますが、可読性の側面からもbulk insert時に改行をして管理を行いため
修正の程よろしくお願いいたします。

[harawata]

Hello @clappers-yokoyama ,

This seems to be a side effect of the fix for mybatis/old-google-code-issues#561 .

In hindsight, the fix was probably incorrect because the current behavior contradicts the explanation in the environment file.
Simply reverting the change, however, is no longer an option as it will break currently working migrations.

migrations/src/main/resources/org/apache/ibatis/migration/template_environment.properties

Lines 52 to 53 in 2eabf1f

	# By default statements are delimited by an
	# end of line semicolon. Some databases may

As a literal containing semicolons is kind of an irregular data, I prefer not to introduce a new option for this.

I think the script still works if you 1) add allowMultiQueries=true to the JDBC connection URL and 2) set send_full_script=true in Migrations config.
Could you try that, please?

---

こちらは mybatis/old-google-code-issues#561 に対する 修正 の副作用のようです。
単純に元の動作に戻すと後方互換性が失われてしまうので、それは難しいというのはご理解頂けると思います。
また、セミコロンを含む文字列というレアケースに対応するためだけに新たな設定項目を追加するのはできれば避けたいと考えています。

JDBC 接続 URL に allowMultiQueries=true を追加し、Migrations の設定で send_full_script=true を指定することで回避できるのではないかと思いますが、こちらを試してみて頂けますか？

[clappers-yokoyama]

@harawata
ご返信ありがとうございます。

JDBC 接続 URL に allowMultiQueries=true を追加し、Migrations の設定で send_full_script=true を指定することで回避できるのではないかと思いますが、こちらを試してみて頂けますか？

上記の対応で問題の回避を行う事が出来ました。
回避手段のご提示ありがとうございました。
また今回問題となっている箇所のご提示も誠にありがとうございます。

---

ただこの修正内容を確認させて頂いたところ、

セミコロンを含む文字列というレアケース

というのは語弊がありそうです。
基本的にdelimiterがセミコロンから変わることは無いと存じていますが、delimiterが別の文字列になった時に
その文字列を含む文字列によってこの問題は恒久的に続いていくと存じます。
そのためこの問題は早急では無いですが、修正すべき内容だと存じます。

---

修正方針として

レアケースに対応するためだけに新たな設定項目を追加するのはできれば避けたいと考えています。

こちらはおっしゃる通りだと思います。
そのため方法の1つとしてご提案させていただくと、
正規表現を使用して"['\"].*['\"]"を空文字へ変換しdelimiterが含まれるかチェックする手段があると存じます。
Javaで実装すると!fullLineDelimiter && trimmedLine.replaceAll("['\"].*['\"]", "").contains(delimiter)となりますでしょうか？
ただ自分はjava及び、このプロジェクトに精通している訳ではないので、
・この処理による負荷が許容されるものなのか？
・影響範囲がどこまで広がり、今回問題としている箇所以外でエンバグが発生してしまうのか？
このあたりがクリアされているのか、その他問題が無いかなどは自分の方では不明ですので、
ご検討いただければ幸いという所感です。

[harawata]

There is a special syntax for switching the delimiter.
It is mainly used to write stored procedures, etc., but it could be useful here.
See the example at the bottom.

It is also possible to change the default delimiter by specifying delimiter in the config.

I should also mention that we avoid analyzing script content as SQL.

---

デリミタを切り替える場合は特別な構文が用意されています。
主にストアドプロシージャなどを記述する際に使われる構文ですが、今回のようなケースで使うこともできます。
末尾のサンプルを参照してください。

尚、設定ファイルで delimiter を指定すればデフォルトのデリミタを変更することも可能です。

引用符で囲まれている部分を文字列リテラルとみなす、というのは単純で妥当な仮定に見えるかも知れませんが、SQL には必ず例外があるモノなので、基本方針としてスクリプトの中身を SQL として解析するような実装は避けています。

---

SET @now = '2025-06-20 12:00:00';

--//@DELIMITER |

INSERT INTO `_text` (`id`, `japanese`, `english`, `datetime`)
	VALUES
		('A', 'ａ;Ａ', 'a;A', @now),
		('B', 'ｂ;Ｂ', 'b;B', @now)|

--//@DELIMITER ;

[clappers-yokoyama]

SQL には必ず例外があるモノなので、基本方針としてスクリプトの中身を SQL として解析するような実装は避けています。

方針について何も知らず、指摘しまい申し訳ありません。
差し出口だったようです。

今回の問題としては回避方法がいくつか見つかりましたので大丈夫かと存じます。

ただ根本の解決となったわけではないという認識ですので、
今後妙案が思いついた際に修正されることを祈っています。

様々な観点からのご対応、誠にありがとうございました。