---
title: "Sitecore SQLアップグレードプロセス"
slug: "sitecore-sql-upgrade-process"
abstract: ""
---
# Sitecore SQLアップグレードプロセス

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のリソース項目を修正した場合、それらはデータベースから削除されません。これらの項目を個別に確認し、修正されたバージョンを保持するか、データベースから削除して新しいバージョンをリソースファイルとして利用するかを判断してください。新しいバージョンの使用をお勧めします。
    > 
    > 詳細については、[アップグレードガイド](https://doc.sitecore.com/xp/en/developers/105/guides/upgrade-guide-for-sitecore-experience-platform-1050/clean-up-the-content-databases.html) の「コンテンツデータベースの整理」セクションをご参照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 – 環境変数リスト](https://doc.sitecore.com/xp/ja/developers/105/guides/sitecore-xp-105-upgrade-container-deployment-guide/appendix-c---the-environment-variables-list.html "Appendix C - The environment variables list")をご覧ください。

## アップグレードは基準を満たしました

データベースのアップグレードプロセスは慎重に記録されており、プロセスの詳細はDockerコンテナやKubernetesポッドログで確認できます。

ログはコンテナ内のC:\\logs\\DatabaseUpgradeScriptsLog.txtファイルに保存されます。

データベースのアップグレードプロセスが正常に完了すると、ログおよび端末にExitCode 0の以下のメッセージが表示されます。

![info.png](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/105/guides/sitecore-xp-105-upgrade-container-deployment-guide/images/info.png)

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

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

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

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

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

-   CMS\_core\_userName.sql(コアおよびセキュリティデータベースで実行)
-   CMS\_master\_userName.sql(マスターデータベースで実行)
-   CMS\_web\_userName.sql(ウェブデータベースの実行)