Formats

docs/en/formats/blocktabseparated.rst

@@ -1,9 +1,9 @@
 BlockTabSeparated
 -----------------
 
-Данные пишутся не по строкам, а по столбцам, блоками.
+Data is not written by row, but by column and block.
-Каждый блок состоит из кусочков столбцов, каждый из которых пишется на отдельной строке.
+Each block consists of parts of columns, each of which is written on a separate line.
-Значения разделены табами, после последнего значения кусочка столбца, вместо таба ставится перевод строки.
+The values are tab-separated. The last value in a column part is followed by a line break instead of a tab.
-Блоки разделены двойным переводом строки.
+Blocks are separated by a double line break.
-Остальные правила такие же, как в формате TabSeparated.
+The rest of the rules are the same as in the TabSeparated format.
-Этот формат подходит только для вывода результата выполнения запроса, но не для парсинга (приёма данных для вставки в таблицу).
+This format is only appropriate for outputting a query result, not for parsing.

docs/en/formats/csv.rst

@@ -1,10 +1,10 @@
 CSV
 ----
 
-Формат comma separated values (`RFC <https://tools.ietf.org/html/rfc4180>`_).
+Comma separated values (`RFC <https://tools.ietf.org/html/rfc4180>`_).
 
-При форматировании, строки выводятся в двойных кавычках. Двойная кавычка внутри строки выводится как две двойные кавычки подряд. Других правил экранирования нет. Даты и даты-с-временем выводятся в двойных кавычках. Числа выводятся без кавычек. Значения разделяются запятыми. Строки разделяются unix переводом строки (LF). Массивы сериализуются в CSV следующим образом: сначала массив сериализуется в строку, как в формате TabSeparated, а затем полученная строка выводится в CSV в двойных кавычках. Кортежи в формате CSV сериализуются, как отдельные столбцы (то есть, теряется их вложенность в кортеж).
+String values are output in double quotes. Double quote inside a string is output as two consecutive double quotes. That's all escaping rules. Date and DateTime values are output in double quotes. Numbers are output without quotes. Fields are delimited by commas. Rows are delimited by unix newlines (LF). Arrays are output in following way: first, array are serialized to String (as in TabSeparated or Values formats), and then the String value are output in double quotes. Tuples are narrowed and serialized as separate columns.
 
-При парсинге, все значения могут парситься как в кавычках, так и без кавычек. Поддерживаются как двойные, так и одинарные кавычки. В том числе, строки могут быть расположены без кавычек - тогда они парсятся до запятой или перевода строки (CR или LF). В нарушение RFC, в случае парсинга строк не в кавычках, начальные и конечные пробелы и табы игнорируются. В качестве перевода строки, поддерживаются как Unix (LF), так и Windows (CR LF) и Mac OS Classic (LF CR) варианты.
+During parsing, values could be enclosed or not enclosed in quotes. Supported both single and double quotes. In particular, Strings could be represented without quotes - in that case, they are parsed up to comma or newline (CR or LF). Contrary to RFC, in case of parsing strings without quotes, leading and trailing spaces and tabs are ignored. As line delimiter, both Unix (LF), Windows (CR LF) or Mac OS Classic (LF CR) variants are supported.
 
-Формат CSV поддерживает вывод totals и extremes аналогично ``TabSeparated``.
+CSV format supports output of totals and extremes similar to TabSeparated format.

docs/en/formats/csvwithnames.rst

@@ -1,4 +1,4 @@
 CSVWithNames
 ------------
 
-Выводит также заголовок, аналогично ``TabSeparatedWithNames``.
+Also contains header, similar to ``TabSeparatedWithNames``.

docs/en/formats/index.rst

@@ -1,7 +1,7 @@
-Форматы
+Formats
 =======
 
-Формат определяет, в каком виде данные отдаются вам (пишутся, форматируются сервером) при SELECT-е и в каком виде принимаются (читаются, парсятся сервером) при INSERT-е.
+The format determines how data is given (written by server as output) to you after SELECTs, and how it is accepted (read by server as input) for INSERTs.
 
 .. toctree::
     :glob:

docs/en/formats/json.rst

@@ -1,7 +1,7 @@
 JSON
 -----
 
-Выводит данные в формате JSON. Кроме таблицы с данными, также выводятся имена и типы столбцов, и некоторая дополнительная информация - общее количество выведенных строк, а также количество строк, которое могло бы быть выведено, если бы не было LIMIT-а. Пример:
+Outputs data in JSON format. Besides data tables, it also outputs column names and types, along with some additional information - the total number of output rows, and the number of rows that could have been output if there weren't a LIMIT. Example:
 
 .. code-block:: sql
 
