The table_create command creates a new table.

This is compatible to the table_create command of the Groonga.

API types


Request endpoint
(Document Root)/d/table_create
Request methd
Request URL parameters
Same to the list of parameters.
Request body
Response body
A response message.


Not supported.


Request-Response. One response message is always returned per one request.
type of the request
body of the request
A hash of parameters.
type of the response

Parameter syntax

  "name"              : "<Name of the table>",
  "flags"             : "<Flags for the table>",
  "key_type"          : "<Type of the primary key>",
  "value_type"        : "<Type of the value>",
  "default_tokenizer" : "<Default tokenizer>",
  "normalizer"        : "<Normalizer>"

Parameter details

All parameters except name are optional.

They are compatible to the parameters of the table_create command of the Groonga. See the linked document for more details.


This returns an array meaning the result of the operation, as the body.

    <Groonga's status code>,
    <Start time>,
    <Elapsed time>
  <Table is successfully created or not>

This command always returns a response with 200 as its statusCode, because this is a Groonga compatible command and errors of this command must be handled in the way same to Groonga’s one.

Response body’s details:

Status code
An integer which means the operation’s result. Possible values are:
  • 0 (Droonga::GroongaHandler::Status::SUCCESS) : Successfully processed.
  • -22 (Droonga::GroongaHandler::Status::INVALID_ARGUMENT) : There is any invalid argument.
Start time
An UNIX time which the operation was started on.
Elapsed time
A decimal of seconds meaning the elapsed time for the operation.
Table is successfully created or not
A boolean value meaning the table was successfully created or not. Possible values are:
  • true:The table was successfully created.
  • false:The table was not created.