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

WIP on docs translation/normalization tools #9783

Merged
merged 41 commits into from
Mar 20, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
756fde1
replace exit with assert in test_single_page
blinkov Mar 19, 2020
0e49e72
improve save_raw_single_page docs option
blinkov Mar 19, 2020
347988e
More grammar fixes
blinkov Mar 19, 2020
b0e1f4f
"Built from" link in new tab
blinkov Mar 19, 2020
a554725
fix mistype
blinkov Mar 19, 2020
1db8808
Example of include in docs
blinkov Mar 19, 2020
3914a2a
add anchor to meeting form
blinkov Mar 19, 2020
9249160
Draft of translation helper
blinkov Mar 19, 2020
c70a3ec
Merge branch 'master' of https://github.com/yandex/ClickHouse
blinkov Mar 19, 2020
5b641f0
WIP on translation helper
blinkov Mar 19, 2020
3061c7e
Replace some fa docs content with machine translation
blinkov Mar 19, 2020
0401fed
add normalize-en-markdown.sh
blinkov Mar 19, 2020
96693bf
normalize some en markdown
blinkov Mar 19, 2020
5551848
normalize some en markdown
blinkov Mar 19, 2020
d28a5ce
admonition support
blinkov Mar 19, 2020
a74a709
normalize
blinkov Mar 19, 2020
ba33c7a
normalize
blinkov Mar 19, 2020
5daa90a
normalize
blinkov Mar 19, 2020
de0d0f5
support wide tables
blinkov Mar 19, 2020
293714a
normalize
blinkov Mar 19, 2020
9b08154
normalize
blinkov Mar 19, 2020
ff7cd74
normalize
blinkov Mar 19, 2020
b5b3858
normalize
blinkov Mar 19, 2020
0412b2b
normalize
blinkov Mar 19, 2020
6854e98
Merge branch 'master' of https://github.com/yandex/ClickHouse
blinkov Mar 19, 2020
84a498a
normalize
blinkov Mar 19, 2020
baa30d6
normalize
blinkov Mar 19, 2020
8cd36a9
normalize
blinkov Mar 20, 2020
fe57e8a
normalize
blinkov Mar 20, 2020
deb41ca
normalize
blinkov Mar 20, 2020
e68e022
normalize
blinkov Mar 20, 2020
a254d13
normalize
blinkov Mar 20, 2020
ce8d85d
normalize
blinkov Mar 20, 2020
134f6dd
Merge branch 'master' of https://github.com/yandex/ClickHouse
blinkov Mar 20, 2020
781ce80
lightly edited machine translation of introdpection.md
blinkov Mar 20, 2020
e8e83ab
lightly edited machhine translation of lazy.md
blinkov Mar 20, 2020
07fe96e
WIP on translation utils
blinkov Mar 20, 2020
793290a
Normalize ru docs
blinkov Mar 20, 2020
bc57aec
Normalize other languages
blinkov Mar 20, 2020
a5ca300
merge
blinkov Mar 20, 2020
c855ce6
some fixes
blinkov Mar 20, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion docs/en/operations/table_engines/collapsingmergetree.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@ For each resulting data part ClickHouse saves:

4. None of the rows, in all other cases.

Also when there are at least 2 more “state” rows than “cancel” rows, or at least 2 more “cancel” rows then “state” rows, the merge continues, but ClickHouse treats this situation as a logical error and records it in the server log. This error can occur if the same data were inserted more than once.
Also when there are at least 2 more “state” rows than “cancel” rows, or at least 2 more “cancel” rows then “state” rows, the merge continues, but ClickHouse treats this situation as a logical error and records it in the server log. This error can occur if the same data were inserted more than once.