@@ -69,16 +69,17 @@ JSON
           "rows_before_limit_at_least": 141137
   }
 
-JSON совместим с JavaScript. Для этого, дополнительно экранируются некоторые символы: символ прямого слеша ``/`` экранируется в виде ``\/``; альтернативные переводы строк ``U+2028``, ``U+2029``, на которых ломаются некоторые браузеры, экранируются в виде ``\uXXXX``-последовательностей. Экранируются ASCII control characters: backspace, form feed, line feed, carriage return, horizontal tab в виде ``\b``, ``\f``, ``\n``, ``\r``, ``\t`` соответственно, а также остальные байты из диапазона 00-1F с помощью ``\uXXXX``-последовательностей. Невалидные UTF-8 последовательности заменяются на replacement character <20> и, таким образом, выводимый текст будет состоять из валидных UTF-8 последовательностей. Числа типа UInt64 и Int64, для совместимости с JavaScript, по умолчанию выводятся в двойных кавычках, чтобы они выводились без кавычек можно установить конфигурационный параметр output_format_json_quote_64bit_integers равным 0.
+JSON is compatible with JavaScript. For this purpose, certain symbols are additionally escaped: the forward slash ``/`` is escaped as ``\/``; alternative line breaks ``U+2028`` and ``U+2029``, which don't work in some browsers, are escaped as \uXXXX-sequences. ASCII control characters are escaped: backspace, form feed, line feed, carriage return, and horizontal tab as ``\b``, ``\f``, ``\n``, ``\r``, and ``\t`` respectively, along with the rest of the bytes from the range 00-1F using \uXXXX-sequences. Invalid UTF-8 sequences are changed to the replacement character ``<EFBFBD>`` and, thus, the output text will consist of valid UTF-8 sequences. UInt64 and Int64 numbers are output in double quotes for compatibility with JavaScript.
 
-``rows`` - общее количество выведенных строчек.
+``rows`` - The total number of output rows.
 
-``rows_before_limit_at_least`` - не менее скольких строчек получилось бы, если бы не было LIMIT-а. Выводится только если запрос содержит LIMIT.
+``rows_before_limit_at_least`` - The minimal number of rows there would have been without a LIMIT. Output only if the query contains LIMIT.
-В случае, если запрос содержит GROUP BY, rows_before_limit_at_least - точное число строк, которое получилось бы, если бы не было LIMIT-а.
 
-``totals`` - тотальные значения (при использовании WITH TOTALS).
+If the query contains GROUP BY, ``rows_before_limit_at_least`` is the exact number of rows there would have been without a LIMIT.
 
-``extremes`` - экстремальные значения (при настройке extremes, выставленной в 1).
+``totals`` - Total values (when using WITH TOTALS).
 
-Этот формат подходит только для вывода результата выполнения запроса, но не для парсинга (приёма данных для вставки в таблицу).
+``extremes`` - Extreme values (when extremes is set to 1).
-Смотрите также формат JSONEachRow.
+
+This format is only appropriate for outputting a query result, not for parsing.
+See JSONEachRow format for INSERT queries.

docs/en/formats/jsoncompact.rst

@@ -1,9 +1,9 @@
 JSONCompact
 -----------
 
-Отличается от JSON только тем, что строчки данных выводятся в массивах, а не в object-ах. 
+Differs from ``JSON`` only in that data rows are output in arrays, not in objects. 
 
-Пример:
+Example: 
 ::
   {
           "meta":
@@ -21,10 +21,10 @@ JSONCompact
           "data":
           [
                   ["", "8267016"],
-                  ["интерьер ванной комнаты", "2166"],
+                  ["bath interiors", "2166"],
-                  ["яндекс", "1655"],
+                  ["yandex", "1655"],
-                  ["весна 2014 мода", "1549"],
+                  ["spring 2014 fashion", "1549"],
-                  ["фриформ фото", "1480"]
+                  ["freeform photo", "1480"]
           ],
 
           "totals": ["","8873898"],
@@ -40,5 +40,5 @@ JSONCompact
           "rows_before_limit_at_least": 141137
   }
 
-Этот формат подходит только для вывода результата выполнения запроса, но не для парсинга (приёма данных для вставки в таблицу).
+This format is only appropriate for outputting a query result, not for parsing.
-Смотрите также формат ``JSONEachRow``.
+See ``JSONEachRow`` format for INSERT queries.

docs/en/formats/jsoneachrow.rst

@@ -1,19 +1,23 @@
 JSONEachRow
 -----------
 
