ApsaraDB RDS:タイムゾーンの変更

ユースケース

以下のシナリオでは、RDS MySQL インスタンスのタイムゾーンを変更する必要があります。

• RDS MySQL インスタンスのタイムゾーンがビジネスリージョンのタイムゾーンと一致していません。たとえば、2021 年 5 月 30 日より前に作成された RDS MySQL インスタンスのデフォルトのタイムゾーンは SYSTEM です。タイムゾーンをビジネスリージョンのタイムゾーンに変更する必要がある場合があります。

• 米国、カナダ、オーストラリア、ヨーロッパの一部などの国で夏時間と冬時間が切り替わる際には、手動で標準時を調整する必要があります。たとえば、英国が冬時間 (UTC) から夏時間に切り替わる場合、時間を UTC からUTC+1 に変更する必要があります。

注意事項

• タイムゾーンパラメータを変更した後、新しい設定を有効にするには、インスタンスを再起動する必要があります。この操作はオフピーク時間に実行し、アプリケーションに再接続メカニズムがあることを確認することを推奨します。

• MySQL のdefault_time_zone パラメータが SYSTEM に設定されている場合、次のリスクが発生する可能性があります。

  • プライマリノードとセカンダリノード間の時間の不整合

    高性能ローカルディスクを使用する高可用性インスタンスの場合、プライマリノードとセカンダリノードでオペレーティングシステムのタイムゾーンが異なると、これらのノードの MySQL タイムゾーンが不整合になる可能性があります。極端な場合には、データ整合性に影響を及ぼす可能性があります。

  • インスタンスのパフォーマンス低下

    サービスで TIMESTAMP 型のフィールドを頻繁に使用する場合、タイムゾーン変換によってロック競合が発生し、インスタンスのパフォーマンスが変動する可能性があります。

  • JDBCとMySQL間でのCSTタイムゾーンの解析の不整合

    CST タイムゾーンの略語は曖昧です。MySQL はデフォルトで中国標準時 (UTC+08:00) と解釈しますが、一部の JDBC バージョン (8.0.22/23 など) は米国中部標準時 (UTC-06:00) と解釈します。ホストオペレーティングシステムのタイムゾーンが CST の場合、JDBC が MySQL から読み書きするデータが不正確になる可能性があります。典型的な例については、「The time zone CST has different meanings on MySQL Server and on connector/j」をご参照ください。

コンソールでのタイムゾーンの変更

1. RDSインスタンスにアクセスし、上部のリージョンを選択し、対象のRDSインスタンスのIDをクリックします。

2. 左側メニューで、[パラメータ] をクリックします。

3. [変更可能なパラメータ] タブでdefault_time_zone パラメータを見つけ、[実行中のパラメータ値] をクリックし、表示されたダイアログボックスでタイムゾーンの値を変更します。

   説明

   default_time_zone パラメータの値に関する詳細については、「タイムゾーンとUTCオフセットのリファレンス」をご参照ください。

4. 変更の送信 をクリックします。表示されたダイアログボックスで、変更を有効にするタイミングを選択し、[OK] をクリックします。

   説明

   変更を適用する前にキャンセルする場合は、[変更をキャンセル] をクリックします。

API 経由でのタイムゾーンの変更

リクエスト例

この例では、ModifyParameter API を呼び出してdefault_time_zone パラメータの値を+9:00 に変更する方法を示します。

...
// API リクエストのパラメータ設定
        ModifyParameterRequest modifyParameterRequest = ModifyParameterRequest.builder()
                .DBInstanceId("rm-bp1l94k5sw1zxxxxx")
                .parameters("{"default_time_zone":"+9:00"}")
                .forcerestart(true)
                // リクエストレベルの設定を上書きし、HTTP リクエストパラメータなどを設定できます。
                // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
                .build();
...

JSON 形式のレスポンス

HTTP/1.1 200 OK
Content-Type:application/json
{
  "RequestId": "6D698793-FC2B-5FC1-A6DF-33EDAD1AD6AB"
}

タイムゾーン変更の確認

1. RDSインスタンスにアクセスし、上部のリージョンを選択し、対象のRDSインスタンスのIDをクリックします。

2. 左側メニューで、[パラメータ] をクリックします。

3. 履歴の編集 タブで、タイムゾーンパラメータが更新されていることを確認します。

   default_time_zone パラメータの値が SYSTEM から +9:00 に変更されています。

タイムゾーンとUTCオフセットのリファレンス

よくある質問

関連 API

ModifyParameter API を呼び出して、default_time_zone の値を変更できます。