Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCAPI-3818: English review for StripeLog and Log Engines Family docs #4336

Merged
merged 60 commits into from Feb 11, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
60 commits
Select commit Hold shift + click to select a range
88f2908
Update of english version of descriprion of the table function `file`.
BayoNet Sep 7, 2018
90b1f5f
New syntax for ReplacingMergeTree.
BayoNet Sep 19, 2018
0f2ba30
Significantly change article about SummingMergeTree.
BayoNet Sep 19, 2018
3a53ba0
Descriptions of AggregateFunction and AggregatingMergeTree are update…
BayoNet Sep 24, 2018
e5183df
New syntax for new syntax of CREATE TABLE
BayoNet Sep 28, 2018
78e0449
Added english docs on Aggregating, Replacing and SummingMergeTree.
BayoNet Oct 2, 2018
53a89c0
CollapsingMergeTree docs. English version.
BayoNet Oct 4, 2018
5954d90
1. Update of CollapsingMergeTree. 2. Minor changes in markup
BayoNet Oct 11, 2018
5d99f4a
Merge branch 'updating-docs'
BayoNet Oct 11, 2018
2a657b0
Update aggregatefunction.md
alexey-milovidov Oct 11, 2018
3b5466c
Update aggregatefunction.md
alexey-milovidov Oct 11, 2018
4b69101
Update aggregatefunction.md
alexey-milovidov Oct 11, 2018
4fc31d4
Update aggregatingmergetree.md
alexey-milovidov Oct 11, 2018
5af663b
Merge remote-tracking branch 'upstream/master'
BayoNet Oct 18, 2018
bcd9902
GraphiteMergeTree docs update.
BayoNet Oct 18, 2018
cf28348
Markup fix
BayoNet Oct 18, 2018
588d97f
Markup and language fixes
BayoNet Oct 19, 2018
edbb18c
Clarification in the CollapsingMergeTree article
BayoNet Oct 19, 2018
bd81b72
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Oct 22, 2018
46019e3
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Oct 23, 2018
931124a
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Oct 25, 2018
1f8a79e
DOCAPI-4821. Sync between ru and en versions of docs.
BayoNet Oct 25, 2018
7e59228
Fixed the ambiguity in geo functions description.
BayoNet Oct 26, 2018
f561559
Example of JOIN in ru docs
BayoNet Oct 26, 2018
aa8495d
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Oct 31, 2018
9cdbbc6
Deleted misinforming example.
BayoNet Oct 31, 2018
fc2b345
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Nov 8, 2018
ef2f533
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Nov 19, 2018
1300613
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Nov 21, 2018
4f2b06a
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Nov 27, 2018
be27d6a
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Nov 30, 2018
76c36d9
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 4, 2018
cd4f6ab
Fixed links to IN operators.
BayoNet Dec 5, 2018
c2308bd
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 5, 2018
33cd66f
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 7, 2018
585ca2a
Updated the description of ALTER MODIFY.
BayoNet Dec 7, 2018
e6d28fb
[RU] Updated ALTER MODIFY description.
BayoNet Dec 10, 2018
291e531
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 10, 2018
2c0c09e
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 11, 2018
00fbdc3
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 11, 2018
c9f6ee3
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 18, 2018
4e43a39
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 25, 2018
5a25d65
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 27, 2018
de189fe
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Dec 28, 2018
f417854
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Jan 11, 2019
3222dd9
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Jan 14, 2019
ec3e4bc
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Jan 18, 2019
d1529e5
Merge branch 'master' of github.com:yandex/ClickHouse
BayoNet Jan 23, 2019
06b7105
Fixed anchors.
BayoNet Jan 23, 2019
1046c5b
DOCAPI-3818: The Family of Log engines. StripeLog. Tocs sync.
BayoNet Jan 30, 2019
cb22763
Merge branch 'master' of github.com:yandex/ClickHouse into DOCAPI-381…
BayoNet Jan 30, 2019
5dff735
Merge branch 'master' of github.com:BayoNet/ClickHouse into DOCAPI-38…
BayoNet Feb 4, 2019
a6117b8
Merge branch 'master' of github.com:yandex/ClickHouse into DOCAPI-381…
BayoNet Feb 4, 2019
4712601
DOCAPI-3818: Edits after review by Ivan Blinkov.
BayoNet Feb 4, 2019
020c602
DOCAPI-3818: Reviewed EN docs and RU translation of StripeLog and Log…
BayoNet Feb 10, 2019
871d270
Merge branch 'master' of github.com:yandex/ClickHouse into DOCAPI-381…
BayoNet Feb 10, 2019
77861cf
DOCAPI-3818: Typos fix.
BayoNet Feb 10, 2019
5021a9a
DOCAPI-3818: Removed sybolical links to untranslated topics.
BayoNet Feb 11, 2019
e68255b
DOCAPI-3818: Added translated files instead of deleted symbolical links.
BayoNet Feb 11, 2019
369f8a4
DOCAPI-3818: Removed sybolical links to untranslated topics.
BayoNet Feb 11, 2019
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/en/operations/table_engines/stripelog.md
@@ -1,8 +1,8 @@
# StripeLog

Engine belongs to the family of log engines. See the common properties of log engines and their differences in the [Log Engine Family](log_family.md) article.
This engine belongs to the family of log engines. See the common properties of log engines and their differences in the [Log Engine Family](log_family.md) article.