-Выводит данные в виде отдельных JSON объектов для каждой строки (newline delimited JSON).
+If put in SELECT query, displays data in newline delimited JSON (JSON objects separated by \\n character) format.
+If put in INSERT query, expects this kind of data as input.
 ::
   {"SearchPhrase":"","count()":"8267016"}
-  {"SearchPhrase":"интерьер ванной комнаты","count()":"2166"}
+  {"SearchPhrase":"bathroom interior","count()":"2166"}
-  {"SearchPhrase":"яндекс","count()":"1655"}
+  {"SearchPhrase":"yandex","count()":"1655"}
-  {"SearchPhrase":"весна 2014 мода","count()":"1549"}
+  {"SearchPhrase":"spring 2014 fashion","count()":"1549"}
-  {"SearchPhrase":"фриформ фото","count()":"1480"}
+  {"SearchPhrase":"free-form photo","count()":"1480"}
-  {"SearchPhrase":"анджелина джоли","count()":"1245"}
+  {"SearchPhrase":"Angelina Jolie","count()":"1245"}
-  {"SearchPhrase":"омск","count()":"1112"}
+  {"SearchPhrase":"omsk","count()":"1112"}
-  {"SearchPhrase":"фото собак разных пород","count()":"1091"}
+  {"SearchPhrase":"photos of dog breeds","count()":"1091"}
-  {"SearchPhrase":"дизайн штор","count()":"1064"}
+  {"SearchPhrase":"curtain design","count()":"1064"}
-  {"SearchPhrase":"баку","count()":"1000"}
+  {"SearchPhrase":"baku","count()":"1000"}
 
-В отличие от формата JSON, нет замены невалидных UTF-8 последовательностей. В строках может выводиться произвольный набор байт. Это сделано для того, чтобы данные форматировались без потери информации. Экранирование значений осуществляется аналогично формату JSON.
+Unlike JSON format, there are no replacements of invalid UTF-8 sequences. There can be arbitrary amount of bytes in a line.
+This is done in order to avoid data loss during formatting. Values are displayed analogous to JSON format.
 
-При парсинге, поддерживается расположение значений разных столбцов в произвольном порядке. Допустимо отсутствие некоторых значений - тогда они воспринимаются как равные значениям по умолчанию. При этом, в качестве значений по умолчанию используются нули, пустые строки и не поддерживаются сложные значения по умолчанию, которые могут быть заданы в таблице. Пропускаются пробельные символы между элементами. После объектов может быть расположена запятая, которая игнорируется. Объекты не обязательно должны быть разделены переводами строк.
+In INSERT queries JSON data can be supplied with arbitrary order of columns (JSON key-value pairs). It is also possible to omit values in which case the default value of the column is inserted. N.B. when using JSONEachRow format, complex default values are not supported, so when omitting a column its value will be zeros or empty string depending on its type.
+
+Space characters between JSON objects are skipped. Between objects there can be a comma which is ignored. Newline character is not a mandatory separator for objects.

docs/en/formats/native.rst

@@ -1,6 +1,6 @@
 Native
 ------
 
-Самый эффективный формат. Данные пишутся и читаются блоками в бинарном виде. Для каждого блока пишется количество строк, количество столбцов, имена и типы столбцов, а затем кусочки столбцов этого блока, один за другим. То есть, этот формат является "столбцовым" - не преобразует столбцы в строки. Именно этот формат используется в родном интерфейсе - при межсерверном взаимодействии, при использовании клиента командной строки, при работе клиентов, написанных на C++.
+The most efficient format. Data is written and read by blocks in binary format. For each block, the number of rows, number of columns, column names and types, and parts of columns in this block are recorded one after another. In other words, this format is "columnar" - it doesn't convert columns to rows. This is the format used in the native interface for interaction between servers, for using the command-line client, and for C++ clients.
 
-Вы можете использовать этот формат для быстрой генерации дампов, которые могут быть прочитаны только СУБД ClickHouse. Вряд ли имеет смысл работать с этим форматом самостоятельно.
+You can use this format to quickly generate dumps that can only be read by the ClickHouse DBMS. It doesn't make sense to work with this format yourself.

docs/en/formats/null.rst

@@ -1,5 +1,4 @@
 Null
 ----
 
-Ничего не выводит. При этом, запрос обрабатывается, а при использовании клиента командной строки, данные ещё и передаются на клиент. Используется для тестов, в том числе, тестов производительности.
+Nothing is output. However, the query is processed, and when using the command-line client, data is transmitted to the client. This is used for tests, including productivity testing. Obviously, this format is only appropriate for outputting a query result, not for parsing.
-Очевидно, формат подходит только для вывода, но не для парсинга.

