7.3.23. load¶
7.3.23.1. Summary¶
load loads data as records in the current database and updates values of each columns.
7.3.23.2. Syntax¶
load values table [columns [ifexists [input_type]]]
7.3.23.3. Parameters¶
This section describes all parameters.
values
Specifies values loaded to records. Values should satisfy
input_typeformat. If you specify "json" asinput_type, you can choose a format from below:
Format 1:- [[COLUMN_NAME1, COLUMN_NAME2,..], [VALUE1, VALUE2,..], [VALUE1, VALUE2,..],..]
Format 2:- [{COLUMN_NAME1: VALUE1, COLUMN_NAME2: VALUE2}, {COLUMN_NAME1: VALUE1, COLUMN_NAME2: VALUE2},..]
[COLUMN_NAME1, COLUMN_NAME2,..]format inFormat 1is effective only whencolumnsparameter isn't specified.When a target table contains primary key, you must specify
_keycolumn (pseudo column associated primary key) as the one ofCOLUMN_NAME.If
valuesisn't specified any values, they are read from the standard input until all opened parenthes match their closed ones. You don't have to enclose them with single-quotes or double-quotes, but if you specified values withvaluesparameter, you should do.In following values, you also don't have to enclose any spaces (' ') with single-quotes or double-quotes.
table
Specifies a table name you want to add records.
columns
Specifies column names in added records with comma separations.
ifexists
Specifies executedgrn_exprstring when the same primary key as added records already exists in your table. Ififexistsspecifiesgrn_exprstring (default: true) and its value is true, values in other (all columns excluding_keycolumn) columns is updated.
input_type
Specifies an input format forvalues. It supports JSON only.
7.3.23.4. Usage¶
Here is an example to add records to "Entry" table.
load --table Entry --input_type json --values [{\"_key\":\"Groonga\",\"body\":\"It's very fast!!\"}]
[1]
This example shows how to add values from standard input.
load --table Entry --input_type json
[
{"_key": "Groonga", "body": "It's very fast!!"}
]
[1]