Use this engine in scenarios, when you need to write many tables with the small amount of data (less than 1 million rows).
Use this engine in scenarios when you need to write many tables with a small amount of data (less than 1 million rows).

## Creating a Table {#table_engines-stripelog-creating-a-table}

Expand All @@ -15,13 +15,13 @@ CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
) ENGINE = StripeLog
```

See the detailed description of [CREATE TABLE](../../query_language/create.md#create-table-query) query.
See the detailed description of the [CREATE TABLE](../../query_language/create.md#create-table-query) query.

## Writing the Data {#table_engines-stripelog-writing-the-data}

The `StripeLog` engine stores all the columns in one file. The `Log` and `TinyLog` engines store columns in separate files. For each `INSERT` query, ClickHouse appends data block to the end of a table file, writing columns one by one.
The `StripeLog` engine stores all the columns in one file. For each `INSERT` query, ClickHouse appends the data block to the end of a table file, writing columns one by one.

For each table ClickHouse writes two files:
For each table ClickHouse writes the files:

- `data.bin` — Data file.
- `index.mrk` — File with marks. Marks contain offsets for each column of each data block inserted.
Expand All @@ -30,7 +30,7 @@ The `StripeLog` engine does not support the `ALTER UPDATE` and `ALTER DELETE` op

## Reading the Data {#table_engines-stripelog-reading-the-data}

File with marks allows ClickHouse parallelize the reading of data. This means that `SELECT` query returns rows in an unpredictable order. Use the `ORDER BY` clause to sort rows.
The file with marks allows ClickHouse to parallelize the reading of data. This means that a `SELECT` query returns rows in an unpredictable order. Use the `ORDER BY` clause to sort rows.

## Example of Use {#table_engines-stripelog-example-of-use}

Expand All @@ -53,9 +53,9 @@ INSERT INTO stripe_log_table VALUES (now(),'REGULAR','The first regular message'
INSERT INTO stripe_log_table VALUES (now(),'REGULAR','The second regular message'),(now(),'WARNING','The first warning message')
```

We used two `INSERT` queries to create two data block inside the `data.bin` file.
We used two `INSERT` queries to create two data blocks inside the `data.bin` file.

When selecting data, ClickHouse uses multiple threads. Each thread reads the separate data block and returns resulting rows independently as it finished. It causes that the order of blocks of rows in the output does not match the order of the same blocks in the input in the most cases. For example:
ClickHouse uses multiple threads when selecting data. Each thread reads a separate data block and returns resulting rows independently as it finishes. As a result, the order of blocks of rows in the output does not match the order of the same blocks in the input in most cases. For example:

```sql
SELECT * FROM stripe_log_table
Expand Down
5 changes: 4 additions & 1 deletion docs/ru/operations/table_engines/log.md
@@ -1,7 +1,10 @@
# Log

Отличается от TinyLog тем, что вместе с файлами столбцов лежит небольшой файл "засечек". Засечки пишутся на каждый блок данных и содержат смещение - с какого места нужно читать файл, чтобы пропустить заданное количество строк. Это позволяет читать данные из таблицы в несколько потоков.
Движок относится к семейству движков для логгирования. Смотрите общие свойства и различия движков в статье [Движки для логгирования](log_family.md).

Отличается от [TinyLog](tinylog.md) тем, что вместе с файлами столбцов лежит небольшой файл "засечек". Засечки пишутся на каждый блок данных и содержат смещение - с какого места нужно читать файл, чтобы пропустить заданное количество строк. Это позволяет читать данные из таблицы в несколько потоков.
При конкуррентном доступе к данным, чтения могут выполняться одновременно, а записи блокируют чтения и друг друга.
Движок Log не поддерживает индексы. Также, если при записи в таблицу произошёл сбой, то таблица станет битой, и чтения из неё будут возвращать ошибку. Движок Log подходит для временных данных, write-once таблиц, а также для тестовых и демонстрационных целей.

[Оригинальная статья](https://clickhouse.yandex/docs/ru/operations/table_engines/log/) <!--hide-->

1 change: 0 additions & 1 deletion docs/ru/operations/table_engines/log_family.md

This file was deleted.

1 change: 0 additions & 1 deletion docs/ru/operations/table_engines/stripelog.md

This file was deleted.

6 changes: 4 additions & 2 deletions docs/ru/operations/table_engines/tinylog.md
@@ -1,13 +1,15 @@
# TinyLog

Движок относится к семейству движков для логгирования. Смотрите общие свойства и различия движков в статье [Движки для логгирования](log_family.md).

Самый простой движок таблиц, который хранит данные на диске.
Каждый столбец хранится в отдельном сжатом файле.
При записи, данные дописываются в конец файлов.

Конкурентный доступ к данным никак не ограничивается:

- если вы одновременно читаете из таблицы и в другом запросе пишете в неё, то чтение будет завершено с ошибкой;
- если вы одновременно пишете в таблицу в нескольких запросах, то данные будут битыми.
- если вы одновременно читаете из таблицы и в другом запросе пишете в неё, то чтение будет завершено с ошибкой;
- если вы одновременно пишете в таблицу в нескольких запросах, то данные будут битыми.

Типичный способ использования этой таблицы - это write-once: сначала один раз только пишем данные, а потом сколько угодно читаем.
Запросы выполняются в один поток. То есть, этот движок предназначен для сравнительно маленьких таблиц (рекомендуется до 1 000 000 строк).
Expand Down