docs/en/formats/pretty.rst

@@ -1,13 +1,12 @@
 Pretty
 ------
 
-Выводит данные в виде Unicode-art табличек, также используя ANSI-escape последовательности для установки цветов в терминале.
+Writes data as Unicode-art tables, also using ANSI-escape sequences for setting colors in the terminal.
-Рисуется полная сетка таблицы и, таким образом, каждая строчка занимает две строки в терминале.
+A full grid of the table is drawn, and each row occupies two lines in the terminal. Each result block is output as a separate table. This is necessary so that blocks can be output without buffering results (buffering would be necessary in order to pre-calculate the visible width of all the values).
-Каждый блок результата выводится в виде отдельной таблицы. Это нужно, чтобы можно было выводить блоки без буферизации результата (буферизация потребовалась бы, чтобы заранее вычислить видимую ширину всех значений.)
+To avoid dumping too much data to the terminal, only the first 10,000 rows are printed. If the number of rows is greater than or equal to 10,000, the message "Showed first 10,000" is printed.
-Для защиты от вываливания слишком большого количества данных в терминал, выводится только первые 10 000 строк. Если строк больше или равно 10 000, то будет написано "Showed first 10 000."
+This format is only appropriate for outputting a query result, not for parsing.
-Этот формат подходит только для вывода результата выполнения запроса, но не для парсинга (приёма данных для вставки в таблицу).
 
-Формат Pretty поддерживает вывод тотальных значений (при использовании WITH TOTALS) и экстремальных значений (при настройке extremes выставленной в 1). В этих случаях, после основных данных выводятся тотальные значения, и экстремальные значения, в отдельных табличках. Пример (показан для формата PrettyCompact):
+The Pretty format supports outputting total values (when using WITH TOTALS) and extremes (when 'extremes' is set to 1). In these cases, total values and extreme values are output after the main data, in separate tables. Example (shown for the PrettyCompact format):
 
 .. code-block:: sql
 

docs/en/formats/prettycompact.rst

@@ -1,5 +1,4 @@
 PrettyCompact
 -------------
 
-Отличается от ``Pretty`` тем, что не рисуется сетка между строками - результат более компактный.
+Differs from ``Pretty`` in that the grid is drawn between rows and the result is more compact. This format is used by default in the command-line client in interactive mode.
-Этот формат используется по умолчанию в клиенте командной строки в интерактивном режиме.

docs/en/formats/prettycompactmonoblock.rst

@@ -1,4 +1,4 @@
 PrettyCompactMonoBlock
 ----------------------
 
-Отличается от ``PrettyCompact`` тем, что строки (до 10 000 штук) буферизуются и затем выводятся в виде одной таблицы, а не по блокам.
+Differs from ``PrettyCompact`` in that up to 10,000 rows are buffered, then output as a single table, not by blocks.

docs/en/formats/prettynoescapes.rst

@@ -1,18 +1,18 @@
 PrettyNoEscapes
 ---------------
 
-Отличается от Pretty тем, что не используются ANSI-escape последовательности. Это нужно для отображения этого формата в браузере, а также при использовании утилиты командной строки watch. 
+Differs from Pretty in that ANSI-escape sequences aren't used. This is necessary for displaying this format in a browser, as well as for using the 'watch' command-line utility.
 
-Пример:
+Example:
 ::
   watch -n1 "clickhouse-client --query='SELECT * FROM system.events FORMAT PrettyCompactNoEscapes'"
 
-Для отображения в браузере, вы можете использовать HTTP интерфейс.
+You can use the HTTP interface for displaying in the browser.
 
 PrettyCompactNoEscapes
 ----------------------
-Аналогично.
+The same.
 
 PrettySpaceNoEscapes
 --------------------
-Аналогично.
+The same.

docs/en/formats/prettyspace.rst

@@ -1,4 +1,4 @@
 PrettySpace
 -----------
 
-Отличается от ``PrettyCompact`` тем, что вместо сетки используется пустое пространство (пробелы).
+Differs from ``PrettyCompact`` in that whitespace (space characters) is used instead of the grid.

docs/en/formats/rowbinary.rst

@@ -1,13 +1,13 @@
 RowBinary
 ---------
 
-Форматирует и парсит данные по строкам, в бинарном виде. Строки и значения уложены подряд, без разделителей.
+Writes data by row in binary format. Rows and values are listed consecutively, without separators.
-Формат менее эффективен, чем формат Native, так как является строковым.
+This format is less efficient than the Native format, since it is row-based.
 
