サービス

技能：エンジニア

技能：デザイナー

技能：ビジネス職

技能：バックオフィス

ジャンル

<h2>はじめに</h2>

<p>こんにちは、マーケティングテクノロジー部 田中翔です。</p>

<p>Aurora2の2024年10月31日のサポート終了が迫りに迫ってきました。皆さん、対応は進んでいますでしょうか。</p>

<p>この記事を見ているということは、このような状態になっていることでしょう。</p>

<p><img alt="status_db_upgrade" height="307" src="https://image.dmm-corp.com/ot56e8szfa84b7zgmbtxuxk9in61" width="607" /></p>

<p>この記事では、Aurora MySQLのアップグレードを駆け込みでやりたい方向けに、できるだけ情報をまとめようと思います。</p>

<p><strong>2024年夏...！早めのアップグレードを！！</strong></p>

<h2>アップグレード方式いっぱいあるやん</h2>

<p>そうなんです、以下の方式があります。</p>

<h3>インプレースアップグレード</h3>

<ul>
	<li>既存のクラスタをそのままアップグレードする方法</li>
	<li>メリット
	<ul>
		<li>作業自体は一番簡単で、クラスターのバージョンを上げるだけ</li>
		<li>IaCを使っている環境であれば、バージョンを変えるだけで上がる</li>
		<li>アプリケーションの向き先を変える必要がない</li>
	</ul>
	</li>
	<li>デメリット
	<ul>
		<li>検証した結果、ダウンタイムが約20分発生する</li>
		<li>切り戻しする際には、スナップショットから復旧する必要がある</li>
	</ul>
	</li>
	<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.MajorVersionUpgrade.html#AuroraMySQL.Upgrading.Procedure">参考記事</a></li>
</ul>

<h3>スナップショットリストア</h3>

<ul>
	<li>スナップショットから新クラスタを作成する</li>
	<li>メリット
	<ul>
		<li>別クラスタを立てるため、問題発生時に切り戻ししやすい</li>
		<li>作業的には比較的簡単</li>
		<li>ダウンタイムがほぼ発生しない</li>
	</ul>
	</li>
	<li>デメリット
	<ul>
		<li>スナップショット作成前に、書き込みを停止させる必要がある</li>
		<li>アプリケーションの向き先を変更する必要がある</li>
		<li>IaCだけで作業できない</li>
	</ul>
	</li>
	<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/aurora-restore-snapshot.html">参考記事</a></li>
</ul>

<h3>バイナリログレプリケーションを使用したアップグレード</h3>

<ul>
	<li>新DB立ち上げ &rarr; 旧DBとバイナリログレプリケーション &rarr; DB切り替え</li>
	<li>メリット
	<ul>
		<li>ダウンタイムを最小に抑えることができる</li>
		<li>Blue/Greenデプロイを使えない場面で活躍</li>
	</ul>
	</li>
	<li>デメリット
	<ul>
		<li>移行作業が多い</li>
		<li>ダウンタイムが2回必要
		<ul>
			<li>パラメータの変更（binlog_format）で1回再起動と切替時</li>
		</ul>
		</li>
		<li>IaCだけで作業できない</li>
	</ul>
	</li>
	<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Replication.MySQL.html">参考記事</a></li>
</ul>

<h3>Blue/Greenデプロイ</h3>

<ul>
	<li>本番環境とステージング環境のクラスタが立ち上がりレプリケーションされており、切り替えも簡単</li>
	<li>メリット
	<ul>
		<li>ダウンタイムがほぼ発生しない</li>
		<li>エンドポイントを変えずに切り替え可能</li>
		<li>作業が簡単</li>
	</ul>
	</li>
	<li>デメリット
	<ul>
		<li><strong>RDS Proxyのターゲットに紐づいたクラスターは使用できない！</strong></li>
		<li>パラメータの変更（binlog_format）で1回再起動が必要</li>
		<li>IaCだけで作業できない
		<ul>
			<li><a href="https://github.com/hashicorp/terraform-provider-aws/issues/28956">Terraform issue</a></li>
		</ul>
		</li>
	</ul>
	</li>
	<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html">参考記事</a></li>