Thus, collapsing should not change the results of calculating statistics.
Changes gradually collapsed so that in the end only the last state of almost every object left.
Expand Down
3 changes: 2 additions & 1 deletion docs/en/query_language/alter.md
Original file line number Diff line number Diff line change
Expand Up @@ -208,10 +208,11 @@ The following operations with [partitions](../operations/table_engines/custom_pa
- [FREEZE PARTITION](#alter_freeze-partition) – Creates a backup of a partition.
- [FETCH PARTITION](#alter_fetch-partition) – Downloads a partition from another server.
- [MOVE PARTITION\|PART](#alter_move-partition) – Move partition/data part to another disk or volume.
\#\#\#\# DETACH PARTITION {\#alter\_detach-partition}

<!-- -->

#### DETACH PARTITION {#alter\_detach-partition}

``` sql
ALTER TABLE table_name DETACH PARTITION partition_expr
```
Expand Down
8 changes: 4 additions & 4 deletions docs/en/query_language/dicts/external_dicts_dict_layout.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,7 @@ Configuration example:
LAYOUT(SPARSE_HASHED())
```

### complex\_key\_hashed {#complex_key_hashed}
### complex\_key\_hashed {#complex-key-hashed}

This type of storage is for use with composite [keys](external_dicts_dict_structure.md). Similar to `hashed`.

Expand All @@ -130,7 +130,7 @@ Configuration example:
LAYOUT(COMPLEX_KEY_HASHED())
```

### range\_hashed {#range_hashed}
### range\_hashed {#range-hashed}

The dictionary is stored in memory in the form of a hash table with an ordered array of ranges and their corresponding values.

Expand Down Expand Up @@ -285,11 +285,11 @@ Set a large enough cache size. You need to experiment to select the number of ce
!!! warning "Warning"
Do not use ClickHouse as a source, because it is slow to process queries with random reads.

### complex\_key\_cache {#complex_key_cache}
### complex\_key\_cache {#complex-key-cache}

This type of storage is for use with composite [keys](external_dicts_dict_structure.md). Similar to `cache`.

### ip\_trie {#ip_trie}
### ip\_trie {#ip-trie}

This type of storage is for mapping network prefixes (IP addresses) to metadata such as ASN.

Expand Down
5 changes: 3 additions & 2 deletions docs/fa/data_types/array.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# Array(T)
# Array(T) {#arrayt}

آرایه ای از عناصر با تایپ T. تایپ T می تواند هر Type باشد، از جمله یک آرایه. ما توصیه به استفاده از آرایه های multidimensional نمی کنیم، چون آنها به خوبی پشتیبانی نمی شوند (برای مثال، شما نمی تونید در جداولی که موتور آنها MergeTree است، آرایه های multidimensional ذخیره سازی کنید).

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/array/) <!--hide-->
4 changes: 2 additions & 2 deletions docs/fa/data_types/boolean.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# مقادیر Boolean
# مقادیر Boolean {#mqdyr-boolean}

type مخصوص مقادیر boolean وجود ندارد. از Uint8 و محدود شده به 0 و 1 می توان استفاده کرد.

Expand Down
5 changes: 3 additions & 2 deletions docs/fa/data_types/date.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# Date
# Date {#date}

Date، دو بایت به ازای هر تاریخ که به صورت عددی و از تاریخ 01-01-1970 می باشد ذخیره می کند (unsigned).این type به شما اجازه ی ذخیره سازی تاریخ های از ابتدای Unix Epoch تا بالاترین مقدار قابل پشتیبانی توسط این استاندارد را می دهد (در حال حاضر بالاترین مقدار این روش سال 2106 می باشد، اما سال آخری که به طور کامل پشتیبانی می شود سال 2105 است). کمترین مقدار این type در خروجی 0000-00-00 می باشد.

Date بدون time zone ذخیره می شود.

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/date/) <!--hide-->
6 changes: 3 additions & 3 deletions docs/fa/data_types/datetime.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# DateTime {#data_type-datetime}
# DateTime {#data-type-datetime}

تاریخ با ساعت 4 بایت به صورت Unix timestamp ذخیره می کند (unsigned). به شما اجازه ی ذخیره سازی در محدوده ی تایپ Date را می دهد. حداقل مقدار در خروجی 0000-00-00 00:00:00 می باشد. زمان با دقت تا یک ثانیه ذخیره می شود.

## Time zones
## Time zones {#time-zones}

این type از text به باینری تبدیل می شود، و در هنگام برگشت با توجه به time zone سرور، در زمانی که کلاینت یا سرور شروع به کار می کند تبدیل می شود. در فرمت text، اطلاعات DST از دست می رود.

Expand Down
15 changes: 7 additions & 8 deletions docs/fa/data_types/enum.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,24 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# Enum
# Enum {#enum}

Enum8 یا Enum16، به شما اجازه ی ذخیره سازی مجموعه ای محدود از رشته ها را می دهد که کارآمادتر از String می باشد.

مثال:

</div>

```
Enum8('hello' = 1, 'world' = 2)
```
Enum8('hello' = 1, 'world' = 2)

<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

- مقدار داخل این ستون می تواند یکی از دو مقدار 'hello' یا 'world' باشد.
- مقدار داخل این ستون می تواند یکی از دو مقدار hello یا world باشد.

هرکدام از مقادیر یک عدد در محدوده ی `-128 ... 127` برتی `Enum8` و در محدوده ی `-32768 ... 32767` برای `Enum16` می باشد. تمام رشته ها و اعداد باید متفاوت باشند. رشته ی خالی مجاز است. اگر این type مشخص شده باشد (در تعریف جدول)، اعداد می توانند به صورت دلخواه مرتب شوند. با این حال، ترتیب در اینجا مهم نیست.

در RAM، این type مشابه `Int8` یا `Int16` ذخیره می شود. هنگام خواندن در فرم متنی، ClickHouse مقدار را به صورت String پارس می کند و رشته ی مربوطه را در مقادیر Enum جستجو می کند. اگر رشته را پیدا کند یک expection پرتاب می شود. در هنگام خواندن در فرمت text، رشته خواند می شود و مقدار عددی مربوطه مورد بررسی قرار می گیرد. اگر مقدار پیدا نشود expection پرتاب می شود. هنگام نوشتن، مقدار با رشته ی مربوط نوشته می شود. اگر داده ی ستون دارای garbage باشد، (اعدادی که از مجموعه ی معتبرنیستند)، یک expection پرتاب می شود. هنگام خواندن و نوشتن به صورت باینری، این type شبیه به Int8 و Int16 کار می کند. The implicit default value is the value with the lowest number.

در حین `ORDER BY`, `GROUP BY`, `IN`, `DISTINCT` و...، این type رفتاری مشابه با اعداد دارد. برای مثال ORDER BY به صورت عددی اینها رو مرتب می کند.اپراتور های مقایسه ای و مساوی عمل مشابهی در Enums دارند.
در حین `ORDER BY`, `GROUP BY`, `IN`, `DISTINCT` و، این type رفتاری مشابه با اعداد دارد. برای مثال ORDER BY به صورت عددی اینها رو مرتب می کند.اپراتور های مقایسه ای و مساوی عمل مشابهی در Enums دارند.

مقادیر Enum نمیتوانند با اعداد مقایسه شوند. مقادیر Enum را می توان با رشته ی ثابت مقایسه کرد. اگر رشته ی مقایسه، مقدار معتبری برای مقایس به Enum نداشته باشد، یک expetion رخ می دهد. اپراتور IN در Enum پشتیبانی می شود؛ به این صورت که ستون enum در سمت چپ و مجموعه از رشته ها در سمت راست قرار می گیرند. رشته ها مقادیر مربوط به Enum هستند.

Expand All @@ -31,4 +29,5 @@ Enum8('hello' = 1, 'world' = 2)
استفاده از ALTER برای تبدیل Enum8 به Enum16 یا برعکس، ممکن است، دقیقا شبیه به Int8 به Int16.

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/enum/) <!--hide-->
5 changes: 3 additions & 2 deletions docs/fa/data_types/fixedstring.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# FixedString(N)
# FixedString(N) {#fixedstringn}

یک رشته با طول ثابت N بایت (fixed-length) (نه تعداد کاراکتر یا code point). N باید یک عدد طبیعی مثبت باشد. هنگامی که سرور رشته ای با اندازه ی کمتر از N میخواند (مثل زمان پارس کردن برای INSERT داده ها)، سمت راست رشته به اندازه فضای خالی باقی مانده به بایت، null درج می شود. زمانی که سرور رشته ای بزرگتر از N میخواند، پیغام خطا بر میگردد. زمانی که سرور یک رشته با طول ثابت را می نویسد (مثلا در زمانی که خروجی یک SELECT را برمیگرداند)، بایت های null از انتهای رشته حذف نمی شوند، و در خروجی می آیند. توجه داشته باشید که این رفتار متفاوت از رفتار MySQL برای Char می باشد (زمانی که رشته با space پر می شود و در خروجی space ها حذف می شود).

توابع کمتری نسبت به String برای FixedString(N) وجود دارد، و برای استفاده کمتر مناسب است.

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/fixedstring/) <!--hide-->
58 changes: 25 additions & 33 deletions docs/fa/data_types/float.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# Float32, Float64
# Float32, Float64 {#float32-float64}

