table_create

Abstract

The table_create command creates a new table.

This is compatible to the table_create command of the Groonga.

API types

HTTP

Request endpoint
(Document Root)/d/table_create
Request methd
GET
Request URL parameters
Same to the list of 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
table_create
body of the request
A hash of parameters.
type of the response
table_create.result

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.

Responses

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.