ScalarDB のアップグレード方法
このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。
このガイドでは、ScalarDB を新しいバージョンにアップグレードする方法について説明します。
始める前に
新しいバージョンにアップグレードする前に、ScalarDB Cluster 互換性マトリックスをチェックして、ScalarDB Cluster とクライアント SDK 間の互換性を確認してください。
アップグレード
ScalarDB のバージョンのアップグレードについて詳しくは、実行するアップグレードの種類を選択してください。
- メジャーバージョンへのアップグレード
- マイナーバージョンへのアップグレード
- パッチバージョンにアップグレードする
メジャーバージョンでは下位互換性が維持されません。そのため、あるメジャーバージョンから別のメジャーバージョンにアップグレードするときには、特別な操作が必要になる場合があります。例:
- バックエンドデータベース側のデータベーススキーマを更新します。
- アプリケーションの API を更新します。
メジャーバージョンにアップグレードするときに必要なものの詳細については、アップグレードするメジャーバージョンのリリースノートを参照してください。
マイナーバージョンは下位互換性を維持します。そのため、特別な操作を行わなくても、ScalarDB を同じメジャーバージョン内のマイナーバージョンから別のマイナーバージョンにアップグレードできます。たとえば、バックエンドデータベース側のデータベーススキーマを更新したり、アプリケーション内の API を更新したりする必要はありません。
- ScalarDB Cluster (Enterprise Edition)
- ScalarDB Core library (Community edition)
Scalar Helm Chart を使用して ScalarDB Cluster をデプロイする場合は、次のようにして ScalarDB Cluster のデプロイをアップグレードできます。
-
ScalarDB Cluster Helm Chart のバージョンを環境変数として設定します。これを行うには、次のコマンドを実行して、チャートのバージョンを環境変数
SCALAR_DB_CLUSTER_CHART_VERSIONに設定します。SCALAR_DB_CLUSTER_CHART_VERSION=1.5.0ヒントScalarDB Cluster バージョンに対応するチャートバージョンを検索するには、次のコマンドを実行します。
helm search repo scalar-labs/scalardb-cluster -l次のコマンドは役に立つかもしれませんが、山括弧内の内容を ScalarDB Cluster のバージョンに置き換えてください。
SCALAR_DB_CLUSTER_VERSION=<MAJOR>.<MINOR>.<PATCH>; SCALAR_DB_CLUSTER_CHART_VERSION=$(helm search repo scalar-labs/scalardb-cluster -l | grep -F "${SCALAR_DB_CLUSTER_VERSION}" | awk '{print $2}' | sort --version-sort -r | head -n 1) -
次のように山括弧内の内容を置き換えて、ScalarDB Cluster のデプロイメントをアップグレードします。
helm upgrade <RELEASE_NAME> scalar-labs/scalardb-cluster -n <NAMESPACE> -f /<PATH_TO_YOUR_CUSTOM_VALUES_FILE_FOR_SCALARDB_CLUSTER> --version ${SCALAR_DB_CLUSTER_CHART_VERSION}
ScalarDB Cluster のデプロイメントをアップグレードした後は、アプリケーション側の ScalarDB Cluster Java Client SDK または ScalarDB Cluster .NET Client SDK のバージョンをアップグレードすることを検討する必要があります。
ScalarDB Core は Java ライブラリとして提供されます。そのため、Java プロジェクトの依存関係を更新し、アプリケーションを再構築して ScalarDB のバージョンをアップグレードできます。
パッチバージョンは下位互換性を維持します。そのため、特別な操作を行わなくても、メジャーバージョンとマイナーバージョンが同じであれば、ScalarDB をあるパッチバージョンから別のパッチバージョンにアップグレードできます。たとえば、バックエンドデータベース側でデータベーススキーマを更新したり、アプリケーションで API を更新したりする必要はありません。
パッチバージョンへのアップグレード方法は、マイナーバージョンへのアップグレード方法と同様です。アップグレード方法の詳細については、マイナーバージョンへのアップグレードタブを参照してください。
ScalarDB は、以前のバージョン (メジャー、マイナー、またはパッチ) へのダウングレードをサポートしていません。新しいバージョンへのアップグレードのみ可能です。