Skip to content

Indexes & Dictionaries ​

Indexes API allows you to retrieve indexes, memory, and dictionaries for all tables across your Indexima cluster.

INFO

Please note that views don't have indexes, dictionaries, or memory footprints.

Retrieve indexes details ​

GET /api/monitor/get/indexes
Retrieve all indexes in your Indexima cluster.
Example:

text
curl http://myindeximacluster:8082/api/monitor/get/indexes \
  -H "Authorization: $ACCESS_TOKEN" \
  -H "Monitor-Target-Host: indexima-core-1" \
  -H "Monitor-Target-Port: 9999" \
  --compressed -s

Reply JSON Format:

NameTypeDescription
schemas.schemaStringThe schema name
schemas.tables.nameStringThe table name
schemas.tables.dicoIntegerThe dictionaries memory size in bytes
schemas.tables.indexes.nameStringThe index name
schemas.tables.indexes.countIntegerThe index number of rows
schemas.tables.indexes.sizeIntegerThe index memory size in bytes
schemas.tables.indexes.mainBooleanIf this index contains all the table columns (called a “main” index)

Retrieve memory used for each index ​

GET /api/monitor/get/memory

Retrieve the memory used for all tables on each node of your cluster. This request is equivalent to executing a SHOW MEMORY ALL SQL command.

Example:

text
curl http://myindeximacluster:8082/api/monitor/get/memory \
  -H "Authorization: $ACCESS_TOKEN" \
  -H "Monitor-Target-Host: indexima-core-1" \
  -H "Monitor-Target-Port: 9999" \
  --compressed

Reply JSON Format:

Memory is represented by a tree structure with the following path :
Name of the node -> Schema -> Table -> Index

NameTypeDescription
loadedBooleantrue if the current index is loaded in memory
dictionaryIntegerThe dictionaries memory size, in bytes
sizeIntegerThe index memory size, in bytes
countIntegerThis index number of lines
bucketsizeIntegerThe bucket disk size
isLimitedBooleantrue if the parent table is a limited table
isOnErrorBooleantrue if this index is on error and can't be used
isDimensionBooleantrue if the parent table is a dimension table
isExternalBooleantrue if the parent table is an external table
isTemporaryBooleantrue if the parent table is a temporary table

Retrieve dictionaries details ​

GET /api/monitor/get/dictionaries

Retrieve the dictionary details used for all tables on each node of your cluster. This request is equivalent to executing a SHOW DICTIONARIES ALL SQL command.

Example:

text
curl http://myindeximacluster:8082/api/monitor/get/dictionaries \
  -H "Authorization: $ACCESS_TOKEN" \
  -H "Monitor-Target-Host: indexima-core-1" \
  -H "Monitor-Target-Port: 9999" \
  --compressed

Reply JSON Format:

Dictionary is represented by a tree structure with the following path :
Name of the node -> Schema -> Table -> Dictionary field or expression

Two structures are sent :

  • Total memory and lines count, by node

  • Details for each table on each node

NameTypeDescription
sizeIntegerThe dictionary memory size, in bytes
countIntegerThe dictionary number of words
loadedBooleantrue is this dictionary is currently in memory