Commerce Engineのキャッシュ

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore XCソリューションは、次の2つのキャッシュプロバイダーをサポートしています。

Redis - Redisキャッシュプロバイダーは、統合、テスト、運用環境などの分散デプロイで使用するためのものです。デフォルトでは、Commerce EngineはRedisキャッシュを使用します。
Memory - インメモリキャッシュは、単一サーバーのデプロイと開発環境でのみ使用できます。

各Commerce Engineサービスロールには、キャッシュストアがあります。キャッシュ・ストアには複数のキャッシュが含まれており、キャッシュは、環境に関連付けられたアーティファクト・ストアIDに従って、データ・キャッシュ・ストアにグループ化されます。同じアーティファクトストアIDを持つ環境は、キャッシュストア内で同じキャッシュデータを共有しますが、そのキャッシュデータは、異なるアーティファクトストアIDを持つ環境から分離されます。

メモ

Sitecore XCのキャッシュはopt-inモデルに従っており、キャッシュはすべてのコマースエンティティと非エンティティに対してデフォルトで無効になっています。キャッシュするコマースエンティティと非エンティティのキャッシュは、ポリシー設定を通じて明示的に有効にする必要があります。

分散キャッシング

スケーリングされた (または分散された単一サーバー) デプロイの場合は、Redisキャッシュプロバイダーを使用して、システムの一元化されたキャッシュストアをホストできます。各Commerce Engineサービスロールは、要求ヘッダーで指定された環境IDに基づいて、キャッシュストアにアクセスし、キャッシュデータを取得できます。

Diagram showing Redis cache stores for distributed caching using Redis.

メモリキャッシング

単一サービスのデプロイでは、メモリキャッシュプロバイダーを使用してコマースアイテムをキャッシュできます。マシンでホストされているすべてのCommerce Engineサービスロールは、メモリキャッシュストアを使用して、要求ヘッダーで指定された環境IDに基づいてキャッシュされたデータを取得します。

キャッシュプロバイダーの構成

