column_create

Abstract

The column_create command creates a new column into the specified table.

This is compatible to the column_create command of the Groonga.

API types

HTTP

Request endpoint
(Document Root)/d/column_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
column_create
body of the request
A hash of parameters.
type of the response
column_create.result

Parameter syntax

{
  "table"  : "<Name of the table>",
  "name"   : "<Name of the column>",
  "flags"  : "<Flags for the column>",
  "type"   : "<Type of the value>",
  "source" : "<Name of a column to be indexed>"
}

Parameter details

All parameters except table and name are optional.

They are compatible to the parameters of the column_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>
  ],
  <Column 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 meaning 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.
Column is successfully created or not
A boolean value meaning the column was successfully created or not. Possible values are:
  • true：The column was successfully created.
  • false：The column was not created.