-Числа представлены в little endian формате фиксированной длины. Для примера, UInt64 занимает 8 байт.
+Numbers is written in little endian, fixed width. For example, UInt64 takes 8 bytes.
-DateTime представлены как UInt32, содержащий unix timestamp в качестве значения.
+DateTime is written as UInt32 with unix timestamp value.
-Date представлены как UInt16, содержащий количество дней, прошедших с 1970-01-01 в качестве значения.
+Date is written as UInt16 with number of days since 1970-01-01 in value.
-String представлены как длина в формате varint (unsigned `LEB128 <https://en.wikipedia.org/wiki/LEB128>`_), а затем байты строки.
+String is written as length in varint (unsigned `LEB128 <https://en.wikipedia.org/wiki/LEB128>`_) format and then bytes of string.
-FixedString представлены просто как последовательность байт.
+FixedString is written as just its bytes.
+Array is written as length in varint (unsigned `LEB128 <https://en.wikipedia.org/wiki/LEB128>`_) format and then all elements, contiguously
 
-Array представлены как длина в формате varint (unsigned `LEB128 <https://en.wikipedia.org/wiki/LEB128>`_), а затем элементы массива, подряд.

docs/en/formats/tabseparated.rst

@@ -1,39 +1,39 @@
 TabSeparated
 ------------
 
-В TabSeparated формате данные пишутся по строкам. Каждая строчка содержит значения, разделённые табами. После каждого значения идёт таб, кроме последнего значения в строке, после которого идёт перевод строки. Везде подразумеваются исключительно unix-переводы строк. Последняя строка также обязана содержать перевод строки на конце. Значения пишутся в текстовом виде, без обрамляющих кавычек, с экранированием служебных символов.
+In TabSeparated format, data is written by row. Each row contains values separated by tabs. Each value is follow by a tab, except the last value in the row, which is followed by a line break. Strictly Unix line breaks are assumed everywhere. The last row also must contain a line break at the end. Values are written in text format, without enclosing quotation marks, and with special characters escaped.
 
-Целые числа пишутся в десятичной форме. Числа могут содержать лишний символ "+" в начале (игнорируется при парсинге, а при форматировании не пишется). Неотрицательные числа не могут содержать знак отрицания. При чтении допустим парсинг пустой строки, как числа ноль, или (для знаковых типов) строки, состоящей из одного минуса, как числа ноль. Числа, не помещающиеся в соответствующий тип данных, могут парсится, как некоторое другое число, без сообщения об ошибке.
+Numbers are written in decimal form. Numbers may contain an extra "+" symbol at the beginning (but it is not recorded during an output). Non-negative numbers can't contain the negative sign. When parsing, it is allowed to parse an empty string as a zero, or (for signed types) a string consisting of just a minus sign as a zero. Numbers that do not fit into the corresponding data type may be parsed as a different number, without an error message.
 
-Числа с плавающей запятой пишутся в десятичной форме. При этом, десятичный разделитель - точка. Поддерживается экспоненциальная запись, а также inf, +inf, -inf, nan. Запись числа с плавающей запятой может начинаться или заканчиваться на десятичную точку.
+Floating-point numbers are formatted in decimal form. The dot is used as the decimal separator. Exponential entries are supported, as are 'inf', '+inf', '-inf', and 'nan'. An entry of floating-point numbers may begin or end with a decimal point.
-При форматировании возможна потеря точности чисел с плавающей запятой.
+During formatting, accuracy may be lost on floating-point numbers.
-При парсинге, допустимо чтение не обязательно наиболее близкого к десятичной записи машинно-представимого числа.
+During parsing, a result is not necessarily the nearest machine-representable number.
 
-Даты выводятся в формате YYYY-MM-DD, парсятся в том же формате, но с любыми символами в качестве разделителей.
+Dates are formatted in YYYY-MM-DD format and parsed in the same format, but with any characters as separators.
-Даты-с-временем выводятся в формате YYYY-MM-DD hh:mm:ss, парсятся в том же формате, но с любыми символами в качестве разделителей.
+DateTimes are formatted in the format YYYY-MM-DD hh:mm:ss and parsed in the same format, but with any characters as separators.
-Всё это происходит в системном часовом поясе на момент старта клиента (если клиент занимается форматированием данных) или сервера. Для дат-с-временем не указывается, действует ли daylight saving time. То есть, если в дампе есть времена во время перевода стрелок назад, то дамп не соответствует данным однозначно, и при парсинге будет выбрано какое-либо из двух времён.
+This all occurs in the system time zone at the time the client or server starts (depending on which one formats data). For DateTimes, daylight saving time is not specified. So if a dump has times during daylight saving time, the dump does not unequivocally match the data, and parsing will select one of the two times.
-При парсинге, некорректные даты и даты-с-временем могут парситься с естественным переполнением или как нулевые даты/даты-с-временем без сообщения об ошибке.
+During a parsing operation, incorrect dates and dates with times can be parsed with natural overflow or as null dates and times, without an error message.
 
