DOCAPI-7431: Formatted queries docs#6490
Conversation
BayoNet
added
comp-documentation
docs/en/interfaces/cli.md
Outdated
|
|
||
| The command-line client allows passing external data (external temporary tables) for querying. For more information, see the section "External data for query processing". | ||
|
|
||
| ### Formatted Queries {#cli-formatted-queries} |
There was a problem hiding this comment.
This feature is usually called prepared statements, not formatted queries. This impacts the whole following text.
Though as far as I can see there's currently no actual preparation, so maybe "Queries with parameters" like in original PR might look better.
There was a problem hiding this comment.
I've called it "Formatted" because we have a dial with formatted query string similar to format strings in Python or in C (printf). There is no any other functionality. Queries with parameters sounds strange for me because we don't talk about queries, we talk about interfaces of data I/O.
There was a problem hiding this comment.
It should be similar to other DBMS, not other programming languages. Queries are part of public interface.
docs/en/interfaces/cli.md
Outdated
| Format a query by the standard method. Values that you want to put into the query from the app parameters place in braces and format as follows: | ||
|
|
||
| ``` | ||
| {<name>:<structure>} |
There was a problem hiding this comment.
why structure? it's just data type
There was a problem hiding this comment.
If you look at the examples you will see that it describes data structure, For example Tuple(UInt8, Tuple(String, UInt8))
There was a problem hiding this comment.
It's still just a complex data type.
2 participants
I hereby agree to the terms of the CLA available at: https://yandex.ru/legal/cla/?lang=en
Category (leave one):