From a0814164c06c75e9748f7e755386b9ac8798fda0 Mon Sep 17 00:00:00 2001 From: filimonov <1549571+filimonov@users.noreply.github.com> Date: Mon, 9 Jul 2018 14:06:35 +0200 Subject: [PATCH] describing distributed_product_mode in settings.md See https://github.com/yandex/ClickHouse/blob/7707b5a2097df6c79e3aeecc3270b404b96dca82/dbms/src/Interpreters/InJoinSubqueriesPreprocessor.h#L17-L32 https://github.com/yandex/ClickHouse/blob/576885c6b8fb001c8d036fcb8162d14fd1c2e8f1/dbms/src/Interpreters/Settings.h#L121 https://github.com/yandex/ClickHouse/blob/77fd2f3721f7ba0fd0c78c7e16da1a3a8abd2cd0/dbms/src/Interpreters/SettingsCommon.cpp#L464-L473 https://github.com/yandex/ClickHouse/blob/88efe5ad56e580fb322b52b5a2fe89b9f13cccd0/dbms/src/Interpreters/InJoinSubqueriesPreprocessor.cpp#L155 --- docs/ru/operations/settings/settings.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md index 69fd8ab3978..9cd6639d941 100644 --- a/docs/ru/operations/settings/settings.md +++ b/docs/ru/operations/settings/settings.md @@ -4,18 +4,24 @@ ## distributed_product_mode -Изменяет поведение [распределенных подзапросов](../../query_language/queries.md#queries-distributed-subrequests), т.е. в тех случаях, когда запрос содержит произведение распределённых таблиц. +Изменяет поведение [распределенных подзапросов](../../query_language/queries.md#queries-distributed-subrequests). -ClickHouse применяет настройку в том случае, когда в подзапросах на любом уровне встретилась распределенная таблица, которая существует на локальном сервере и имеет больше одного шарда. +ClickHouse применяет настройку в тех случаях, когда запрос содержит произведение распределённых таблиц, т.е. когда запрос к распределенной таблице содержит не-GLOBAL подзапрос к также распределенной таблице. Условия применения: - Только подзапросы для IN, JOIN. -- Только если в секции FROM используется распределённая таблица. +- Только если в секции FROM используется распределённая таблица, содержащая более одного шарда. +- Если подзапрос касается распределенной таблицы, содержащей более одного шарда, - Не используется в случае табличной функции [remote](../../table_functions/remote.md#table_functions-remote). Возможные значения: +- `deny` - (по умолчанию) запрещает использование таких подзапросов (При попытке использование вернет исключение "Double-distributed IN/JOIN subqueries is denied"); +- `local` - заменит базу данных и таблицу в подзапросе на локальные для конечного сервера (шарда), оставив обычный `IN` / `JOIN`; +- `global` - заменит запрос `IN` / `JOIN` на `GLOBAL IN` / `GLOBAL JOIN`; +- `allow` - разрешает использование таких подзапросов. + ## fallback_to_stale_replicas_for_distributed_queries