Commerce Engine caching

Current version: 9.2

From release 9.2 and later, the Sitecore XC solution supports two cache providers:

  • Redis - the Redis cache provider is for use in distributed deployments, including integration, testing, and production environments. By default, Commerce Engine uses Redis caching.

  • Memory - in-memory caching is for use in single-server deployments and development environments only.

Each Commerce Engine service role has a cache store.  The cache store contains multiple caches, which are grouped into data cache stores, according to the artifact store ID associated with their environment. Environments that have the same artifact store ID share the same cache data within the cache store, but their cache data is isolated from environments that have different artifact store IDs.

Note

Sitecore XC caching follows an opt-in model, meaning that caching is disabled by default. You must explicitly enable caching for any commerce entities and non-entities that you want to cache through policy configuration.

Memory caching

For single-server deployments, you can use the Memory cache provider to cache commerce items. All Commerce Engine service roles hosted on the machine use the memory cache store to retrieve cached data, based on the environment ID specified in the request header.

Diagram showing cache stores for in-memory caching.

Distributed caching

For scaled deployments, you can use the Redis cache provider to host a centralized cache store for the system. Each Commerce Engine service role can access the cache store and retrieve cached data, based on the environment ID specified in the request header.

Diagram shows that shows the Redis cache stores for distributed caching.

Cache provider configuration

The cache provider configuration is stored in the Commerce Engine config.json file. You must enable one cache provider, and you can only enable one cache provider at a given time. The Redis cache provider is enabled by default.

RequestResponse
},
  "Caching": {
    "Memory": {
      "Enabled": false,
      "CacheStoreName": "Commerce-Memory-Store"
    },
    "Redis": {
      "Enabled": true,
      "CacheStoreName": "Commerce-Redis-Store",
      "Options": {
        "Configuration": "localhost",
        "InstanceName": "Redis"
    }
 }

You can configure the following parameters for your cache provider:

Cache provider

Parameter

Description

Memory

CacheStoreName

Sets the name of the cache store.

Default: false

EvictionPercentage

Sets the threshold at which the cache removes the least recently used entries to make room for new entries.

Default: 0.2.

MaxSizeInBytes

Sets the maximum size in bytes permitted in the cache store.

Default: 9223372036854775807(long.MaxValue)

PollingInterval

Sets the maximum time in seconds after which the cache store updates its memory statistics.

Default: 120

SizeLimit

Sets the maximum  number of items for a cache store. If no value is specified there is no limit and limitation is based on maximum size allowed in cache.

Default: Null (no limit)

ExpirationScanFrequency

Sets the minimum length of time in seconds between scans for expired items.

Default: 60

CompactionPercentage

Sets the percentage of cache data to compact when the maximum size is exceeded.

Default: 0.05

Redis

CacheStoreName

Sets the name of the cache store.

Configuration

Specifies the connection string for the Redis cache provider.

Note

You can append additional Redis configuration options to the connection string to meet specific deployment requirements.

InstanceName

Sets the Redis instance name.

Entity caching configuration

The Commerce Core plugin provides the policies that govern entity caching for the Commerce Engine.

The EntityCachingPolicy policy defines caching behavior for commerce entities. You can configure an entity caching policy for each entity that you want to cache, as shown in the following example:

RequestResponse
{ 
  "$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" 
} 

The following table describes the parameters in the entity caching policy configuration:

Parameter

Description

EntityFullName

Sets the full name of the entity type to be cached.

AllowCaching

Enables or disables caching for the entity.

Default: true.

Priority

Sets the priority for the cache entry. Possible values are:

  • Low

  • Normal

  • High

  • NeverRemove

Expiration

Sets the length of time after which a cache entry expires, in milliseconds.

AbsoluteExpirationRelativeToNow

Sets the length of time after which a cache entry expires relative to the current timestamp, in milliseconds.

SlidingExpiration

Sets the length of time after which a cache entry expires if it has not been accessed, in milliseconds.

HasNegativeCaching

Enables or disables negative caching for the entity type. Negative caching prevents repeated calls to the SQL Server for entities that have been previously requested and do not exist.

CacheName

Sets the name of the cache for this entity type.

EntityIdPrefix

The prefix to identify the entity type.

Caching policy set

The Sitecore XC solution includes a caching policy set file that contains system caching configuration. All default environments included with the Sitecore XC solution (for example, Habitat) reference the default caching policy set.

The Plugin.Caching.PolicySet-1.0.0.json file is stored in the wwwroot\data\Environments folder and contains caching policies for commerce entities and non-entities.

The caching policy set contains policy configuration for the following commerce entity caches:

  • Content paths cache

  • Content items cache

  • Shops cache

  • Policy Sets cache

  • Entity Indexes cache

  • Promotions cache

  • Promotion Books cache

  • Catalogs cache

  • Categories cache

  • Relationship Definitions cache

  • Sellable Items cache

  • Inventory Sets cache

  • Price Cards cache

  • Price Books cache

  • Localization Entities cache

  • Versioning Entities cache

  • Workflows cache

In addition, the Caching policy set contains caching policy configuration for the following non-entity items:

  • Management cache (caches item model objects from the Commerce Control Panel)

  • Custom Relationships cache (caches a list of custom relationships)

  • Associated/Disassociated Catalogs cache (caches a list of associated and disassociated catalogs for each promotion book)

  • Localized Terms cache (caches a list of commerce localized terms)

  • Customer Statuses cache (caches a list of localized customer statuses)

  • Returns cache policy (caches a list of localized reasons-for-returns)

Caching API commands

You administer caching through the CommerceOps API. You can use the Postman samples (located in the SitecoreCommerce_DevOps collection) to execute the caching commands.

Note

The ClearEnvironmentCache(environmentName) command is deprecated from Sitecore XC release 9.2.

The following table lists the API commands for caching:

Command

Description

GetCacheStores()

Retrieves all the cache stores in the system.

GetCacheStore(name)

Retrieves a named cache store.

GetDataCacheStore(name)

Retrieves the caches within the cache store that match the environment's artifact store ID.

GetCache(name)

Retrieves a named cache. If the cache is not present in the cache store, the system returns a 404 error.

ClearCacheStore()

Clears all the caches within the cache store.

This command is not supported for the Redis cache provider. You must clear the cache store directly in Redis.

ClearDataStoreCaches()

Clears all caches in the data store. The Commerce Engine determines the data store from the environment name specified in the request header.

This command is not supported for the Redis cache provider. You must clear the data store directly in Redis.

ClearCache(name)

Clears the named cache within a cache store.

This command is not supported for the Redis cache provider. You must clear the cache directly in Redis.

Do you have some feedback for us?

If you have suggestions for improving this article,