</ul>

<p>何選んだらいいんや...となっている方は以下を参考にしてみてください。</p>

<p><img alt="choice_aurora_upgrade" height="506" src="https://image.dmm-corp.com/sgz4qj1vtpex09js5r9714ufmsbz" width="573" /></p>

<p>&nbsp;</p>

<h2>バイナリログレプリケーション</h2>

<p>マーケティングテクノロジー部で使用しているAurora MySQLは、広告配信や広告効果計測で使用しています。</p>

<p>以下の理由からダウンタイムを許容できない状態でした。</p>

<ul>
	<li>データベースから定期バッチでRedisに配信情報キャッシュを乗せており、TTLが切れた場合に配信情報が空になる可能性がある</li>
</ul>

<ul>
	<li>広告効果計測をストリーミングでリアルタイム集計している</li>
	<li>さまざまな事業部が数百以上の広告配信枠に日々入稿設定をしている</li>
</ul>

<p>そのためBlue/Greenデプロイでのアップグレードで進めることになりましたが、ステージング環境で問題が発生しました。</p>

<p><strong>なんと、RDS Proxyに紐づいているAurora MySQLはBlue/Greenデプロイが使用できません。</strong></p>

<p>このような経緯もあり、今回バイナリログレプリケーションでのアップグレードを選択しましたので、深堀って記載します。</p>

<h4>アプリケーション事前準備</h4>

<ul>
	<li>クラスターに直接接続しているアプリケーションが紛れ込んでるかもしれません。洗い出しましょう。</li>
</ul>

<h4>レプリケーションソースでバイナリログの有効化</h4>

<ul>
	<li>クラスターパラメータグループのbinlog_formatをMIXEDに変更し、再起動適用</li>
</ul>

<pre>
<code class="language-sql"> -- 確認
show global variables like 'binlog_format';</code></pre>

<ul>
	<li>バイナリログの保持期間を設定</li>
</ul>

<pre>
<code class="language-sql">-- 1週間に設定
CALL mysql.rds_set_configuration('binlog retention hours', 144);

-- 確認
CALL mysql.rds_show_configuration;</code></pre>

<h4>レプリケーションソースでレプリケーションユーザーを作成</h4>

<ul>
	<li>ユーザ作成</li>
</ul>

<pre>
<code class="language-sql">-- 作成、権限付与
CREATE USER 'repl_user'@'%' IDENTIFIED BY 'password';
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'%';

-- 確認
SELECT * FROM mysql.user WHERE User = 'repl_user';</code></pre>

<h4>新DBクラスター作成</h4>

<ul>
	<li>クラスタースナップショットを作成し、復元</li>
	<li>リーダーインスタンスも追加</li>
	<li>ライターインスタンスの最近のイベントでレプリケーションスタート位置が出てくるので、メモ</li>
</ul>

<pre>
<code>Binlog position from crash recovery is mysql-bin-changelog.000001 1000</code></pre>

<ul>
	<li>Aurora3のパラメータグループを作成して、新DBクラスターをAurora3にアップグレード</li>
</ul>

<h4>レプリカターゲットでレプリケーション開始</h4>

<ul>
	<li>レプリケーションを設定</li>
</ul>

<pre>
<code class="language-sql">-- バイナリファイルと位置修正しレプリケーションセット
CALL mysql.rds_set_external_source ('レプリケーションソース エンドポイント', 3306, 'repl_user', 'password', 'mysql-bin-changelog.000001', 1000, 0);

-- レプリケーション開始
CALL mysql.rds_start_replication;</code></pre>

<ul>
	<li>レプリケーションチェック</li>
</ul>

<pre>
<code class="language-sql">-- Seconds_Behind_Sourceが0の場合、レプリカラグが無い
SHOW REPLICA STATUS;

