Sitecore SQLアップグレードプロセス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore SQLアップグレードのプロセス:
-
データベースのアップグレード
データベースアップグレードスクリプトには、互換性を確保するためにSitecoreデータベースに適用すべき変更が含まれています。また、特定のテーブルやコレクションを修正し、新機能をサポートしパフォーマンスを向上させます。変更はデータベースごとに一度だけ適用しなければなりません。
Sitecore Upgradeコンテナには、アップグレードが必要なすべてのデータベースに必要なアップグレードスクリプトが含まれており、特定の順序で実行されます。
-
データベース内のリソース項目を整理します
!注Sitecore XP 10.1.0以降からのアップグレードであれば、データベース内のリソース項目の整理は不要です。
Sitecoreプラットフォームの進化に伴い、データベース内の一部の項目が変更または削除され、新しい項目が追加されます。Sitecore XP 10.1.0では、リソースとしての 項目 戦略に変更し、リソース項目はSitecore.MasterおよびSitecore.Coreデータベースから削除されました。これにより、アップグレードするSitecore XPバージョンと整合したデータベース内のデータを保つことができます。
Sitecoreアップグレードコンテナには、アップグレードの一環として自動的にデータベースからSitecoreリソース項目を削除するクリーンアップツールが含まれています。
!重要Sitecoreのリソース項目を修正した場合、それらはデータベースから削除されません。これらの項目を個別に確認し、修正されたバージョンを保持するか、データベースから削除して新しいバージョンをリソースファイルとして利用するかを判断してください。新しいバージョンの使用をお勧めします。
詳細については、アップグレードガイド の「コンテンツデータベースの整理」セクションをご参照Sitecore XP。
データベースのアップグレードプロセス
Sitecore XP 10.2.X以降、データベースのアップグレードプロセスはより柔軟になり、アップグレードするSitecore XPバージョンとアップグレードするバージョンを指定できるようになりました。
この情報は以下のDocker env変数で指定されています:
- DATABASE_UPGRADE_FROM_VERSION
- DATABASE_UPGRADE_TO_VERSION
これらの値をデータベースアップグレードで指定しない場合は、デフォルトの数値が使われます。
デフォルト値はそれぞれ10.4.0と10.5.Xです。
Sitecore現在、Sitecore XP 9.3.0から10.4.XからSitecore XP 10.5.Xへのデータベースアップグレードをサポートしています。
Sitecore版より
XM1
XP1
9.3.0-10.0.X
一般的な環境変数をリスト*
IS_ALWAYS_ENCRYPTED
PROCESSING_ENGINE_TASKS_DATABASE_USERNAME
10.1.X-10.4.X
一般的な環境変数をリスト*
*XM1およびXP1トポロジーには以下の一般的なenv変数リストを使用してください:
- SQL_SERVER
- SQL_USERNAME
- SQL_PASSWORD
- DATABASE_UPGRADE_FROM_VERSION
- DATABASE_UPGRADE_TO_VERSION
- SITECORE_LICENSE
Docker env変数の詳細については、付録C – 環境変数リストをご覧ください。
アップグレードは基準を満たしました
データベースのアップグレードプロセスは慎重に記録されており、プロセスの詳細はDockerコンテナやKubernetesポッドログで確認できます。
ログはコンテナ内のC:\logs\DatabaseUpgradeScriptsLog.txtファイルに保存されます。
データベースのアップグレードプロセスが正常に完了すると、ログおよび端末にExitCode 0の以下のメッセージが表示されます。

データベーススキーマにおけるフィールド長の変更
Sitecore 10.4.0からは、UserName、Email、ArchivedByなどのフィールドの長さが320に延長されました。
アップグレードプロセスの任意のステップとして、フィールド長を320に増やすスクリプトを実行することができます。
!注必要でない限り、フィールドの長さを伸ばすことは強く推奨されません。
フィールドの長さを伸ばすには、データベースアップグレードの最後のステップとして次のスクリプトを実行してください:
- CMS_core_userName.sql(コアおよびセキュリティデータベースで実行)
- CMS_master_userName.sql(マスターデータベースで実行)
- CMS_web_userName.sql(ウェブデータベースの実行)