Skip to content

Commit 57d8830

Browse files
Fix yql doc (#9007)
Co-authored-by: Ivan Blinkov <ivan@ydb.tech>
1 parent 0cd4902 commit 57d8830

File tree

17 files changed

+36
-47
lines changed

17 files changed

+36
-47
lines changed

ydb/docs/ru/core/concepts/glossary.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@
101101

102102
{% if oss == "true" %}
103103

104-
Реализация распределённых транзакций рассмотрена в отдельной статье [{#T}](../contributor/datashard-distributed-txs.md), а ниже приведён список нескольких [связанных терминов](#distributed-transactions-implementation).
104+
Реализация распределённых транзакций рассмотрена в отдельной статье [{#T}](../contributor/datashard-distributed-txs.md), а ниже приведён список нескольких [связанных терминов](#distributed-transaction-implementation).
105105

106106
{% endif %}
107107

@@ -194,10 +194,10 @@
194194

195195
**Поток изменений** — упорядоченный список изменений [таблицы](#table), помещенный в [топик](#topic).
196196

197-
### Экземпляр асинхронной репликации {#async-replication-instance}
198-
199197
{% if feature_async_replication == true %}
200198

199+
### Экземпляр асинхронной репликации {#async-replication-instance}
200+
201201
**Экземпляр асинхронной репликации** — это именованная сущность, хранящая настройки [асинхронной репликации](async-replication.md) (настройки подключения, список реплицируемых объектов и т.д.). Также с его помощью можно получить информацию о состоянии асинхронной репликации: [прогресс первоначального сканирования](async-replication.md#initial-scan), [отставание](async-replication.md#replication-of-changes), [ошибки](async-replication.md#error-handling) и т.д.
202202

203203
{% endif %}

ydb/docs/ru/core/postgresql/import.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,18 @@
44

55
- С помощью [pg-dump](#pg-dump).
66
- С помощью импорта данных [из файлов](#file-import).
7+
8+
{% if oss == true %}
9+
710
- С помощью утилиты [ydb-importer](../integrations/ingestion/import-jdbc.md).
811

12+
{% endif %}
13+
914
|Способ импорта|Способ работы|Сценарии использования|
1015
|--------------|------------------|------------|
1116
|[pg-dump](#pg-dump)|Создание всей необходимой структуры таблиц и данных|Импорт баз данных PostgreSQL целиком|
12-
|Импорт данных [из файлов](../reference/ydb-cli/export-import/import-file.md)|Импорт файлов с данными в заранее созданные таблицы базы данных {{ ydb-name }}|Импорт данных из баз данных Greenplum или любых других баз данных со сменой структуры хранения данных|
13-
|[ydb-importer](../integrations/ingestion/import-jdbc.md)|Импорт данных из другой базы данных в заранее созданные таблицы базы данных {{ ydb-name }}|Импорт данных из любых баз данных, поддерживающих [JDBC-протокол](https://ru.wikipedia.org/wiki/Java_Database_Connectivity)|
14-
17+
|Импорт данных [из файлов](../reference/ydb-cli/export-import/import-file.md)|Импорт файлов с данными в заранее созданные таблицы базы данных {{ydb-name}}|Импорт данных из баз данных Greenplum или любых других баз данных со сменой структуры хранения данных|{% if oss == true %}
18+
|[ydb-importer](../integrations/ingestion/import-jdbc.md)|Импорт данных из другой базы данных в заранее созданные таблицы базы данных {{ydb-name}}|Импорт данных из любых баз данных, поддерживающих [JDBC-протокол](https://ru.wikipedia.org/wiki/Java_Database_Connectivity)|{% endif %}
1519

1620
## pg-dump {#pg-dump}
1721

ydb/docs/ru/core/yql/reference/_includes/index/intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
*YQL* ({{ ydb-short-name }} Query Language) — универсальный декларативный язык запросов к YDB, диалект SQL. YQL создавался для работы с большими распределенными базами данных, и поэтому обладает рядом отличий от стандарта SQL.
44

5-
{% if backend_name == "YDB" %}
5+
{% if oss == true and backend_name == "YDB" %}
66

77
Инструменты работы с {{ ydb-short-name }} поддерживают интерфейсы отправки YQL-запросов и получения результатов их исполнения:
88

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/insert_into.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
{% endif %}
1414

1515
{% if select_command != "SELECT STREAM" %}
16-
Добавляет строки в {% if backend_name == "YDB" %}строковую{% endif %} таблицу. {% if feature_bulk_tables %} Если целевая таблица уже существует и не является сортированной, операция `INSERT INTO` дописывает строки в конец таблицы. В случае сортированной таблицы, YQL пытается сохранить сортированность путем запуска сортированного слияния. {% endif %}{% if feature_map_tables %} При попытке вставить в таблицу строку с уже существующим значением первичного ключа операция завершится ошибкой с кодом `PRECONDITION_FAILED` и текстом `Operation aborted due to constraint violation: insert_pk`.{% endif %}
16+
Добавляет строки в {% if oss == true and backend_name == "YDB" %}строковую{% endif %} таблицу. {% if feature_bulk_tables %} Если целевая таблица уже существует и не является сортированной, операция `INSERT INTO` дописывает строки в конец таблицы. В случае сортированной таблицы, YQL пытается сохранить сортированность путем запуска сортированного слияния. {% endif %}{% if feature_map_tables %} При попытке вставить в таблицу строку с уже существующим значением первичного ключа операция завершится ошибкой с кодом `PRECONDITION_FAILED` и текстом `Operation aborted due to constraint violation: insert_pk`.{% endif %}
1717

1818
{% if feature_mapreduce %}Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %}
1919

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/into_result.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# INTO RESULT
22

3-
Позволяет задать пользовательскую метку для [SELECT](../select/index.md){% if feature_mapreduce and process_command == "PROCESS" %}, [PROCESS](../process.md) или [REDUCE](../reduce.md){% endif %}.{% if backend_name != "YDB" %} Не может быть задано одновременно с [DISCARD](../discard.md).{% endif %}
3+
Позволяет задать пользовательскую метку для [SELECT](../select/index.md){% if feature_mapreduce and process_command == "PROCESS" %}, [PROCESS](../process.md) или [REDUCE](../reduce.md){% endif %}.{% if backend_name != "YDB" and oss == true %} Не может быть задано одновременно с [DISCARD](../discard.md).{% endif %}
44

55
## Примеры
66

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/replace_into.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212

1313
{% endif %}
1414

15-
В отличие от [`INSERT INTO`](../insert_into.md) и [`UPDATE`](../update.md), запросы [`UPSERT INTO`](../upsert_into.md) и `REPLACE INTO` не требуют предварительного чтения данных, поэтому выполняются быстрее. `REPLACE INTO` сохраняет данные в {% if backend_name == "YDB" %}строковую таблицу{% else %}таблицу{% endif %} с перезаписью строк по первичному ключу.{% if feature_mapreduce %} Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %} Если заданный первичный ключ отсутствует, в таблицу будет добавлена новая строка. Если задан существующий `PRIMARY_KEY`, строка будет перезаписана. При этом значения столбцов, не участвующих в операции, заменяются на значения по умолчанию.
15+
В отличие от [`INSERT INTO`](../insert_into.md) и [`UPDATE`](../update.md), запросы [`UPSERT INTO`](../upsert_into.md) и `REPLACE INTO` не требуют предварительного чтения данных, поэтому выполняются быстрее. `REPLACE INTO` сохраняет данные в {% if backend_name == "YDB" and oss == true %}строковую таблицу{% else %}таблицу{% endif %} с перезаписью строк по первичному ключу.{% if feature_mapreduce %} Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %} Если заданный первичный ключ отсутствует, в таблицу будет добавлена новая строка. Если задан существующий `PRIMARY_KEY`, строка будет перезаписана. При этом значения столбцов, не участвующих в операции, заменяются на значения по умолчанию.
1616

1717
## Примеры
1818

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

Lines changed: 8 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,8 @@
11
# Добавление или удаление потока изменений
22

3-
{% if oss == true and backend_name == "YDB" %}
4-
53
{% include [OLAP_not_allow_note](../../../../_includes/not_allow_for_olap_note.md) %}
64

7-
{% endif %}
8-
9-
`ADD CHANGEFEED <name> WITH (option = value[, ...])` — добавляет {% if oss == true and backend_name == "YDB" %}[поток изменений (changefeed)](../../../../concepts/cdc.md){% else %}поток изменений{% endif %} с указанным именем и параметрами.
5+
`ADD CHANGEFEED <name> WITH (option = value[, ...])` — добавляет [поток изменений (changefeed)](../../../../concepts/cdc.md) с указанным именем и параметрами.
106

117
## Параметры потока изменений {#changefeed-options}
128

@@ -17,19 +13,13 @@
1713
* `OLD_IMAGE` — будут записаны значения всех столбцов, предшествующие изменению.
1814
* `NEW_AND_OLD_IMAGES` - комбинация режимов `NEW_IMAGE` и `OLD_IMAGE`. Будут записаны значения всех столбцов _до_ и _в результате_ изменения.
1915
* `FORMAT` — формат данных, в котором будут записаны данные.
20-
* `JSON` — записывать данные в формате {% if oss == true and backend_name == "YDB" %}[JSON](../../../../concepts/cdc.md#json-record-structure){% else %}JSON{% endif %}.
21-
22-
{% if audience == "tech" %}
23-
24-
* `DYNAMODB_STREAMS_JSON` — записывать данные в {% if oss == true and backend_name == "YDB" %}[JSON-формате, совместимом с Amazon DynamoDB Streams](../../../../concepts/cdc#dynamodb-streams-json-record-structure){% else %}JSON-формате, совместимом с Amazon DynamoDB Streams{% endif %}.md.
25-
* `DEBEZIUM_JSON` — записывать данные в {% if oss == true and backend_name == "YDB" %}[JSON-формате, аналогичном Debezium формату](../../../../concepts/cdc.md#debezium-json-record-structure){% else %}JSON-формате, аналогичном Debezium формату{% endif %}.
26-
27-
{% endif %}
28-
29-
* `VIRTUAL_TIMESTAMPS` — включение-выключение {% if oss == true and backend_name == "YDB" %}[виртуальных меток времени](../../../../concepts/cdc.md#virtual-timestamps){% else %}виртуальных меток времени{% endif %}. По умолчанию выключено.
30-
* `RETENTION_PERIOD` — {% if oss == true and backend_name == "YDB" %}[время хранения записей](../../../../concepts/cdc.md#retention-period){% else %}время хранения записей{% endif %}. Тип значения — `Interval`, значение по умолчанию — 24 часа (`Interval('PT24H')`).
31-
* `TOPIC_MIN_ACTIVE_PARTITIONS` — {% if oss == true and backend_name == "YDB" %}[количество партиций топика](../../../../concepts/cdc.md#topic-partitions){% else %}количество партиций топика{% endif %}. По умолчанию количество партиций топика равно количеству партиций таблицы.
32-
* `INITIAL_SCAN` — включение-выключение {% if oss == true and backend_name == "YDB" %}[первоначального сканирования](../../../../concepts/cdc.md#initial-scan){% else %}первоначального сканирования{% endif %} таблицы. По умолчанию выключено.
16+
* `JSON` — записывать данные в формате [JSON](../../../../concepts/cdc.md#json-record-structure).
17+
* `DYNAMODB_STREAMS_JSON` — записывать данные в [JSON-формате, совместимом с Amazon DynamoDB Streams](../../../../concepts/cdc.md#dynamodb-streams-json-record-structure) JSON-формате, совместимом с Amazon DynamoDB Streams.
18+
* `DEBEZIUM_JSON` — записывать данные в [JSON-формате, аналогичном Debezium формату](../../../../concepts/cdc.md#debezium-json-record-structure).
19+
* `VIRTUAL_TIMESTAMPS` — включение-выключение [виртуальных меток времени](../../../../concepts/cdc.md#virtual-timestamps).
20+
* `RETENTION_PERIOD`[время хранения записей](../../../../concepts/cdc.md#retention-period). Тип значения — `Interval`, значение по умолчанию — 24 часа (`Interval('PT24H')`).
21+
* `TOPIC_MIN_ACTIVE_PARTITIONS`[количество партиций топика](../../../../concepts/cdc.md#topic-partitions). По умолчанию количество партиций топика равно количеству партиций таблицы.
22+
* `INITIAL_SCAN` — включение-выключение [первоначального сканирования](../../../../concepts/cdc.md#initial-scan) таблицы. По умолчанию выключено.
3323

3424
{% if audience == "tech" %}
3525

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Изменение состава колонок
22

3-
{{ backend_name }} поддерживает возможность добавлять столбцы в {% if backend_name == "YDB" %} строковые и колоночные таблицы{% else %} таблицы {% endif %}, а также удалять неключевые колонки из таблиц.
3+
{{ backend_name }} поддерживает возможность добавлять столбцы в {% if backend_name == "YDB" and oss == true %} строковые и колоночные таблицы{% else %} таблицы {% endif %}, а также удалять неключевые колонки из таблиц.
44

55
`ADD COLUMN` — добавляет столбец с указанными именем и типом. Приведенный ниже код добавит к таблице `episodes` столбец `views` с типом данных `Uint64`.
66

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

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,9 @@
11
# Создание и изменение групп колонок
22

3-
{% if oss == true and backend_name == "YDB" %}
4-
53
{% include [OLAP_not_allow_note](../../../../_includes/not_allow_for_olap_note.md) %}
64

7-
{% endif %}
5+
Механизм [групп](../../../../concepts/datamodel/table.md#column-groups) колонок позволяет увеличить производительность операций неполного чтения строк путем разделения хранения колонок строковой таблицы на несколько групп. Наиболее часто используемый сценарий — организация хранения редко используемых атрибутов в отдельной группе колонок.
86

9-
Механизм {% if oss == true and backend_name == "YDB" %}[групп](../../../../concepts/datamodel/table.md#column-groups){% else %}групп{% endif %} колонок позволяет увеличить производительность операций неполного чтения строк путем разделения хранения колонок строковой таблицы на несколько групп. Наиболее часто используемый сценарий — организация хранения редко используемых атрибутов в отдельной группе колонок.
107

118
## Создание группы колонок
129

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

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
# ALTER TABLE
22

3-
43
При помощи команды `ALTER TABLE` можно изменить состав колонок и дополнительные параметры {% if backend_name == "YDB" and oss == true %}[строковых](../../../../concepts/datamodel/table.md#row-tables) и [колоночных](../../../../concepts/datamodel/table.md#colums-tables) таблиц{% else %}таблиц {% endif %}. В одной команде можно указать несколько действий. В общем случае команда `ALTER TABLE` выглядит так:
54

65

0 commit comments

Comments
 (0)