-В качестве исключения, поддерживается также парсинг даты-с-временем в формате unix timestamp, если он состоит ровно из 10 десятичных цифр. Результат не зависит от часового пояса. Различение форматов YYYY-MM-DD hh:mm:ss и NNNNNNNNNN делается автоматически.
+As an exception, parsing DateTime is also supported in Unix timestamp format, if it consists of exactly 10 decimal digits. The result is not time zone-dependent. The formats ``YYYY-MM-DD hh:mm:ss`` and ``NNNNNNNNNN`` are differentiated automatically.
 
-Строки выводятся с экранированием спец-символов с помощью обратного слеша. При выводе, используются следующие escape-последовательности: ``\b``, ``\f``, ``\r``, ``\n``, ``\t``, ``\0``, ``\'``, ``\\``. При парсинге, также поддерживаются последовательности ``\a``, ``\v``, а также ``\xHH`` (hex escape-последовательности) и любые последовательности вида ``\c``, где ``c`` - любой символ - такие последовательности преобразуется в ``c``. Таким образом, при чтении поддерживаются форматы, где перевод строки может быть записан как ``\n`` и как ``\`` и перевод строки. Например, строка ``Hello world``, где между словами вместо пробела стоит перевод строки, может быть считана в любом из следующих вариантов:
+Strings are parsed and formatted with backslash-escaped special characters. The following escape sequences are used while formatting: ``\b``, ``\f``, ``\r``, ``\n``, ``\t``, ``\0``, ``\'``, and ``\\``. For parsing, also supported \a, \v and \xHH (hex escape sequence) and any sequences of the type \c where c is any character (these sequences are converted to c). This means that parsing supports formats where a line break can be written as \n or as \ and a line break. For example, the string 'Hello world' with a line break between the words instead of a space can be retrieved in any of the following variations:
 ::
   Hello\nworld
 
   Hello\
   world
 
-Второй вариант поддерживается, так как его использует MySQL при записи tab-separated дампа.
+The second variant is supported because MySQL uses it when writing tab-separated dumps.
 
-Минимальный набор символов, которых вам необходимо экранировать при передаче в TabSeparated формате: таб, перевод строки (LF) и обратный слеш.
+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.
 
-Формат TabSeparated удобен для обработки данных произвольными программами и скриптами. Он используется по умолчанию в HTTP-интерфейсе, а также в batch-режиме клиента командной строки. Также формат позволяет переносить данные между разными СУБД. Например, вы можете получить дамп из MySQL и загрузить его в ClickHouse, или наоборот.
+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.
 
-Формат TabSeparated поддерживает вывод тотальных значений (при использовании WITH TOTALS) и экстремальных значений (при настройке extremes выставленной в 1). В этих случаях, после основных данных выводятся тотальные значения, и экстремальные значения. Основной результат, тотальные значения и экстремальные значения, отделяются друг от друга пустой строкой. Пример:
+The TabSeparated format supports outputting total values (when using WITH TOTALS) and extreme values (when 'extremes' is set to 1). In these cases, the total values and extremes are output after the main data. The main result, total values, and extremes are separated from each other by an empty line. Example:
 
 ``SELECT EventDate, count() AS c FROM test.hits GROUP BY EventDate WITH TOTALS ORDER BY EventDate FORMAT TabSeparated``
 
@@ -52,4 +52,4 @@ TabSeparated
   2014-03-17      1031592
   2014-03-23      1406958
 
-Этот формат также доступен под именем ``TSV``.
+It's also available as ``TSV``.

docs/en/formats/tabseparatedraw.rst

@@ -1,7 +1,7 @@
 TabSeparatedRaw
 ---------------
 
-Отличается от формата ``TabSeparated`` тем, что строки выводятся без экранирования.
+Differs from the ``TabSeparated`` format in that the rows are formatted without escaping.
-Этот формат подходит только для вывода результата выполнения запроса, но не для парсинга (приёма данных для вставки в таблицу).
+This format is only appropriate for outputting a query result, but not for parsing data to insert into a table.
 
-Этот формат также доступен под именем ``TSVRaw``.
+It's also available as ``TSVRaw``.

docs/en/formats/tabseparatedwithnames.rst

