Skip to main content

locate entry

Locate a region entry on a member.

locate entry

Locate a given entry on members using the specified key. This command is useful when using partitioned regions.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

locate entry --key=value --region=value [--key-class=value]
[--value-class=value] [--recursive=value]

NameDescriptionDefault Value
‑‑keyRequired. String or JSON text from which to create a key. Examples include: "James", "100L" and "('id': 'l34s')". 
‑‑regionRequired. Region in which to locate values. 
‑‑key-classFully qualified class name of the key's type.java.lang.String
‑‑value-classFully qualified class name of the value's type.java.lang.String
‑‑recursiveWhether to traverse regions and subregions recursively.false
Table 1. Locate Entry Parameters

Example Commands:

locate entry --key=('id':'133abg124') --region=/region1
--key-class=data.ProfileKey --recursive=true;

Sample Output:

gfsh>locate entry --key=('123abc') --region=region2
Result : true
Key Class : java.lang.String
Key : ('123abc')
Locations Found : 2


MemberName | MemberId
---------- | -------------------------------------
server1 | GemFireStymon(server1:3692)<v1>:13487
server2 | GemFireStymon(server2:2340)<v2>:11613