From 151b8408cb559a120a432f85199bf87c7606d1b4 Mon Sep 17 00:00:00 2001 From: Alexey Milovidov Date: Thu, 14 Jul 2016 06:01:44 +0300 Subject: [PATCH] doc: clarifications [#METR-2944]. --- doc/reference_en.html | 8 +++++++- doc/reference_ru.html | 9 +++++++-- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/doc/reference_en.html b/doc/reference_en.html index 48b0dab64b6..ad878250267 100644 --- a/doc/reference_en.html +++ b/doc/reference_en.html @@ -922,7 +922,9 @@ Examples: %%1%%, %%18446744073709551615%%, %%0xDEADBEEF%%, %%01%%, %%0.1%%, %%1e

String literals

-Only string literals in single quotes are supported. The enclosed characters can be backslash-escaped. The following escape sequences have special meanings: %%\b%%, %%\f%%, %%\r%%, %%\n%%, %%\t%%, %%\0%%. In all other cases, escape sequences like \x, where x is any character, are transformed to x. This means that the sequences %%\'%% and %%\\%% can be used. The value will have the String type. +Only string literals in single quotes are supported. The enclosed characters can be backslash-escaped. The following escape sequences have special meanings: %%\b%%, %%\f%%, %%\r%%, %%\n%%, %%\t%%, %%\0%%, %%\a%%, %%\v%%, \xHH. In all other cases, escape sequences like \c, where c is any character, are transformed to c. This means that the sequences %%\'%% and %%\\%% can be used. The value will have the String type. + +Minimum set of symbols that must be escaped in string literal is %%'%% and %%\%%.

Compound literals

@@ -3556,6 +3558,8 @@ The second variant is supported because MySQL uses it when writing tab-separated Only a small set of symbols are escaped. You can easily stumble onto a string value that your terminal will ruin in output. +Minimum set of symbols that you must escape in TabSeparated format is tab, newline (LF) and backslash. + Arrays are formatted as a list of comma-separated values in square brackets. Number items in the array are formatted as normally, but dates, dates with times, and strings are formatted in single quotes with the same escaping rules as above. The TabSeparated format is convenient for processing data using custom programs and scripts. It is used by default in the HTTP interface, and in the command-line client's batch mode. This format also allows transferring data between different DBMSs. For example, you can get a dump from MySQL and upload it to ClickHouse, or vice versa. @@ -3716,6 +3720,8 @@ This format is only appropriate for outputting a query result, not for parsing. Prints every row in parentheses. Rows are separated by commas. There is no comma after the last row. The values inside the parentheses are also comma-separated. Numbers are output in decimal format without quotes. Arrays are output in square brackets. Strings, dates, and dates with times are output in quotes. Escaping rules and parsing are same as in the TabSeparated format. During formatting, extra spaces aren't inserted, but during parsing, they are allowed and skipped (except for spaces inside array values, which are not allowed). +Minimum set of symbols that you must escape in Values format is single quote and backslash. + This is the format that is used in INSERT INTO t VALUES ... But you can also use it for query result. diff --git a/doc/reference_ru.html b/doc/reference_ru.html index 23dc9bd7ae5..17e7db822f2 100644 --- a/doc/reference_ru.html +++ b/doc/reference_ru.html @@ -939,8 +939,9 @@ Connected to ClickHouse server version 0.0.26176.

Строковые литералы

-Поддерживаются только строковые литералы в одинарных кавычках. Символы внутри могут быть экранированы с помощью обратного слеша. Следующие escape-последовательности имеют соответствующее специальное значение: %%\b%%, %%\f%%, %%\r%%, %%\n%%, %%\t%%, %%\0%%. Во всех остальных случаях, последовательности вида \x, где x - любой символ, преобразуется в x. Таким образом, могут быть использованы последовательности %%\'%% и %%\\%%. -Значение будет иметь тип String. +Поддерживаются только строковые литералы в одинарных кавычках. Символы внутри могут быть экранированы с помощью обратного слеша. Следующие escape-последовательности имеют соответствующее специальное значение: %%\b%%, %%\f%%, %%\r%%, %%\n%%, %%\t%%, %%\0%%, %%\a%%, %%\v%%, \xHH. Во всех остальных случаях, последовательности вида \c, где c - любой символ, преобразуется в c. Таким образом, могут быть использованы последовательности %%\'%% и %%\\%%. Значение будет иметь тип String. + +Минимальный набор символов, которых вам необходимо экранировать в строковых литералах: %%'%% and %%\%%.

Составные литералы

@@ -3616,6 +3617,8 @@ world%% Второй вариант поддерживается, так как его использует MySQL при записи tab-separated дампа. +Минимальный набор символов, которых вам необходимо экранировать при передаче в TabSeparated формате: таб, перевод строки (LF) и обратный слеш. + Экранируется лишь небольшой набор символов. Вы можете легко наткнуться на строковое значение, которое испортит ваш терминал при выводе в него. Массивы форматируются в виде списка значений через запятую в квадратных скобках. Элементы массива - числа форматируются как обычно, а даты, даты-с-временем и строки - в одинарных кавычках с такими же правилами экранирования, как указано выше. @@ -3779,6 +3782,8 @@ Extremes: Выводит каждую строку в скобках. Строки разделены запятыми. После последней строки запятой нет. Значения внутри скобок также разделены запятыми. Числа выводятся в десятичном виде без кавычек. Массивы выводятся в квадратных скобках. Строки, даты, даты-с-временем выводятся в кавычках. Правила экранирования и особенности парсинга аналогичны формату TabSeparated. При форматировании, лишние пробелы не ставятся, а при парсинге - допустимы и пропускаются (за исключением пробелов внутри значений типа массив, которые недопустимы). +Минимальный набор символов, которых вам необходимо экранировать при передаче в Values формате: одинарная кавычка и обратный слеш. + Именно этот формат используется в запросе INSERT INTO t VALUES ... Но вы также можете использовать его для форматирования результатов запросов.