@@ -1,8 +1,8 @@
 TabSeparatedWithNames
 ---------------------
 
-Отличается от формата ``TabSeparated`` тем, что в первой строке пишутся имена столбцов.
+Differs from the TabSeparated format in that the column names are output in the first row.
-При парсинге, первая строка полностью игнорируется: вы не можете использовать имена столбцов, чтобы указать их порядок расположения, или чтобы проверить их корректность.
+For parsing, the first row is completely ignored. You can't use column names to determine their position or to check their correctness.
-(Поддержка обработки заголовка при парсинге может быть добавлена в будущем.)
+(Support for using header while parsing could be added in future.)
 
-Этот формат также доступен под именем ``TSVWithNames``.
+It's also available as ``TSVWithNames``.

docs/en/formats/tabseparatedwithnamesandtypes.rst

@@ -1,7 +1,7 @@
 TabSeparatedWithNamesAndTypes
 -----------------------------
 
-Отличается от формата ``TabSeparated`` тем, что в первой строке пишутся имена столбцов, а во второй - типы столбцов.
+Differs from the ``TabSeparated`` format in that the column names are output to the first row, while the column types are in the second row.
-При парсинге, первая и вторая строка полностью игнорируется.
+For parsing, the first and second rows are completely ignored.
 
-Этот формат также доступен под именем ``TSVWithNamesAndTypes``.
+It's also available as ``TSVWithNamesAndTypes``.

docs/en/formats/tskv.rst

@@ -1,21 +1,19 @@
 TSKV
 -----
 
-Похож на TabSeparated, но выводит значения в формате name=value. Имена экранируются так же, как строки в формате TabSeparated и, дополнительно, экранируется также символ =.
+Similar to TabSeparated, but displays data in name=value format. Names are displayed just as in TabSeparated. Additionally, a ``=`` symbol is displayed.
 ::
   SearchPhrase=   count()=8267016
-  SearchPhrase=интерьер ванной комнаты    count()=2166
+  SearchPhrase=bathroom interior    count()=2166
-  SearchPhrase=яндекс     count()=1655
+  SearchPhrase=yandex     count()=1655
-  SearchPhrase=весна 2014 мода    count()=1549
+  SearchPhrase=spring 2014 fashion    count()=1549
-  SearchPhrase=фриформ фото       count()=1480
+  SearchPhrase=free-form photo       count()=1480
-  SearchPhrase=анджелина джоли    count()=1245
+  SearchPhrase=Angelina Jolie    count()=1245
-  SearchPhrase=омск       count()=1112
+  SearchPhrase=omsk       count()=1112
-  SearchPhrase=фото собак разных пород    count()=1091
+  SearchPhrase=photos of dog breeds    count()=1091
-  SearchPhrase=дизайн штор        count()=1064
+  SearchPhrase=curtain design        count()=1064
-  SearchPhrase=баку       count()=1000
+  SearchPhrase=baku       count()=1000
 
-При большом количестве маленьких столбцов, этот формат существенно неэффективен, и обычно нет причин его использовать. Он реализован, так как используется в некоторых отделах Яндекса.
+In case of many small columns this format is obviously not effective and there usually is no reason to use it. This format is supported because it is used for some cases in Yandex.
 
-Поддерживается как вывод, так и парсинг данных в этом формате. При парсинге, поддерживается расположение значений разных столбцов в произвольном порядке. Допустимо отсутствие некоторых значений - тогда они воспринимаются как равные значениям по умолчанию. При этом, в качестве значений по умолчанию используются нули, пустые строки и не поддерживаются сложные значения по умолчанию, которые могут быть заданы в таблице.
+Format is supported both for input and output. In INSERT queries data can be supplied with arbitrary order of columns. It is also possible to omit values in which case the default value of the column is inserted. N.B. when using TSKV format, complex default values are not supported, so when omitting a column its value will be zeros or empty string depending on its type.
-
-При парсинге, в качестве дополнительного поля, может присутствовать ``tskv`` без знака равенства и без значения. Это поле игнорируется.

docs/en/formats/values.rst

@@ -1,9 +1,9 @@
 Values
 ------
 
-Выводит каждую строку в скобках. Строки разделены запятыми. После последней строки запятой нет. Значения внутри скобок также разделены запятыми. Числа выводятся в десятичном виде без кавычек. Массивы выводятся в квадратных скобках. Строки, даты, даты-с-временем выводятся в кавычках. Правила экранирования и особенности парсинга аналогичны формату TabSeparated. При форматировании, лишние пробелы не ставятся, а при парсинге - допустимы и пропускаются (за исключением пробелов внутри значений типа массив, которые недопустимы).
+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).
 
