locate entry

This topic describes the locate entry command in gfsh, the VMware Tanzu GemFire command-line interface.

Use this command to 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]

Name	Description	Default Value
‑‑key	Required. String or JSON text from which to create a key. Examples include: “James”, “100L” and “('id':'l34s')”.
‑‑region	Required. Region in which to locate values.
‑‑key-class	Fully qualified class name of the key’s type.	java.lang.String
‑‑value-class	Fully qualified class name of the value’s type.	java.lang.String
‑‑recursive	Whether 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