-- エラークエリをスキップするとき
CALL mysql.rds_skip_repl_error;</code></pre>

<h4>DB切り替え</h4>

<ul>
	<li>RDS Proxyのターゲットを切り替え</li>
	<li>レプリケーションの設定を停止</li>
</ul>

<pre>
<code class="language-sql">-- 停止
CALL mysql.rds_stop_replication;
CALL mysql.rds_reset_external_source;</code></pre>

<h2>IaCと整合性取れなくなったぞ</h2>

<p>ご安心ください。</p>

<p>Terraformで管理されている方は、対象のリソースの状態管理を外してインポートし直しましょう。</p>

<pre>
<code class="language-bash">$ terraform state rm aws_rds_cluster.xxx
$ terraform state rm aws_rds_cluster_instance.xxx
$ terraform state rm aws_db_parameter_group.xxx
$ terraform state rm aws_rds_cluster_parameter_group.xxx
$ terraform state rm aws_db_proxy_target.xxx

$ terraform import aws_rds_cluster.xxx yyy
$ terraform import aws_rds_cluster_instance.xxx yyy 
$ terraform import aws_db_parameter_group.xxx yyy 
$ terraform import aws_rds_cluster_parameter_group.xxx yyy 
$ terraform import aws_db_proxy_target.xxx yyy </code></pre>

<p>ここからstateを見つつテンプレートを修正してapplyすれば、完璧です。</p>

<p>Cloudformationの場合は、新DBのスタックを作成してやる形になるかと思います。</p>

<h2>ところでMySQL8.0で何が変わったの？</h2>

<p>全て見ていくのは大変ですよね、そこで影響が大きいものを抜粋してまとめます。</p>

<h3>DB全般関連</h3>

<ul>
	<li>認証方式
	<ul>
		<li>mysql_native_passwordからcaching_sha2_passwordに変更。Aurora3ではmysql_native_passwordプラグインが引き続き使用されるため影響が無い</li>
	</ul>
	</li>
	<li>いくつかのサーバーエラーコードが削除
	<ul>
		<li>アプリケーションテストで利用している場合は、影響有り</li>
		<li><a href="https://dev.mysql.com/doc/refman/8.0/ja/mysql-nutshell.html#mysql-nutshell-removals" rel="nofollow">https://dev.mysql.com/doc/refman/8.0/ja/mysql-nutshell.html#mysql-nutshell-removals</a></li>
	</ul>
	</li>
</ul>

<ul>
	<li>文字セットのデフォルトが変更
	<ul>
		<li>character_set_serverおよびcharacter_set_databaseシステム変数のデフォルト値がlatin1からutf8mb4に変更</li>
	</ul>
	</li>
	<li>Collationのデフォルトが変更
	<ul>
		<li>collation_serverおよびcollation_databaseシステム変数のデフォルト値がlatin1_swedish_ciからutf8mb4_0900_ai_ciに変更</li>
	</ul>
	</li>
	<li>InnoDB INFORMATION_SCHEMA ビューの名前が変更</li>
</ul>

<h3>クエリ関連</h3>

<ul>
	<li>GROUP BY句のASC修飾子またはDESC修飾子は削除</li>
</ul>

<ul>
	<li>予約語の追加
	<ul>
		<li><a href="https://dev.mysql.com/doc/refman/8.0/ja/keywords.html#keywords-new-in-current-series" rel="nofollow">https://dev.mysql.com/doc/refman/8.0/ja/keywords.html#keywords-new-in-current-series</a></li>
	</ul>
	</li>
</ul>

<ul>
	<li>正規表現の再実装
	<ul>
		<li>既存の正規表現を使用したクエリの影響確認</li>
	</ul>
	</li>
</ul>

<ul>
	<li>AUTO_INCREMENT
	<ul>
		<li>FLOAT型およびDOUBLE型のカラム(およびシノニム)では非推奨</li>
	</ul>
	</li>
</ul>

<ul>
	<li>クエリーキャッシュが削除</li>
