mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-20 00:30:49 +00:00
The admonitions were missing section endings (#40073)
This commit is contained in:
Rich Raposa
GitHub
parent
cbeba683d8
commit
9f85d85e08
@ -8,6 +8,7 @@ sidebar_label: Сборка на Mac OS X
|
||||
:::info "Вам не нужно собирать ClickHouse самостоятельно"
|
||||
Вы можете установить предварительно собранный ClickHouse, как описано в [Быстром старте](https://clickhouse.com/#quick-start).
|
||||
Следуйте инструкциям по установке для `macOS (Intel)` или `macOS (Apple Silicon)`.
|
||||
:::
|
||||
|
||||
Сборка должна запускаться с x86_64 (Intel) на macOS версии 10.15 (Catalina) и выше в последней версии компилятора Xcode's native AppleClang, Homebrew's vanilla Clang или в GCC-компиляторах.
|
||||
|
||||
@ -90,6 +91,7 @@ $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/
|
||||
|
||||
:::info "Note"
|
||||
Вам понадобится команда `sudo`.
|
||||
:::
|
||||
|
||||
1. Создайте файл `/Library/LaunchDaemons/limit.maxfiles.plist` и поместите в него следующее:
|
||||
|
||||
|
||||
@ -49,6 +49,7 @@ PostgreSQL массивы конвертируются в массивы ClickHo
|
||||
|
||||
:::info "Внимание"
|
||||
Будьте внимательны, в PostgreSQL массивы, созданные как `type_name[]`, являются многомерными и могут содержать в себе разное количество измерений в разных строках одной таблицы. Внутри ClickHouse допустимы только многомерные массивы с одинаковым кол-вом измерений во всех строках таблицы.
|
||||
:::
|
||||
|
||||
Поддерживает несколько реплик, которые должны быть перечислены через `|`. Например:
|
||||
|
||||
|
||||
@ -40,6 +40,7 @@ ORDER BY (CounterID, StartDate, intHash32(UserID));
|
||||
|
||||
:::info "Info"
|
||||
Не рекомендуется делать слишком гранулированное партиционирование – то есть задавать партиции по столбцу, в котором будет слишком большой разброс значений (речь идет о порядке более тысячи партиций). Это приведет к скоплению большого числа файлов и файловых дескрипторов в системе, что может значительно снизить производительность запросов `SELECT`.
|
||||
:::
|
||||
|
||||
Чтобы получить набор кусков и партиций таблицы, можно воспользоваться системной таблицей [system.parts](../../../engines/table-engines/mergetree-family/custom-partitioning-key.md#system_tables-parts). В качестве примера рассмотрим таблицу `visits`, в которой задано партиционирование по месяцам. Выполним `SELECT` для таблицы `system.parts`:
|
||||
|
||||
@ -80,6 +81,7 @@ WHERE table = 'visits'
|
||||
|
||||
:::info "Info"
|
||||
Названия кусков для таблиц старого типа образуются следующим образом: `20190117_20190123_2_2_0` (минимальная дата _ максимальная дата _ номер минимального блока _ номер максимального блока _ уровень).
|
||||
:::
|
||||
|
||||
Как видно из примера выше, таблица содержит несколько отдельных кусков для одной и той же партиции (например, куски `201901_1_3_1` и `201901_1_9_2` принадлежат партиции `201901`). Это означает, что эти куски еще не были объединены – в файловой системе они хранятся отдельно. После того как будет выполнено автоматическое слияние данных (выполняется примерно спустя 10 минут после вставки данных), исходные куски будут объединены в один более крупный кусок и помечены как неактивные.
|
||||
|
||||
|
||||
@ -14,3 +14,4 @@ sidebar_position: 10
|
||||
|
||||
:::info "Забавный факт"
|
||||
Спустя годы после того, как ClickHouse получил свое название, принцип комбинирования двух слов, каждое из которых имеет подходящий смысл, был признан лучшим способом назвать базу данных в [исследовании Andy Pavlo](https://www.cs.cmu.edu/~pavlo/blog/2020/03/on-naming-a-database-management-system.html), Associate Professor of Databases в Carnegie Mellon University. ClickHouse разделил награду "за лучшее название СУБД" с Postgres.
|
||||
:::
|
||||
@ -20,5 +20,6 @@ sidebar_label: Общие вопросы
|
||||
|
||||
:::info "Если вы не нашли то, что искали:"
|
||||
Загляните в другие категории F.A.Q. или поищите в остальных разделах документации, ориентируясь по оглавлению слева.
|
||||
:::
|
||||
|
||||
[Original article](https://clickhouse.com/docs/ru/faq/general/) <!--hide-->
|
||||
|
||||
@ -60,3 +60,4 @@ sidebar_position: 8
|
||||
- Ориентируйтесь на показатели, собранные при работе с реальными данными.
|
||||
- Проверяйте производительность в процессе CI.
|
||||
- Измеряйте и анализируйте всё, что только возможно.
|
||||
:::
|
||||
|
||||
@ -15,5 +15,6 @@ sidebar_label: Интеграция
|
||||
|
||||
:::info "Если вы не нашли то, что искали"
|
||||
Загляните в другие подразделы F.A.Q. или поищите в остальных разделах документации, ориентируйтесь по оглавлению слева.
|
||||
:::
|
||||
|
||||
[Original article](https://clickhouse.com/docs/ru/faq/integration/)
|
||||
|
||||
@ -14,5 +14,6 @@ sidebar_label: Операции
|
||||
|
||||
:::info "Если вы не нашли то, что искали"
|
||||
Загляните в другие подразделы F.A.Q. или поищите в остальных разделах документации, ориентируйтесь по оглавлению слева.
|
||||
:::
|
||||
|
||||
[Original article](https://clickhouse.com/docs/en/faq/operations/)
|
||||
|
||||
@ -293,6 +293,7 @@ $ clickhouse-client --query "SELECT COUNT(*) FROM datasets.trips_mergetree"
|
||||
:::info "Info"
|
||||
Если вы собираетесь выполнять запросы, приведенные ниже, то к имени таблицы
|
||||
нужно добавить имя базы, `datasets.trips_mergetree`.
|
||||
:::
|
||||
|
||||
## Результаты на одном сервере {#rezultaty-na-odnom-servere}
|
||||
|
||||
|
||||
@ -157,6 +157,7 @@ $ clickhouse-client --query "SELECT COUNT(*) FROM datasets.ontime"
|
||||
:::info "Info"
|
||||
Если вы собираетесь выполнять запросы, приведенные ниже, то к имени таблицы
|
||||
нужно добавить имя базы, `datasets.ontime`.
|
||||
:::
|
||||
|
||||
## Запросы: {#zaprosy}
|
||||
|
||||
|
||||
@ -99,6 +99,7 @@ ClickHouse предоставляет возможность аутентифи
|
||||
|
||||
:::info ""
|
||||
Ещё раз отметим, что кроме `users.xml`, необходимо также включить Kerberos в `config.xml`.
|
||||
:::
|
||||
|
||||
### Настройка Kerberos через SQL {#enabling-kerberos-using-sql}
|
||||
|
||||
|
||||
@ -174,6 +174,7 @@ ClickHouse проверяет условия для `min_part_size` и `min_part
|
||||
|
||||
:::info "Примечание"
|
||||
Жесткое ограничение настраивается с помощью системных инструментов.
|
||||
:::
|
||||
|
||||
**Пример**
|
||||
|
||||
@ -706,6 +707,7 @@ ClickHouse поддерживает динамическое изменение
|
||||
|
||||
:::info "Примечание"
|
||||
Параметры этих настроек могут быть изменены во время выполнения запросов и вступят в силу немедленно. Запросы, которые уже запущены, выполнятся без изменений.
|
||||
:::
|
||||
|
||||
Возможные значения:
|
||||
|
||||
@ -726,6 +728,7 @@ ClickHouse поддерживает динамическое изменение
|
||||
|
||||
:::info "Примечание"
|
||||
Параметры этих настроек могут быть изменены во время выполнения запросов и вступят в силу немедленно. Запросы, которые уже запущены, выполнятся без изменений.
|
||||
:::
|
||||
|
||||
Возможные значения:
|
||||
|
||||
@ -746,6 +749,7 @@ ClickHouse поддерживает динамическое изменение
|
||||
|
||||
:::info "Примечание"
|
||||
Параметры этих настроек могут быть изменены во время выполнения запросов и вступят в силу немедленно. Запросы, которые уже запущены, выполнятся без изменений.
|
||||
:::
|
||||
|
||||
Возможные значения:
|
||||
|
||||
|
||||
@ -30,6 +30,7 @@
|
||||
|
||||
:::info "Замечание"
|
||||
Даже если `parts_to_do = 0`, для реплицированной таблицы возможна ситуация, когда мутация ещё не завершена из-за долго выполняющейся операции `INSERT`, которая добавляет данные, которые нужно будет мутировать.
|
||||
:::
|
||||
|
||||
Если во время мутации какого-либо куска возникли проблемы, заполняются следующие столбцы:
|
||||
|
||||
|
||||
@ -8,6 +8,7 @@ sidebar_position: 141
|
||||
|
||||
:::info "Примечание"
|
||||
Чтобы эта функция работала должным образом, исходные данные должны быть отсортированы. В [материализованном представлении](../../../sql-reference/statements/create/view.md#materialized) вместо нее рекомендуется использовать [deltaSumTimestamp](../../../sql-reference/aggregate-functions/reference/deltasumtimestamp.md#agg_functions-deltasumtimestamp).
|
||||
:::
|
||||
|
||||
**Синтаксис**
|
||||
|
||||
|
||||
@ -20,6 +20,7 @@ intervalLengthSum(start, end)
|
||||
|
||||
:::info "Примечание"
|
||||
Аргументы должны быть одного типа. В противном случае ClickHouse сгенерирует исключение.
|
||||
:::
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
|
||||
@ -26,6 +26,7 @@ sidebar_label: Nullable
|
||||
|
||||
:::info "Info"
|
||||
Почти всегда использование `Nullable` снижает производительность, учитывайте это при проектировании своих баз.
|
||||
:::
|
||||
|
||||
## Поиск NULL {#finding-null}
|
||||
|
||||
|
||||
@ -464,6 +464,7 @@ SOURCE(ODBC(
|
||||
|
||||
:::info "Примечание"
|
||||
Поля `table` и `query` не могут быть использованы вместе. Также обязательно должен быть один из источников данных: `table` или `query`.
|
||||
:::
|
||||
|
||||
ClickHouse получает от ODBC-драйвера информацию о квотировании и квотирует настройки в запросах к драйверу, поэтому имя таблицы нужно указывать в соответствии с регистром имени таблицы в базе данных.
|
||||
|
||||
@ -543,6 +544,7 @@ SOURCE(MYSQL(
|
||||
:::info "Примечание"
|
||||
Поля `table` или `where` не могут быть использованы вместе с полем `query`. Также обязательно должен быть один из источников данных: `table` или `query`.
|
||||
Явный параметр `secure` отсутствует. Автоматически поддержана работа в обоих случаях: когда установка SSL-соединения необходима и когда нет.
|
||||
:::
|
||||
|
||||
MySQL можно подключить на локальном хосте через сокеты, для этого необходимо задать `host` и `socket`.
|
||||
|
||||
@ -633,6 +635,7 @@ SOURCE(CLICKHOUSE(
|
||||
|
||||
:::info "Примечание"
|
||||
Поля `table` или `where` не могут быть использованы вместе с полем `query`. Также обязательно должен быть один из источников данных: `table` или `query`.
|
||||
:::
|
||||
|
||||
### MongoDB {#dicts-external_dicts_dict_sources-mongodb}
|
||||
|
||||
@ -748,6 +751,7 @@ SOURCE(REDIS(
|
||||
|
||||
:::info "Примечание"
|
||||
Поля `column_family` или `where` не могут быть использованы вместе с полем `query`. Также обязательно должен быть один из источников данных: `column_family` или `query`.
|
||||
:::
|
||||
|
||||
### PostgreSQL {#dicts-external_dicts_dict_sources-postgresql}
|
||||
|
||||
@ -804,3 +808,4 @@ SOURCE(POSTGRESQL(
|
||||
|
||||
:::info "Примечание"
|
||||
Поля `table` или `where` не могут быть использованы вместе с полем `query`. Также обязательно должен быть один из источников данных: `table` или `query`.
|
||||
:::
|
||||
|
||||
@ -86,6 +86,7 @@ geohashesInBox(longitude_min, latitude_min, longitude_max, latitude_max, precisi
|
||||
|
||||
:::info "Замечание"
|
||||
Все передаваемые координаты должны быть одного и того же типа: либо `Float32`, либо `Float64`.
|
||||
:::
|
||||
|
||||
**Возвращаемые значения**
|
||||
|
||||
@ -96,6 +97,7 @@ geohashesInBox(longitude_min, latitude_min, longitude_max, latitude_max, precisi
|
||||
|
||||
:::info "Замечание"
|
||||
Если возвращаемый массив содержит свыше 10 000 000 элементов, функция сгенерирует исключение.
|
||||
:::
|
||||
|
||||
**Пример**
|
||||
|
||||
|
||||
@ -1209,6 +1209,7 @@ SELECT toLowCardinality('1');
|
||||
|
||||
:::info "Примечание"
|
||||
Возвращаемое значение — это временная метка в UTC, а не в часовом поясе `DateTime64`.
|
||||
:::
|
||||
|
||||
**Синтаксис**
|
||||
|
||||
|
||||
@ -25,7 +25,7 @@ ALTER TABLE [db].name [ON CLUSTER cluster] ADD|DROP|CLEAR|COMMENT|MODIFY COLUMN
|
||||
- [CONSTRAINT](../../../sql-reference/statements/alter/constraint.md)
|
||||
- [TTL](../../../sql-reference/statements/alter/ttl.md)
|
||||
|
||||
:::note
|
||||
:::note
|
||||
Запрос `ALTER TABLE` поддерживается только для таблиц типа `*MergeTree`, а также `Merge` и `Distributed`. Запрос имеет несколько вариантов.
|
||||
:::
|
||||
Следующие запросы `ALTER` управляют представлениями:
|
||||
@ -77,5 +77,6 @@ ALTER TABLE [db.]table MATERIALIZE INDEX name IN PARTITION partition_name
|
||||
|
||||
:::info "Примечание"
|
||||
Для всех запросов `ALTER` при `replication_alter_partitions_sync = 2` и неактивности некоторых реплик больше времени, заданного настройкой `replication_wait_for_inactive_replica_timeout`, генерируется исключение `UNFINISHED`.
|
||||
:::
|
||||
|
||||
Для запросов `ALTER TABLE ... UPDATE|DELETE` синхронность выполнения определяется настройкой [mutations_sync](../../../operations/settings/settings.md#mutations_sync).
|
||||
|
||||
@ -56,6 +56,7 @@ CREATE USER [IF NOT EXISTS | OR REPLACE] name1 [ON CLUSTER cluster_name1]
|
||||
|
||||
:::info "Внимание"
|
||||
ClickHouse трактует конструкцию `user_name@'address'` как имя пользователя целиком. То есть технически вы можете создать несколько пользователей с одинаковыми `user_name`, но разными частями конструкции после `@`, но лучше так не делать.
|
||||
:::
|
||||
|
||||
## Секция GRANTEES {#grantees}
|
||||
|
||||
|
||||
@ -88,6 +88,7 @@ LIVE-представления работают по тому же принци
|
||||
- `LIVE VIEW` не обновляется, если в исходном запросе используются несколько таблиц.
|
||||
|
||||
В случаях, когда `LIVE VIEW` не обновляется автоматически, чтобы обновлять его принудительно с заданной периодичностью, используйте [WITH REFRESH](#live-view-with-refresh).
|
||||
:::
|
||||
|
||||
### Отслеживание изменений LIVE-представлений {#live-view-monitoring}
|
||||
|
||||
|
||||
@ -30,6 +30,7 @@ ClickHouse не оповещает клиента. Чтобы включить
|
||||
|
||||
:::info "Примечание"
|
||||
Если значение настройки `replication_alter_partitions_sync` равно `2` и некоторые реплики не активны больше времени, заданного настройкой `replication_wait_for_inactive_replica_timeout`, то генерируется исключение `UNFINISHED`.
|
||||
:::
|
||||
|
||||
## Выражение BY {#by-expression}
|
||||
|
||||
|
||||
@ -368,6 +368,7 @@ SHOW ACCESS
|
||||
|
||||
:::info "Note"
|
||||
По запросу `SHOW CLUSTER name` вы получите содержимое таблицы system.clusters для этого кластера.
|
||||
:::
|
||||
|
||||
### Синтаксис {#show-cluster-syntax}
|
||||
|
||||
|
||||
@ -19,3 +19,4 @@ TRUNCATE TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]
|
||||
|
||||
:::info "Примечание"
|
||||
Если значение настройки `replication_alter_partitions_sync` равно `2` и некоторые реплики не активны больше времени, заданного настройкой `replication_wait_for_inactive_replica_timeout`, то генерируется исключение `UNFINISHED`.
|
||||
:::
|
||||
|
||||
@ -104,3 +104,4 @@ WATCH lv EVENTS LIMIT 1;
|
||||
|
||||
:::info "Примечание"
|
||||
При отслеживании [LIVE VIEW](./create/view.md#live-view) через интерфейс HTTP следует использовать формат [JSONEachRowWithProgress](../../interfaces/formats.md#jsoneachrowwithprogress). Постоянные сообщения об изменениях будут добавлены в поток вывода для поддержания активности долговременного HTTP-соединения до тех пор, пока результат запроса изменяется. Проомежуток времени между сообщениями об изменениях управляется настройкой[live_view_heartbeat_interval](./create/view.md#live-view-settings).
|
||||
:::
|
||||
@ -28,6 +28,7 @@ postgresql('host:port', 'database', 'table', 'user', 'password'[, `schema`])
|
||||
|
||||
:::info "Примечание"
|
||||
В запросах `INSERT` для того чтобы отличить табличную функцию `postgresql(...)` от таблицы со списком имен столбцов вы должны указывать ключевые слова `FUNCTION` или `TABLE FUNCTION`. См. примеры ниже.
|
||||
:::
|
||||
|
||||
## Особенности реализации {#implementation-details}
|
||||
|
||||
@ -43,6 +44,7 @@ PostgreSQL массивы конвертируются в массивы ClickHo
|
||||
|
||||
:::info "Примечание"
|
||||
Будьте внимательны, в PostgreSQL массивы, созданные как `type_name[]`, являются многомерными и могут содержать в себе разное количество измерений в разных строках одной таблицы. Внутри ClickHouse допустипы только многомерные массивы с одинаковым кол-вом измерений во всех строках таблицы.
|
||||
:::
|
||||
|
||||
Поддерживает несколько реплик, которые должны быть перечислены через `|`. Например:
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user