system.statistics.object.count.per-volume

Abstract

The system.statistics.object.count.per-volume command counts and reports numbers of physical objects in each volume.

See also ‘system.statistics.object.count’.

API types

HTTP

Request endpoint
(Document Root)/droonga/system/statistics/object/count/per-volume
Request methd
GET
Request URL parameters
See parameters.
Request body
Nothing.
Response body
A response message.

REST

Not supported.

Fluentd

Style
Request-Response. One response message is always returned per one request.
type of the request
system.statistics.object.count.per-volume
body of the request
A hash of parameters.
type of the response
system.statistics.object.count.per-volume.result

Parameter syntax

{
  "output": [
    "tables",
    "columns",
    "records"
  ]
}

or

{
  "output": [
    "total"
  ]
}

Usage

This command counts and reports the physical numbers of specified targets. For example:

{
  "type" : "system.statistics.object.count.per-volume",
  "body" : {
    "output": [
      "tables",
      "columns",
      "records",
      "total"
    ]
  }
}

=> {
     "type" : "system.statistics.object.count.per-volume.result",
     "body" : {
       "node0:10031/droonga.000": {
         "tables":  1,
         "columns": 0,
         "records": 1,
         "total":   2
       },
       "node0:10031/droonga.001": {
         "tables":  1,
         "columns": 0,
         "records": 1,
         "total":   2
       }
     }
   }

Parameter details

All parameters are optional.

output

Abstract
Targets to be reported their count.
Value
An array of targets. Only specified targets are counted. Possible values are:
  • tables
  • columns
  • records
  • total
Default value
[]

Responses

This returns a hash like following as the response’s body, with 200 as its statusCode.

{
  "<Identifier of the volume 1>": {
    "tables":  <The total number of tables>,
    "columns": <The total number of columns>,
    "records": <The total number of records>,
    "total":   <The total number of all objects>
  },
  "<Identifier of the volume 2>": { ... },
  ...
}
tables
The number of physical tables in the volume.
columns
The number of physical columns in the volume.
records
The number of physical records in the volume.
total
The total number of tables, columns, and records. If you just want to know the total number of all objects, this is faster than separate targets.

Error types

This command reports general errors.