</ul>

<ul>
	<li>暗号化関連のファンクションが一部削除
	<ul>
		<li>ENCODE(), DECODE(), ENCRYPT(), DES_ENCRYPT(), DES_DECRYPT()&nbsp;</li>
	</ul>
	</li>
</ul>

<ul>
	<li>SQLで\NをNULLのシノニムとして処理しなくなった</li>
</ul>

<ul>
	<li>64 文字を超える外部キーの制約名があってはいけない</li>
</ul>

<ul>
	<li>COUNT(*)が失速する可能性</li>
	<li>ソート時のメモリ不足発生の可能性</li>
</ul>

<p>&nbsp;</p>

<p>詳細情報は公式ページをご確認ください。</p>

<ul>
	<li><a href="https://dev.mysql.com/doc/refman/8.0/ja/upgrading-from-previous-series.html">MySQL 8.0 の新機能</a></li>
	<li><a href="https://dev.mysql.com/doc/refman/8.0/ja/mysql-nutshell.html#mysql-nutshell-removals">MySQL 8.0 で削除された機能</a></li>
	<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.MySQL.html#USER_UpgradeDBInstance.MySQL.57to80Prechecks">RDS MySQL 5.7 から 8.0 へのアップグレードの事前確認</a></li>
</ul>

<h2>パラメータグループも変わったよね？</h2>

<p>もちろんそうなんです。差分は以下で確認してみましょう。</p>

<ul>
	<li>インスタンスパラメータグループ（デフォルトのパラメータ名はdefault.aurora-mysql5.7, default.aurora-mysql8.0）</li>
</ul>

<pre>
<code class="language-bash">$ aws rds describe-db-parameters --db-parameter-group-name xxx --profile yyy | jq --sort-keys -r '["ParameterName","ParameterValue","IsModifiable"],(.Parameters[] | [.ParameterName,.ParameterValue,.IsModifiable]) | @csv'</code></pre>

<ul>
	<li>クラスタパラメータグループ（デフォルトのパラメータ名はdefault.aurora-mysql5.7, default.aurora-mysql8.0）</li>
</ul>

<pre>
<code class="language-bash">$ aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name xxx --profile yyy | jq --sort-keys -r '["ParameterName","ParameterValue","IsModifiable"],(.Parameters[] | [.ParameterName,.ParameterValue,.IsModifiable]) | @csv'</code></pre>

<p>そんなのスプレッドシートにまとめて比較する時間無いよ！って方は、こちらをどうぞ。</p>

<p>2つのパラメータグループのsdiffを取るようになっています。awkはBSDではなく、GNU版を使ってください。（シェル芸もっと上手くなりたい）</p>

<pre>
<code class="language-bash">$ echo "default.aurora-mysql5.7" "default.aurora-mysql8.0" | gawk 'BEGIN {printf "sdiff "}{for(i=1;i&lt;=NF;i++)printf "&lt;(aws rds describe-db-parameters --db-parameter-group-name " $i " --profile xxx | jq --sort-keys -r '\''[\"ParameterName\",\"ParameterValue\",\"IsModifiable\"],(.Parameters[] | [.ParameterName,.ParameterValue,.IsModifiable]) | @csv'\'') "}' | bash</code></pre>

<p>Character, Collationの設定は変更が大きいので、確認してみてください。</p>

<h2>おわりに</h2>

<p>アップグレード方式、変更点、パラメータグループについてまとめてみました。</p>

<p>私は<strong>ステージング環境のDBインスタンスを吹き飛ばすミス</strong>をしてしまいましたが（幸いにもリーダーインスタンス追加で助かりました）、皆さんのアップグレードが成功するよう祈っています。</p>

<p>駆け込みでもまだ時間は残っています、アップグレードを終わらせて良いシルバーウィークをお過ごしください！</p>


Amazon Aurora MySQLアップグレード駆け込みガイド

シェア

一緒に働く仲間を募集しています！

関連する求人

関連する記事