/admin/show/shards

URL: http://<db.host>:<db.port>/admin/show/shards

Show the mapping of shards to the corresponding rank and tom. The response message contains list of 16384 (total number of shards in the system) Rank and TOM numbers corresponding to each shard.

Input Parameter Description

NameTypeDescription
optionsmap of string to stringsOptional parameters. The default value is an empty map ( {} ).

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

NameTypeDescription
statusString'OK' or 'ERROR'
messageStringEmpty if success or an error message
data_typeString'admin_show_shards_response' or 'none' in case of an error
dataStringEmpty string
data_strJSON or String

This embedded JSON represents the result of the /admin/show/shards endpoint:

NameTypeDescription
versionlongCurrent shard array version number.
rankarray of intsArray of ranks indexed by the shard number.
tomarray of intsArray of toms to which the corresponding shard belongs.
infomap of string to stringsAdditional information.

Empty string in case of an error.