New documentation on formatting settings for reading from s3

ydb/docs/en/core/concepts/federated_query/s3/_includes/format_settings.md

@@ -0,0 +1,10 @@
+|Setting name|Description|Possible values|
+|----|----|---|
+|`file_pattern`|File name template|File name template string. Wildcards `*` are supported.|
+|`data.interval.unit`|Unit for parsing `Interval` type|MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS, WEEKS|
+|`data.datetime.format_name`|The format in which `Datetime` data is stored|POSIX, ISO|
+|`data.datetime.format`|The format in which `Datetime` data is stored|Formatting string, for example: `%Y-%m-%dT%H-%M`|
+|`date.timestamp.format_name`|The format in which `Timestamp` data is stored|POSIX, ISO, UNIX_TIME_MILLISECONDS, UNIX_TIME_SECONDS, UNIX_TIME_MICROSECONDS|
+|`data.timestamp.format`|The format in which `Timestamp` data is stored|Formatting string, for example: `%Y-%m-%dT%H-%M-%S`|
+|`data.date.format`|The format in which `Date` data is stored|Formatting string, for example: `%Y-%m-%d`|
+|`csv_delimiter`|Delimeter for `csv_with_names` format|Any character|

ydb/docs/en/core/concepts/federated_query/s3/external_data_source.md

@@ -143,6 +143,12 @@ In {{ ydb-full-name }}, the following data paths are supported:
 
 {% include [!](_includes/path_format.md) %}
 
+### Format settings {#format_settings}
+
+In {{ ydb-full-name }}, the following format settings are supported:
+
+{% include [!](_includes/format_settings.md) %}
+
 ## Example {#read_example}
 
 Example query to read data from S3 ({{ objstorage-full-name }}):

ydb/docs/en/core/concepts/federated_query/s3/external_table.md

@@ -37,6 +37,8 @@ Where:
 - `csv_with_names` - one of the [permitted data storage formats](formats.md);
 - `gzip` - one of the [permitted compression algorithms](formats.md#compression).
 
+You can also specify [format settings](external_data_source.md#format_settings).
+
 ## Data model {#data-model}
 
 Reading data using external tables from S3 ({{ objstorage-name }}) is done with regular SQL queries as if querying a normal table.

ydb/docs/ru/core/concepts/federated_query/s3/_includes/format_settings.md

@@ -0,0 +1,10 @@
+|Имя параметра|Описание|Принимаемые значения|
+|----|----|---|
+|`file_pattern`|Шаблон имени файла|Строка шаблона имени. Поддерживаются wildcards `*`.|
+|`data.interval.unit`|Единица измерения для парсинга типа `Interval`|MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS, WEEKS|
+|`data.datetime.format_name`|Формат, в котором записаны данные типа `Datetime`|POSIX, ISO|
+|`data.datetime.format`|Формат, в котором записаны данные типа `Datetime`|Строка форматирования, например: `%Y-%m-%dT%H-%M`|
+|`data.timestamp.format_name`|Формат, в котором записаны данные типа `Timestamp`|POSIX, ISO, UNIX_TIME_MILLISECONDS, UNIX_TIME_SECONDS, UNIX_TIME_MICROSECONDS|
+|`data.timestamp.format`|Формат, в котором записаны данные типа `Timestamp`|Строка форматирования, например: `%Y-%m-%dT%H-%M-%S`|
+|`data.date.format`|Формат, в котором записаны данные типа `Date`|Строка форматирования, например: `%Y-%m-%d`|
+|`csv_delimiter`|Разделитель данных в формате `csv_with_names`|Любой символ|

ydb/docs/ru/core/concepts/federated_query/s3/external_data_source.md

@@ -143,6 +143,12 @@ WHERE
 
 {% include [!](_includes/path_format.md) %}
 
+### Параметры форматирования {#format_settings}
+
+В {{ ydb-full-name }} поддерживаются следующие параметры форматирования:
+
+{% include [!](_includes/format_settings.md) %}
+
 ## Пример {#read_example}
 
 Пример запроса для чтения данных из S3 ({{ objstorage-full-name }}):

ydb/docs/ru/core/concepts/federated_query/s3/external_table.md

@@ -37,6 +37,7 @@ CREATE EXTERNAL TABLE `s3_test_data` (
 - `csv_with_names` - один из [допустимых типов хранения данных](formats.md);
 - `gzip` - один из [допустимых алгоритмов сжатия](formats.md#compression).
 
+Так же при создании внешних таблиц поддерживаются [параметры форматирования](external_data_source.md#format_settings).
 
 ## Модель данных {#data-model}