Skip to content

Commit 3b16a01

Browse files
vlad-gogovvlad-gogov
authored
Merge 30435bc into de64fff 
2 parents de64fff + 30435bc commit 3b16a01

File tree

12 files changed

+141
-35
lines changed

12 files changed

+141
-35
lines changed

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

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{% note alert %}
2+
3+
{% include [codec_zstd_allow_for_olap_text](codec_zstd_allow_for_olap_text.md) %}
4+
5+
{% endnote %}

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Кодек `"zstd"` поддерживается только для [колоночных](../concepts/datamodel/table.md#column-oriented-tables) таблиц.

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
{% note alert %}
22

3+
{% include [only_allow_for_oltp_text](only_allow_for_oltp_text.md) %}
4+
35
{% include [not_allow_for_olap_text](not_allow_for_olap_text.md) %}
46

57
{% endnote %}

‎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/_includes/only_allow_for_olap_note.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{% if oss == true and backend_name == "YDB" %}
2+
3+
{% note alert %}
4+
5+
{% include [only_allow_for_olap_text](only_allow_for_olap_text.md) %}
6+
7+
{% endnote %}
8+
9+
{% endif %}

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

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

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

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{% if oss == true and backend_name == "YDB" %}
2+
3+
{% note alert %}
4+
5+
{% include [only_allow_for_oltp_text](only_allow_for_oltp_text.md) %}
6+
7+
{% endnote %}
8+
9+
{% endif %}

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Поддерживается только для [строковых](../concepts/datamodel/table.md#row-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: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,5 @@
11
# Создание и изменение групп колонок
22

3-
{% if oss == true and backend_name == "YDB" %}
4-
5-
{% include [OLAP_not_allow_note](../../../../_includes/not_allow_for_olap_note.md) %}
6-
7-
{% endif %}
8-
93
Механизм {% if oss == true and backend_name == "YDB" %}[групп](../../../../concepts/datamodel/table.md#column-groups){% else %}групп{% endif %} колонок позволяет увеличить производительность операций неполного чтения строк путем разделения хранения колонок строковой таблицы на несколько групп. Наиболее часто используемый сценарий — организация хранения редко используемых атрибутов в отдельной группе колонок.
104

115

@@ -39,12 +33,50 @@ ALTER TABLE series_with_families
3933
ALTER COLUMN release_date SET FAMILY family_small;
4034
```
4135

42-
При помощи команды `ALTER FAMILY` можно изменить параметры группы колонок. Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит тип хранилища на `hdd`:
36+
При помощи команды `ALTER FAMILY` можно изменить параметры группы колонок.
37+
38+
### Изменение типа хранилища
39+
40+
{% if oss == true and backend_name == "YDB" %}
41+
42+
{% include [OLTP_only_allow_note](../../../../_includes/only_allow_for_oltp_note.md) %}
43+
44+
{% endif %}
45+
46+
Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит тип хранилища на `hdd`:
4347

4448
```yql
4549
ALTER TABLE series_with_families ALTER FAMILY default SET DATA "hdd";
4650
```
4751

52+
### Изменение кодека сжатия
53+
54+
{% if oss == true and backend_name == "YDB" %}
55+
56+
{% include [codec_zstd_allow_for_olap_note](../../../../_includes/codec_zstd_allow_for_olap_note.md) %}
57+
58+
{% endif %}
59+
60+
Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит кодек сжатия на `lz4`:
61+
62+
```yql
63+
ALTER TABLE series_with_families ALTER FAMILY default SET COMPRESSION "lz4";
64+
```
65+
66+
### Изменение уровня кодека сжатия
67+
68+
{% if oss == true and backend_name == "YDB" %}
69+
70+
{% include [OLAP_only_allow_note](../../../../_includes/only_allow_for_olap_note.md) %}
71+
72+
{% endif %}
73+
74+
Приведенный ниже код для группы колонок `default` в таблице `series_with_families` сменит уровень кодека сжатия, если он поддерживает различные уровни сжатия:
75+
76+
```yql
77+
ALTER TABLE series_with_families ALTER FAMILY default SET COMPRESSION_LEVEL 5;
78+
```
79+
4880
{% note info %}
4981

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

0 commit comments

Comments
 (0)