すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for ClickHouse:マイナーエンジンバージョンのアップグレード

最終更新日:May 10, 2026

古いマイナーエンジンバージョンを使用していると、サービス中断やデータ損失が発生する可能性があります。Alibaba Cloud ClickHouse では、手動でマイナーエンジンバージョンをアップグレードできます。マイナーエンジンバージョンのアップグレードにより、パフォーマンスの向上、新機能の追加、バグ修正などが提供されます。

注意事項

  • マイナーエンジンバージョンのアップグレードは、2021 年 12 月 1 日以降に購入したクラスターに対してのみ実行できます。

  • アップグレード中のサービスへの影響:

    • Community-Compatible Edition:アップグレードプロセスによりクラスターが再起動され、1~5 分間のサービス中断が発生します。これは平均的な見積もりであり、実際の所要時間はご利用のクラスター内のパーツ数やコールドストレージの量によって大幅に長くなる可能性があります。より正確な見積もりを得るために、最近のクラスター再起動に要した時間を確認することを推奨します。オフピーク時間帯にアップグレードを実施し、アプリケーションに再接続メカニズムが備わっていることを確認してください。

    • Enterprise Edition:ノードがバッチ単位で順次再起動されるため、アップグレード中も常にクラスター内のノードの半数以上がリクエストを処理できる状態を維持します。

  • 新しいマイナーエンジンバージョンがリリースされると、Alibaba Cloud ClickHouse は Alibaba Cloud アカウントに関連付けられた連絡先に通知を送信します。最新バージョンへの速やかなアップグレードを推奨します。通知受領後 6 か月以内にアップグレードを行わなかった場合、その結果として発生するビジネス上の中断、データ損失、その他の一切の影響について、お客様ご自身の責任となります。

  • アップグレード後にマイナーエンジンバージョンをダウングレードすることはできません。

  • Enterprise Edition クラスターを初めてバージョン 25.10 以降にアップグレードする際、システムは自動的に default_role ロールを作成し、すべての既存ユーザに付与します。default_role ロールは、その後に作成される一般ユーザにも自動的に付与され、バージョンアップグレードによる権限の後退を防ぎます。

    説明

    新しいマイナーエンジンバージョンでは、より細かい権限制御が導入される場合があります。スムーズなアップグレードを保証するため、システムは新たに追加された権限チェックポイントを default_role ロールに自動的に付与します。

    default_role に付与された権限が特定のユーザにとって過剰である場合は、REVOKE コマンドを実行してロールを取り消すことができます。ただし、ロールを取り消すと、今後のバージョンアップグレード後に必要な権限が不足し、クエリエラーが発生する可能性があります。

    あるユーザに default_role ロールが付与されていないことが判明した場合は、特権アカウントを使用して手動で付与できます。

  • マイナーエンジンバージョンのアップグレード中は、クラスター情報の閲覧のみ可能です。クラスターのスペックアップグレード、スケールアウト、スケールイン、再起動、パラメーター構成の変更は実行できません。

  • Alibaba Cloud ClickHouse コンソールの マイナーバージョン情報 の横にアスタリスク(*)が表示されている場合、現在のバージョンではマイナーエンジンバージョンのアップグレードがサポートされていません。

マイナーエンジンバージョンのアップグレード

  1. Alibaba Cloud ClickHouse コンソール にログインします。

  2. 左上隅で、対象クラスターが配置されているリージョンを選択します。

  3. クラスターリスト ページで、対象クラスターの ID をクリックしてクラスター情報ページを開きます。

  4. 構成情報 セクションで、マイナーバージョン情報 の横にある カーネルマイナーバージョンのアップグレード をクリックします。

    説明

    現在は最新バージョンです と マイナーバージョン情報 の横に表示されている場合、マイナーエンジンバージョンのアップグレードは不要です。

  5. マイナーバージョンのアップグレード ダイアログボックスで、バージョンにアップグレードが可能です および アップグレード時間 を選択し、を決定 をクリックします。

    説明

    アップグレード処理には約 10 分かかります。クラスターのステータスが 実行中 に変化すると、アップグレードが完了します。