[اعداد Float](https://en.wikipedia.org/wiki/IEEE_754).

Expand All @@ -11,7 +11,7 @@ Type های float در ClickHouse مشابه C می باشد:

توصیه می کنیم که داده ها را هرزمان که امکان پذیره است به جای float به صورت int ذخیره کنید. برای مثال: تبدیل دقت اعداد به یک مقدار int، مثل سرعت page load در قالب میلی ثانیه.

## استفاده از اعداد Float
## استفاده از اعداد Float {#stfdh-z-dd-float}

- محاسبات با اعداد با Float ممکن است خطای round شدن را ایجاد کنند.

Expand All @@ -20,19 +20,18 @@ Type های float در ClickHouse مشابه C می باشد:
``` sql
SELECT 1 - 0.9
```
```
┌───────minus(1, 0.9)─┐
│ 0.09999999999999998 │
└─────────────────────┘
```

<div dir="rtl" markdown="1">
┌───────minus(1, 0.9)─┐
│ 0.09999999999999998 │
└─────────────────────┘

<div markdown="1" dir="rtl">

- نتایج محاسبات بسته به متد محاسباتی می باشد (نوع processor و معماری سیستم).
- محاسبات Float ممکن اسن نتایجی مثل infinity (`inf`) و "Not-a-number" (`Nan`) داشته باشد. این در هنگام پردازش نتایج محاسبات باید مورد توجه قرار گیرد.
- محاسبات Float ممکن اسن نتایجی مثل infinity (`inf`) و «Not-a-number» (`Nan`) داشته باشد. این در هنگام پردازش نتایج محاسبات باید مورد توجه قرار گیرد.
- هنگام خواندن اعداد float از سطر ها، نتایج ممکن است نزدیک به اعداد machine-representable نباشد.

## NaN و Inf {#data_type-float-nan-inf}
## NaN و Inf {#data-type-float-nan-inf}

در مقابل استاندارد SQL، ClickHouse از موارد زیر مربوط به اعداد float پشتیبانی می کند:

Expand All @@ -44,13 +43,11 @@ SELECT 1 - 0.9
SELECT 0.5 / 0
```

```
┌─divide(0.5, 0)─┐
│ inf │
└────────────────┘
```
┌─divide(0.5, 0)─┐
│ inf │
└────────────────┘

<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

- `-Inf` – Negative infinity.

Expand All @@ -60,31 +57,26 @@ SELECT 0.5 / 0
SELECT -0.5 / 0
```

```
┌─divide(-0.5, 0)─┐
│ -inf │
└─────────────────┘
```
┌─divide(-0.5, 0)─┐
│ -inf │
└─────────────────┘

<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

- `NaN` – Not a number.

</div>

```
SELECT 0 / 0
```
SELECT 0 / 0

```
┌─divide(0, 0)─┐
│ nan │
└──────────────┘
```
┌─divide(0, 0)─┐
│ nan │
└──────────────┘

<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

قوانین مربوط به مرتب سازی ` Nan ` را در بخش [ORDER BY clause](../query_language/select.md) ببینید.
قوانین مربوط به مرتب سازی `Nan` را در بخش [ORDER BY clause](../query_language/select.md) ببینید.

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/float/) <!--hide-->
4 changes: 2 additions & 2 deletions docs/fa/data_types/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# Data types {#data_types}
# Data types {#data-types}

