Data Regions

The region is the core building block of the Pivotal GemFire distributed system. All cached data is organized into data regions and you do all of your data puts, gets, and querying activities against them.

Data Region Management
Pivotal GemFire provides different APIs and XML configuration models to support configuration and management of your data regions.
Creating a Region with gfsh
A simple and fast way to create a data region in the Pivotal GemFire cache is to use the gfsh command-line tool.
Creating a Region Through the cache.xml File
A common way to create a data region in the Pivotal GemFire cache is through cache.xml declarations.
Creating a Region Through the API
You can use the GemFire caching API to create regions in your cache after startup. For run-time region creation, you need to use the API.
Region Naming
To get the full range of Pivotal GemFire capabilities for your cached data regions, follow GemFire's region naming guidelines.
Region Shortcuts and Custom Named Region Attributes
GemFire provides region shortcut settings, with preset region configurations for the most common region types. For the easiest configuration, start with a shortcut setting and customize as needed. You can also store your own custom configurations in the cache for use by multiple regions.
Storing and Retrieving Region Shortcuts and Custom Named Region Attributes
Use these examples to get started with GemFire region shortcuts.
Managing Region Attributes
Use region attributes to fine-tune the region configuration provided by the region shortcut settings.
Creating Custom Attributes for Regions and Entries
Use custom attributes to store information related to your region or its entries in your cache. These attributes are only visible to the local application and are not distributed.
Building a New Region with Existing Content
A new region or distributed system may need to be loaded with the data of an existing system. There are two approaches to accomplish this task. The approach used depends upon the organization of both the new and the existing distributed system.

Parent topic: Basic Configuration and Programming