Pivotal GemFire® v8.1

How Distribution Works

How Distribution Works

To use distributed and replicated regions, you should understand how they work and your options for managing them.

Note: The management of replicated and distributed regions supplements the general information for managing data regions provided in Basic Configuration and Programming. See also com.gemstone.gemfire.cache.PartitionAttributes.
A distributed region automatically sends entry value updates to remote caches and receives updates from them.
  • Distributed entry updates come from the Region put and create operations (the creation of an entry with a non-null value is seen as an update by remote caches that already have the entry key). Entry updates are distributed selectively - only to caches where the entry key is already defined. This provides a pull model of distribution, compared to the push model that you get with replication.
  • Distribution alone does not cause new entries to be copied from remote caches.
  • A distributed region shares cache loader and cache writer application event handler plug-ins across the distributed system.
In a distributed region, new and updated entry values are automatically distributed to remote caches that already have the entries defined.
  • Step 1: The application updates or creates the entry. At this point, the entry in the M1 cache may not yet exist.

  • Step 2: The new value is automatically distributed to caches holding the entry.

  • Step 3: The entry's value is the same throughout the distributed system.