ClickHouse قابلیت ذخیره سازی انواع type های مختلف برای ذخیره داده ها در جداول را دارا می باشد.

Expand Down
26 changes: 13 additions & 13 deletions docs/fa/data_types/int_uint.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64
# UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64 {#uint8-uint16-uint32-uint64-int8-int16-int32-int64}

اعداد با طول مشخص (Fixed-length) با یا بدون sign

## محدوده ی Int {#mhdwdh-y-int}

## محدوده ی Int
- Int8 - \[-128 : 127\]
- Int16 - \[-32768 : 32767\]
- Int32 - \[-2147483648 : 2147483647\]
- Int64 - \[-9223372036854775808 : 9223372036854775807\]

- Int8 - [-128 : 127]
- Int16 - [-32768 : 32767]
- Int32 - [-2147483648 : 2147483647]
- Int64 - [-9223372036854775808 : 9223372036854775807]
## محدوده ی Uint {#mhdwdh-y-uint}

## محدوده ی Uint

- UInt8 - [0 : 255]
- UInt16 - [0 : 65535]
- UInt32 - [0 : 4294967295]
- UInt64 - [0 : 18446744073709551615]
- UInt8 - \[0 : 255\]
- UInt16 - \[0 : 65535\]
- UInt32 - \[0 : 4294967295\]
- UInt64 - \[0 : 18446744073709551615\]

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/int_uint/) <!--hide-->
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# AggregateFunction(name, types_of_arguments...)
# AggregateFunction(name, types\_of\_arguments…) {#aggregatefunctionname-types-of-arguments}

حالت متوسط از توابع aggregate. برای دریافت آن، از توابع aggregate به همراه پسوند '-State' استفاده کنید. برای اطلاعات بیشتر قسمت "AggregatingMergeTree" را ببینید.
حالت متوسط از توابع aggregate. برای دریافت آن، از توابع aggregate به همراه پسوند -State استفاده کنید. برای اطلاعات بیشتر قسمت «AggregatingMergeTree» را ببینید.

</div>

[مقاله اصلی](https://clickhouse.tech/docs/fa/data_types/nested_data_structures/aggregatefunction/) <!--hide-->
4 changes: 2 additions & 2 deletions docs/fa/data_types/nested_data_structures/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div dir="rtl" markdown="1">
<div markdown="1" dir="rtl">

# Nested data structures
# Nested data structures {#nested-data-structures}

</div>

Expand Down