From e6733c79341f0a572704c99561dde4eaf33017a5 Mon Sep 17 00:00:00 2001 From: Alexey Date: Tue, 20 Jul 2021 06:28:08 +0000 Subject: [PATCH] New variant translated into russian Some more improvements --- docs/en/operations/settings/settings.md | 2 +- docs/en/sql-reference/table-functions/url.md | 3 ++- docs/ru/operations/settings/settings.md | 2 +- .../sql-reference/table-functions/remote.md | 27 +++++++------------ docs/ru/sql-reference/table-functions/url.md | 10 +++---- 5 files changed, 16 insertions(+), 28 deletions(-) diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md index 5b3d8b012d5..0a59a9b145d 100644 --- a/docs/en/operations/settings/settings.md +++ b/docs/en/operations/settings/settings.md @@ -165,7 +165,7 @@ Default value: `1000`. ## glob_expansion_max_elements {#glob_expansion_max_elements } -Sets the maximum number of addresses generated from patterns for external storages and table functions except the `remote` function. +Sets the maximum number of addresses generated from patterns for external storages and table functions (like [url](../../sql-reference/table-functions/url.md)) except the `remote` function. Possible values: diff --git a/docs/en/sql-reference/table-functions/url.md b/docs/en/sql-reference/table-functions/url.md index 9f06b65b21c..f2e1deed285 100644 --- a/docs/en/sql-reference/table-functions/url.md +++ b/docs/en/sql-reference/table-functions/url.md @@ -27,7 +27,8 @@ A table with the specified format and structure and with data from the defined ` ## Globs in URL {globs-in-url} -Patterns in curly brackets `{ }` are used to generate a set of shards or to specify failover addresses. Supported pattern types and examples see in the description of the [remote](remote.md#globs-in-addresses) function. Additionally, character `|` is used to specify failover addresses. They are iterated in the same order as listed in the pattern. The maximum number of generated addresses is limited by [glob_expansion_max_elements](../../operations/settings/settings.md#glob_expansion_max_elements) setting. +Patterns in curly brackets `{ }` are used to generate a set of shards or to specify failover addresses. Supported pattern types and examples see in the description of the [remote](remote.md#globs-in-addresses) function. +Additionally, character `|` is used to specify failover addresses. They are iterated in the same order as listed in the pattern. The number of generated addresses is limited by [glob_expansion_max_elements](../../operations/settings/settings.md#glob_expansion_max_elements) setting. **Examples** diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md index 10321e32975..95e1a7ef4cf 100644 --- a/docs/ru/operations/settings/settings.md +++ b/docs/ru/operations/settings/settings.md @@ -141,7 +141,7 @@ ClickHouse применяет настройку в тех случаях, ко ## glob_expansion_max_elements {#glob_expansion_max_elements } -Задает максимальное количество адресов, которые могут быть сгенерированы из шаблонов при использовании внешних хранилищ и в табличных функциях, кроме функции `remote`. +Задает максимальное количество адресов, которые могут быть сгенерированы из шаблонов при использовании внешних хранилищ и при вызове табличных функциях (например, [url](../../sql-reference/table-functions/url.md)), кроме функции `remote`. Возможные значения: diff --git a/docs/ru/sql-reference/table-functions/remote.md b/docs/ru/sql-reference/table-functions/remote.md index 00179abb207..fc25377c72f 100644 --- a/docs/ru/sql-reference/table-functions/remote.md +++ b/docs/ru/sql-reference/table-functions/remote.md @@ -68,27 +68,18 @@ localhost example01-01-1,example01-02-1 ``` -Часть выражения может быть указана в фигурных скобках. Предыдущий пример может быть записан следующим образом: +## Символы подстановки в адресах {globs-in-addresses} -``` text -example01-0{1,2}-1 -``` +Шаблоны в фигурных скобках `{ }` используются, чтобы сгенерировать список шардов или указать альтернативный адрес на случай отказа. В одном URL можно использовать несколько шаблонов. +Поддерживаются следующие типы шаблонов. -В фигурных скобках может быть указан диапазон (неотрицательных целых) чисел через две точки. В этом случае диапазон раскрывается в множество значений, генерирующих адреса шардов. Если запись первого числа начинается с нуля, то значения формируются с таким же выравниванием нулями. Предыдущий пример может быть записан следующим образом: +- {*a*,*b*} - несколько вариантов, разделенных запятой. Весь шаблон заменяется на *a* в адресе первого шарда, заменяется на *b* в адресе второго шарда и так далее. Например, `example0{1,2}-1` генерирует адреса `example01-1` и `example02-1`. +- {*n*..*m*} - диапазон чисел. Этот шаблон генерирует адреса шардов с увеличивающимися индексами от *n* до *m*. `example0{1..2}-1` генерирует `example01-1` и `example02-1`. +- {*0n*..*0m*} - диапазон чисел с ведущими нулями. Такой вариант сохраняет ведущие нули в индексах. По шаблону `example{01..03}-1` генерируются `example01-1`, `example02-1` и `example03-1`. +- {*a*|*b*} - несколько вариантов, разделенных `|`. Шаблон задает адреса реплик. Например, `example01-{1|2}` генерирует реплики`example01-1` и `example01-2`. -``` text -example01-{01..02}-1 -``` - -При наличии нескольких пар фигурных скобок генерируется прямое произведение соответствующих множеств. - -Адреса или их фрагменты в фигурных скобках можно указать через символ \|. В этом случае соответствующие множества адресов понимаются как реплики — запрос будет отправлен на первую живую реплику. При этом реплики перебираются в порядке, согласно текущей настройке [load_balancing](../../operations/settings/settings.md#settings-load_balancing). В этом примере указаны два шарда, в каждом из которых имеются две реплики: - -``` text -example01-{01..02}-{1|2} -``` - -Количество генерируемых адресов ограничено константой. Сейчас это 1000 адресов. +Запрос будет отправлен на первую живую реплику. При этом реплики перебираются в порядке, заданном настройкой [load_balancing](../../operations/settings/settings.md#settings-load_balancing). +Количество генерируемых адресов ограничено настройкой [table_function_remote_max_addresses](../../operations/settings/settings.md#table_function_remote_max_addresses). **Примеры** diff --git a/docs/ru/sql-reference/table-functions/url.md b/docs/ru/sql-reference/table-functions/url.md index 9f6dcd36138..b4cd9128249 100644 --- a/docs/ru/sql-reference/table-functions/url.md +++ b/docs/ru/sql-reference/table-functions/url.md @@ -25,15 +25,11 @@ url(URL, format, structure) Таблица с указанными форматом и структурой, а также с данными, полученными из указанного адреса `URL`. -**Шаблоны в URL** +## Символы подстановки в URL {globs-in-url} -Шаблоны в фигурных скобках `{ }` используются, чтобы сгенерировать список шардов или указать альтернативный адрес на случай отказа. В одном URL можно использовать несколько шаблонов. -Поддерживаются следующие типы шаблонов. +Шаблоны в фигурных скобках `{ }` используются, чтобы сгенерировать список шардов или указать альтернативные адреса на случай отказа. Поддерживаемые типы шаблонов и примеры есть в описании функции [remote](remote.md#globs-in-addresses). +Символ `|` используется, чтобы задать адреса, если предыдущие оказались недоступны. Эти адреса перебираются в том же порядке, в котором они указаны в шаблоне. Количество адресов, которые могут быть сгенерированы, ограничено настройкой [glob_expansion_max_elements](../../operations/settings/settings.md#glob_expansion_max_elements). -- {*a*,*b*} - несколько вариантов, разделенных запятой. Весь шаблон заменяется на *a* в адресе первого шарда, заменяется на *b* в адресе второго шарда и так далее. Например, `example0{1,2}-1` генерирует адреса `example01-1` и `example02-1`. -- {*n*..*m*} - диапазон чисел. Этот шаблон генерирует адреса шардов с увеличивающимися индексами от *n* до *m*. `example0{1..2}-1` генерирует `example01-1` и `example02-1`. -- {*0n*..*0m*} - диапазон чисел с ведущими нулями. Такой вариант сохраняет ведущие нули в индексах. По шаблону `example{01..03}-1` генерируются `example01-1`, `example02-1` и `example03-1`. -- {*a*|*b*} - несколько вариантов, разделенных `|`. Шаблон задает адреса на случай отказа: адрес с вариантом *b* используется, если адрес с вариантом *a* недоступен. По шаблону `example01-{1|2}` сначала выполняется обращение к `example01-1`. Если этот адрес недоступен, то используется `example01-2`. **Примеры**