-Минимальный набор символов, которых вам необходимо экранировать при передаче в Values формате: одинарная кавычка и обратный слеш.
+Minimum set of symbols that you must escape in Values format is single quote and backslash.
 
-Именно этот формат используется в запросе ``INSERT INTO t VALUES ...``
+This is the format that is used in ``INSERT INTO t VALUES`` ...
-Но вы также можете использовать его для форматирования результатов запросов.
+But you can also use it for query result.

docs/en/formats/vertical.rst

@@ -1,5 +1,5 @@
 Vertical
 --------
 
-Выводит каждое значение на отдельной строке, с указанием имени столбца. Формат удобно использовать для вывода одной-нескольких строк, если каждая строка состоит из большого количества столбцов.
+Prints each value on a separate line with the column name specified. This format is convenient for printing just one or a few rows, if each row consists of a large number of columns.
-Этот формат подходит только для вывода результата выполнения запроса, но не для парсинга (приёма данных для вставки в таблицу).
+This format is only appropriate for outputting a query result, not for parsing.

docs/en/formats/xml.rst

@@ -1,7 +1,7 @@
 XML
 ----
 
-Формат XML подходит только для вывода данных, не для парсинга. Пример:
+XML format is supported only for displaying data, not for INSERTS. Example:
 
 .. code-block:: xml
 
@@ -25,39 +25,39 @@ XML
                           <field>8267016</field>
                   </row>
                   <row>
-                          <SearchPhrase>интерьер ванной комнаты</SearchPhrase>
+                          <SearchPhrase>bathroom interior</SearchPhrase>
                           <field>2166</field>
                   </row>
                   <row>
-                          <SearchPhrase>яндекс</SearchPhrase>
+                          <SearchPhrase>yandex>
                           <field>1655</field>
                   </row>
                   <row>
-                          <SearchPhrase>весна 2014 мода</SearchPhrase>
+                          <SearchPhrase>spring 2014 fashion</SearchPhrase>
                           <field>1549</field>
                   </row>
                   <row>
-                          <SearchPhrase>фриформ фото</SearchPhrase>
+                          <SearchPhrase>free-form photo</SearchPhrase>
                           <field>1480</field>
                   </row>
                   <row>
-                          <SearchPhrase>анджелина джоли</SearchPhrase>
+                          <SearchPhrase>Angelina Jolie</SearchPhrase>
                           <field>1245</field>
                   </row>
                   <row>
-                          <SearchPhrase>омск</SearchPhrase>
+                          <SearchPhrase>omsk</SearchPhrase>
                           <field>1112</field>
                   </row>
                   <row>
-                          <SearchPhrase>фото собак разных пород</SearchPhrase>
+                          <SearchPhrase>photos of dog breeds</SearchPhrase>
                           <field>1091</field>
                   </row>
                   <row>
-                          <SearchPhrase>дизайн штор</SearchPhrase>
+                          <SearchPhrase>curtain design</SearchPhrase>
                           <field>1064</field>
                   </row>
                   <row>
-                          <SearchPhrase>баку</SearchPhrase>
+                          <SearchPhrase>baku</SearchPhrase>
                           <field>1000</field>
                   </row>
           </data>
@@ -65,10 +65,10 @@ XML
           <rows_before_limit_at_least>141137</rows_before_limit_at_least>
   </result>
 
-Если имя столбца не имеет некоторый допустимый вид, то в качестве имени элемента используется просто field. В остальном, структура XML повторяет структуру в формате JSON.
+If name of a column contains some unacceptable character, field is used as a name. In other aspects XML uses JSON structure.
-Как и для формата JSON, невалидные UTF-8 последовательности заменяются на replacement character <20> и, таким образом, выводимый текст будет состоять из валидных UTF-8 последовательностей.
+As in case of JSON, invalid UTF-8 sequences are replaced by replacement character <20> so displayed text will only contain valid UTF-8 sequences.
 
-В строковых значениях, экранируются символы ``<`` и ``&`` как ``&lt;`` и ``&amp;``.
+In string values ``<`` and ``&`` are displayed as ``&lt;`` and ``&amp;``.
 
-Массивы выводятся как ``<array><elem>Hello</elem><elem>World</elem>...</array>``,
+Arrays are displayed as ``<array><elem>Hello</elem><elem>World</elem>...</array>``,
-а кортежи как ``<tuple><elem>Hello</elem><elem>World</elem>...</tuple>``.
+and tuples as ``<tuple><elem>Hello</elem><elem>World</elem>...</tuple>``.