2e1f6bc56d
* replace exit with assert in test_single_page * improve save_raw_single_page docs option * More grammar fixes * "Built from" link in new tab * fix mistype * Example of include in docs * add anchor to meeting form * Draft of translation helper * WIP on translation helper * Replace some fa docs content with machine translation * add normalize-en-markdown.sh * normalize some en markdown * normalize some en markdown * admonition support * normalize * normalize * normalize * support wide tables * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * lightly edited machine translation of introdpection.md * lightly edited machhine translation of lazy.md * WIP on translation utils * Normalize ru docs * Normalize other languages * some fixes * WIP on normalize/translate tools * add requirements.txt * [experimental] add es docs language as machine translated draft * remove duplicate script * Back to wider tab-stop (narrow renders not so well)
1.9 KiB
input
input(structure) - table function that allows effectively convert and insert data sent to the
server with given structure to the table with another structure.
structure - structure of data sent to the server in following format 'column1_name column1_type, column2_name column2_type, ...'.
For example, 'id UInt32, name String'.
This function can be used only in INSERT SELECT query and only once but otherwise behaves like ordinary table function
(for example, it can be used in subquery, etc.).
Data can be sent in any way like for ordinary INSERT query and passed in any available format
that must be specified in the end of query (unlike ordinary INSERT SELECT).
The main feature of this function is that when server receives data from client it simultaneously converts it
according to the list of expressions in the SELECT clause and inserts into the target table. Temporary table
with all transferred data is not created.
Examples
- Let the
testtable has the following structure(a String, b String)and data indata.csvhas a different structure(col1 String, col2 Date, col3 Int32). Query for insert data from thedata.csvinto thetesttable with simultaneous conversion looks like this:
$ cat data.csv | clickhouse-client --query="INSERT INTO test SELECT lower(col1), col3 * col3 FROM input('col1 String, col2 Date, col3 Int32') FORMAT CSV";
- If
data.csvcontains data of the same structuretest_structureas the tabletestthen these two queries are equal:
$ cat data.csv | clickhouse-client --query="INSERT INTO test FORMAT CSV"
$ cat data.csv | clickhouse-client --query="INSERT INTO test SELECT * FROM input('test_structure') FORMAT CSV"