Skip to content

Commit 4f710bb

Browse files
author
vlad-gogov
committed
test ru version
1 parent ef743dd commit 4f710bb

File tree

5 files changed

+74
-24
lines changed

5 files changed

+74
-24
lines changed

‎ydb/docs/ru/core/_includes/not_allow_for_olap_text.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Поддерживается только для [строковых](../concepts/datamodel/table.md#strokovye-tablicy) таблиц. Поддержка функциональности для [колоночных](../concepts/datamodel/table.md#column-tables) таблиц находится в разработке.
1+
Поддерживается только для [строковых](../concepts/datamodel/table.md#row-oriented-tables) таблиц. Поддержка функциональности для [колоночных](../concepts/datamodel/table.md#column-oriented-tables) таблиц находится в разработке.

‎ydb/docs/ru/core/concepts/datamodel/_includes/table.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -221,6 +221,7 @@ CREATE TABLE article (
221221
+ Доступно и в первичном ключе и в остальных колонках: `Date`, `Datetime`, `Timestamp`, `Int32`, `Int64`, `Uint8`, `Uint16`, `Uint32`, `Uint64`, `Utf8`, `String`;
222222
+ Доступно только в колонках, не входящих в первичный ключ: `Bool`, `Decimal`, `Double`, `Float`, `Int8`, `Int16`, `Interval`, `JsonDocument`, `Json`, `Uuid`, `Yson`.
223223

224+
* В колоночных таблицах поддерживаются группы колонок, но пока только используется для задания сжатия на колонках.
224225

225226
Повторим создание таблицы `article`, на этот раз в колоночной форме, с помощью следующей YQL-команды:
226227

‎ydb/docs/ru/core/yql/reference/yql-core/syntax/alter_table/family.md‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,12 +39,24 @@ ALTER TABLE series_with_families
3939
ALTER COLUMN release_date SET FAMILY family_small;
4040
```
4141

42-
При помощи команды `ALTER FAMILY` можно изменить параметры группы колонок. Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит тип хранилища на `hdd`:
42+
При помощи команды `ALTER FAMILY` можно изменить параметры группы колонок. Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит тип хранилища на `hdd` (поддерживается только для [строковых](../../../../concepts/datamodel/table.md#row-oriented-tables) таблиц.):
4343

4444
```yql
4545
ALTER TABLE series_with_families ALTER FAMILY default SET DATA "hdd";
4646
```
4747

48+
Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит кодек сжатия на `lz4`:
49+
50+
```yql
51+
ALTER TABLE series_with_families ALTER FAMILY default SET COMPRESSION "lz4";
52+
```
53+
54+
Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит уровень сжатия кодека, если он поддерживает различные уровни сжатия (поддерживается только для [колоночных](../../../../concepts/datamodel/table.md#column-oriented-tables) таблиц):
55+
56+
```yql
57+
ALTER TABLE series_with_families ALTER FAMILY default SET COMPRESSION_LEVEL 5;
58+
```
59+
4860
{% note info %}
4961

5062
Доступные типы устройств хранения зависят от конфигурации кластера {{ ydb-short-name }}.

‎ydb/docs/ru/core/yql/reference/yql-core/syntax/create_table/family.md‎

Lines changed: 55 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,36 +2,70 @@
22

33
{% if oss == true and backend_name == "YDB" %}
44

5-
{% include [not_allow_for_olap](../../../../_includes/not_allow_for_olap_note.md) %}
5+
{% note alert %}
6+
7+
Поле `DATA` поддерживается только для [строковых](../../../../concepts/datamodel/table.md#row-oriented-tables) таблиц.
8+
9+
Поле `COMPRESSION_LEVEL` поддерживается только для [колоночных](../../../../concepts/datamodel/table.md#column-oriented-tables) таблиц.
10+
11+
{% endnote %}
612

713
{% endif %}
814

915
Колонки одной таблицы можно объединять в группы, для того чтобы задать следующие параметры:
1016

1117
* `DATA` — тип устройства хранения для данных колонок этой группы. Допустимые значения: `"ssd"`, `"rot"`.
12-
* `COMPRESSION` — кодек сжатия данных. Допустимые значения: `"off"`, `"lz4"`.
18+
* `COMPRESSION` — кодек сжатия данных. Допустимые значения: `"off"`, `"lz4"`, `"zstd"` (только для [колоночных](../../../../concepts/datamodel/table.md#column-oriented-tables) таблиц).
19+
* `COMPRESSION_LEVEL` — уровень сжатия кодека, если кодек поддерживает уровень сжатия.
1320

1421
По умолчанию все колонки находятся в одной группе с именем `default`. При желании, параметры этой группы тоже можно переопределить.
1522

16-
В примере ниже для создаваемой таблицы добавляется группа колонок `family_large` и устанавливается для колонки `series_info`, а также переопределяются параметры для группы `default`, которая по умолчанию установлена для всех остальных колонок.
17-
18-
```yql
19-
CREATE TABLE series_with_families (
20-
series_id Uint64,
21-
title Utf8,
22-
series_info Utf8 FAMILY family_large,
23-
release_date Uint64,
24-
PRIMARY KEY (series_id),
25-
FAMILY default (
26-
DATA = "ssd",
27-
COMPRESSION = "off"
28-
),
29-
FAMILY family_large (
30-
DATA = "rot",
31-
COMPRESSION = "lz4"
32-
)
33-
);
34-
```
23+
В примерах ниже для создаваемых таблиц добавляется группа колонок `family_large` и устанавливается для колонки `series_info`, а также переопределяются параметры для группы `default`, которая по умолчанию установлена для всех остальных колонок.
24+
25+
26+
{% list tabs %}
27+
28+
- Создание строковой таблицы
29+
30+
```sql
31+
CREATE TABLE series_with_families (
32+
series_id Uint64,
33+
title Utf8,
34+
series_info Utf8 FAMILY family_large,
35+
release_date Uint64,
36+
PRIMARY KEY (series_id),
37+
FAMILY default (
38+
DATA = "ssd",
39+
COMPRESSION = "off"
40+
),
41+
FAMILY family_large (
42+
DATA = "rot",
43+
COMPRESSION = "lz4"
44+
)
45+
);
46+
```
47+
48+
- Создание колоночной таблицы
49+
50+
```sql
51+
CREATE TABLE series_with_families (
52+
series_id Uint64,
53+
title Utf8,
54+
series_info Utf8 FAMILY family_large,
55+
release_date Uint64,
56+
PRIMARY KEY (series_id),
57+
FAMILY default (
58+
COMPRESSION = "lz4"
59+
),
60+
FAMILY family_large (
61+
COMPRESSION = "zstd",
62+
COMPRESSION_LEVEL = 5
63+
)
64+
)
65+
WITH (STORE = COLUMN);
66+
```
67+
68+
{% endlist %}
3569

3670
{% note info %}
3771

‎ydb/docs/ru/core/yql/reference/yql-core/syntax/create_table/index.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -246,6 +246,9 @@ CREATE TABLE <table_name> (
246246
* [Группы колонок](family.md).
247247
* [Дополнительные параметры](with.md).
248248

249-
Для колоночных таблиц при их создании возможно задать только [дополнительные параметры](with.md).
249+
Для колоночных таблиц при их создании возможно задать:
250+
251+
* [Группы колонок](family.md).
252+
* [Дополнительные параметры](with.md).
250253

251254
{% endif %}

0 commit comments

Comments
 (0)