キャッシュプロバイダーの設定は、Commerce Engine config.jsonファイルに保存されます。1つのキャッシュプロバイダーを有効にする必要があり、一度に有効にできるキャッシュプロバイダーは1つだけです。Redisキャッシュプロバイダーは、既定で有効になっています。

},
  "Caching": {
    "Memory": {
      "Enabled": false,
      "CacheStoreName": "Commerce-Memory-Store"
    },
    "Redis": {
      "Enabled": true,
      "CacheStoreName": "Commerce-Redis-Store",
      "IntervalBetweenConnectionAttemptsInSeconds": 60,
      "RedisConnectionPoolSize": 1,
      "RedisCompressionEnabled": true,
      "Options": {
       "Configuration": "PlaceholderForRedisConfiguration",
       "InstanceName": ""PlaceholderForRedisInstanceName"
    }
 }

次の表に、キャッシュプロバイダーの構成パラメーターの一覧と説明を示します。

キャッシュプロバイダー	パラメーター	既定値	形容
記憶	Enabled	false	キャッシュプロバイダーを有効にするかどうかを指定します (bool)。
	CacheStoreName	Commerce-Memory-Store	キャッシュストアの名前を設定します。
	EvictionPercentage	0.2	キャッシュが使用頻度の低いエントリを削除して、新しいエントリ用のスペースを確保するしきい値を設定します。
	MaxSizeInBytes	9223372036854775807 (long.MaxValue)	キャッシュストアで許可される最大サイズをバイト単位で設定します。
	PollingInterval	120	キャッシュストアがメモリ統計を更新するまでの最大時間を秒単位で設定します。
	SizeLimit	Null (制限なし)	キャッシュストアの項目の最大数を設定します。値を指定しない場合、制限はキャッシュで許可される最大サイズ ( MaxSizeInBytes値によって決定される) に基づきます。
	ExpirationScanFrequency	60	期限切れの項目をスキャンする最小間隔 (秒単位) を設定します。
	CompactionPercentage	0.05	最大サイズを超えたときに、キャッシュ・データの割合をcompactに設定する (小数で表します)。
Redis(レディス)	Enabled	true	Redisキャッシュプロバイダーを有効にするかどうかを指定します (bool。
	CacheStoreName	Commerce-Redis-Store	キャッシュストアの名前を設定します。
	intervalBetweenConnectionAttemptsInSeconds	60	失敗した接続が再接続を試行するまでの秒数を設定します。
	redisConnectionPoolSize	1	接続プールに作成できる接続の数を指定します。
	redisCompressionEnabled	true	キャッシュされたデータを圧縮するかどうかを指定します。
	Configuration	PlaceholderForRedisConfiguration	Redisキャッシュプロバイダーの接続文字列を指定します。手記特定のデプロイ要件を満たすために、接続文字列に追加のRedis設定オプションを追加できます。
	InstanceName	PlaceholderForRedisInstanceName	Redisインスタンス名を設定します。

エンティティのキャッシュ構成

Commerce Coreプラグインは、Commerce Engineのエンティティキャッシュを制御するポリシーを提供します。

Commerce Coreプラグインによって定義されるEntityCachingPolicyポリシーは、コマースエンティティのキャッシュ動作を制御します。キャッシュするエンティティごとにエンティティキャッシングポリシーを構成できます。次に、エンティティSitecore.Commerce.Plugin.Content.ContentPathのキャッシュ設定を定義するEntityCachingPolicyの例を示します。

{ 
  "$type": "Sitecore.Commerce.Core.EntityCachingPolicy, Sitecore.Commerce.Core", 
  "EntityFullName": "Sitecore.Commerce.Plugin.Content.ContentPath", 
  "AllowCaching": true, 
  "Priority": "Normal", 
  "Expiration": 86400000, 
  "HasNegativeCaching": true, 
  "CacheName": "ContentPaths", 
  "EntityIdPrefix": "Entity-ContentPath" 
}

次の表では、エンティティキャッシングポリシー設定のパラメータについて説明します。

パラメーター	既定値	形容
EntityFullName	Sitecore.Commerce.Plugin.Content.ContentPath	キャッシュするエンティティ型の完全な名前を設定します。
AllowCaching	true	エンティティのキャッシュを有効または無効にします (bool.) 。
Priority	Normal	キャッシュエントリの優先度を設定します。可能な値は次のとおりです。低い正常高いネバーリムーブ
Expiration	86400000	キャッシュエントリの有効期限が切れるまでの時間の長さをミリ秒単位で設定します。
AbsoluteExpirationRelativeToNow	300000	キャッシュエントリの有効期限を現在のタイムスタンプを基準にして、ミリ秒単位で設定します。
SlidingExpiration	300000	キャッシュエントリがアクセスされていない場合に期限切れになる時間の長さをミリ秒単位で設定します。
HasNegativeCaching	False	エンティティ型のネガティブキャッシングを有効または無効にします (bool.) 。trueに設定すると、エンティティが存在しないという事実がキャッシュされるため、以前に要求され、存在しないエンティティに対してSQL Serverが繰り返し呼び出されるのを防ぐことができます。
CacheName		このエンティティ型のキャッシュの名前を設定します。
EntityIdPrefix		エンティティの種類を識別するプレフィックス。

キャッシング・ポリシー・セット

Sitecore XCソリューションには、システムキャッシュ設定を含むキャッシングポリシーセットファイルが含まれています。Sitecore XCソリューションに含まれるすべての既定の環境 (Habitatなど) は、既定のキャッシュポリシーセットを参照します。

Plugin.Caching.PolicySet-1.0.0.jsonファイルはwwwroot\data\Environmentsフォルダーに格納され、コマースエンティティと非エンティティのキャッシュポリシーが含まれています。

キャッシング・ポリシー・セットには、以下のコマース・エンティティー・キャッシュのポリシー構成が含まれています。

コンテンツパスキャッシュ
コンテンツ項目キャッシュ
ショップキャッシュ
ポリシー・セット・キャッシュ
エンティティインデックスキャッシュ
プロモーションキャッシュ
プロモーションブックキャッシュ
カタログ・キャッシュ
カテゴリキャッシュ
リレーションシップ定義キャッシュ
Sellable商品キャッシュ
インベントリセットキャッシュ
プライスカードキャッシュ
Price Booksキャッシュ
ローカライゼーションエンティティキャッシュ
バージョニングエンティティキャッシュ
ワークフローキャッシュ
検索ステータスキャッシュ

さらに、キャッシング・ポリシー・セットには、以下の非エンティティー・アイテムのキャッシング・ポリシー構成が含まれています。

管理キャッシュ (Commerce Control Panelから品目モデルオブジェクトをキャッシュします)
カスタム関係キャッシュ (カスタム関係のリストをキャッシュします)
関連付けられた/関連付け解除されたカタログキャッシュ (各プロモーションブックの関連付けられたカタログと関連付け解除されたカタログのリストをキャッシュします)
ローカライズされた用語キャッシュ (コマースのローカライズされた用語の一覧をキャッシュします)
Customer Statusesキャッシュ (ローカライズされた顧客ステータスのリストをキャッシュします)
キャッシュ・ポリシーを返す (ローカライズされた返品理由のリストをキャッシュする)

キャッシングAPIコマンド

キャッシュは、CommerceOps APIを使用して管理します。Postmanサンプル ( SitecoreCommerce_DevOpsコレクションにあります) を使用して、キャッシュコマンドを実行できます。

次の表に、キャッシュのAPIコマンドを示します。

命令	形容
GetCacheStores()	システム内のすべてのキャッシュ・ストアを取得します。
GetCacheStore(name)	名前付きキャッシュストアを取得します。
GetDataCacheStore(name)	キャッシュストア内で、環境のアーティファクトストアIDと一致するキャッシュを取得します。
GetCache(name)	名前付きキャッシュを取得します。キャッシュがキャッシュストアに存在しない場合、システムは404エラーを返します。
ClearCacheStore()	キャッシュストア内のすべてのキャッシュをクリアします。このコマンドは、Redisキャッシュプロバイダーではサポートされていません。Redisのキャッシュストアを直接クリアする必要があります。
ClearDataStoreCaches()	データストア内のすべてのキャッシュをクリアします。Commerce Engineは、要求ヘッダーで指定された環境名からデータストアを決定します。このコマンドは、Redisキャッシュプロバイダーではサポートされていません。Redisで直接データストアをクリアする必要があります。
ClearCache(name)	キャッシュストア内の名前付きキャッシュをクリアします。このコマンドは、Redisキャッシュプロバイダーではサポートされていません。Redisでキャッシュを直接クリアする必要があります。

この記事を改善するための提案がある場合は、お知らせください!

Commerce Engineのキャッシュ

分散キャッシング

メモリキャッシング

キャッシュ プロバイダーの構成

エンティティのキャッシュ構成

キャッシング・ポリシー・セット

キャッシングAPIコマンド

キャッシュプロバイダーの構成