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の以下のメッセージが表示されます。

info.png

データベーススキーマにおけるフィールド長の変更

Sitecore 10.4.0からは、UserName、Email、ArchivedByなどのフィールドの長さが320に延長されました。

アップグレードプロセスの任意のステップとして、フィールド長を320に増やすスクリプトを実行することができます。

!注必要でない限り、フィールドの長さを伸ばすことは強く推奨されません。

フィールドの長さを伸ばすには、データベースアップグレードの最後のステップとして次のスクリプトを実行してください:

  • CMS_core_userName.sql(コアおよびセキュリティデータベースで実行)
  • CMS_master_userName.sql(マスターデータベースで実行)
  • CMS_web_userName.sql(ウェブデータベースの実行)
この記事を改善するための提案がある場合は、 お知らせください!