Docs on VIEWs #3286

jepett0 · 2024-03-29T09:04:14Z

YDBDOCS-142

Docs in both English and Russian on:

CREATE VIEW
ALTER VIEW
DROP VIEW

commands and on the:

View concept in general, which specifies some limitations that the current implementation has.

github-actions · 2024-04-02T15:17:07Z

✅ Documentation build

Revision built successfully
Revision preview link

ydb/docs/en/core/concepts/datamodel/_includes/index.md

ydb/docs/en/core/concepts/datamodel/toc_i.yaml

ydb/docs/en/core/concepts/datamodel/view.md

ydb/docs/en/core/yql/reference/yql-core/syntax/drop_view.md

ydb/docs/en/core/yql/reference/yql-core/syntax/toc_i.yaml

ydb/docs/ru/core/yql/reference/yql-core/syntax/toc_i.yaml

github-actions · 2024-04-11T13:11:27Z

✅ Documentation build

Revision built successfully
Revision preview link

ydb/docs/en/core/concepts/datamodel/view.md

blinkov · 2024-04-23T10:25:30Z

ydb/docs/en/core/concepts/datamodel/view.md

+### Problem statement
+
+Imagine the following situation.
+
+Alice continuously executes the following query:


Suggested change

### Problem statement

Imagine the following situation.

Alice continuously executes the following query:

### Problem example

Let's consider the following situation. Alice repeatedly executes the following query:

It seems to me that "Problem example" is an uncommon phrase in English. I would change that to "Example of the problem".

I applied the rest of the suggestion without any changes.

blinkov · 2024-04-23T10:34:11Z

ydb/docs/en/core/concepts/datamodel/view.md

+```
+compilation results will be cached on the {{ ydb-short-name }} server side, and you will not notice any difference in the performance of queries using views and direct queries.
+
+## View redefinition lag


Suggested change

## View redefinition lag

## View redefinition lag

{% note warning %}

Query plans containing view definitions are currently cached. It might lead to the usage of an old query for a short while after a given view has been re-defined. This is going to be fixed in future releases. See below for a more detailed explanation.

{% endnote %}

I would like to change "query plans containing view definitions" to "execution plans of queries containing views" to emphasize the fact that there are no view definitions in the execution plans. Reads from views are rewritten to reads from underlying tables during the query execution plan preparation.

And I changed "re-defined" to just "redefined", because it seems that it is more frequent.

ydb/docs/en/core/yql/reference/yql-core/syntax/alter-view.md

blinkov · 2024-04-23T10:50:19Z

ydb/docs/ru/core/concepts/datamodel/view.md

@@ -0,0 +1,78 @@
+# Представления (VIEWs)
+
+Представление - это способ сохранить запрос и обращаться к его результатам как к настоящей таблице. Само представление не хранит данных, кроме текста запроса. Запрос, хранящийся в представлении, выполняется при каждом чтении из него, генерируя возвращаемый результат. Любые изменения в таблицах, на которые ссылается представление, немедленно отражаются в результатах чтения из него.


а тут нет той же проблемы, как и при изменении текста запроса, что новые колонки прорастут только когда кеш скомпилированного запроса не обновится? а не «немедленно» после ALTER?

Думаю, что нет, не должно быть задержки обновления схемы после ALTER'а колонок таблицы при чтении из VIEW. Дело в том, что в кеше записаны версии схем таблиц, участвующих в запросе. Если хоть одна версия отличается от той, которую сам про себя знает DataShard, то запрос перекомпилируется.

ydb/docs/ru/core/concepts/datamodel/view.md

blinkov · 2024-04-23T10:52:26Z

ydb/docs/ru/core/concepts/datamodel/view.md

+{% endnote %}
+
+## Инвалидация представления
+


досыпать warning в начало как в английской версии

blinkov · 2024-04-23T10:53:36Z

ydb/docs/ru/core/concepts/datamodel/view.md

+
+Представьте себе следующую ситуацию.
+
+Алёна постоянно выполняет следующий запрос:


а это общепринятый перевод Alice/Bob? что-то не припомню чтобы такое где-то видел

Нет, это моя фантазия. Честно говоря, не припомню, чтобы в русских примерах использовались какие-то общепринятые имена. На Википедии пишут, что иногда используются Петя и Вася, но если уж менять (я пока что не менял), то я бы выбрал Алису и Боба

lgtm

fomichev3000

В целом норм, я про какие-то вещи, которые резанули глаз написал. Я бы поправил

fomichev3000 · 2024-05-22T06:34:37Z

ydb/docs/ru/core/concepts/datamodel/view.md

+
+### Кэш результатов компиляции
+
+{{ ydb-short-name }} кэширует результаты компиляции запросов на стороне сервера для большей скорости их выполнения. Для лёгких запросов вида `SELECT 1;` компиляция может длится в 100 раз дольше времени исполнения.


Я бы избегал фраз вида "компиляция может длится в 100 раз дольше времени исполнения". Напишите просто "компиляция может занимать значительное время по сравнению с временем выполнения запроса"

fomichev3000 · 2024-05-22T06:36:23Z

ydb/docs/ru/core/yql/reference/yql-core/syntax/create-view.md

@@ -0,0 +1,79 @@
+# CREATE VIEW
+
+`CREATE VIEW` создаёт представление.


нужна ссылка на концепции, где описано представление

fomichev3000 · 2024-05-22T06:40:43Z

ydb/docs/ru/core/yql/reference/yql-core/syntax/alter-view.md

+DROP VIEW redefined_view;
+CREATE VIEW redefined_view ...;
+```
+Но этот запрос не будет атомарным.


я бы написал, что эффект от каждого стейтмента будет видим пользователю. То есть сначала вью пропадет, а потом появится. Но это все минорно...

- VIEW concept page - CREATE VIEW - ALTER VIEW - DROP VIEW

github-actions · 2024-05-22T08:28:22Z

✅ Documentation build

Revision built successfully
Revision preview link

ydb-platform deleted a comment from github-actions bot Mar 29, 2024

jepett0 force-pushed the VIEWs.docs.1 branch from 469d61a to 34a1cf1 Compare April 2, 2024 10:21

ydb-platform deleted a comment from github-actions bot Apr 2, 2024

jepett0 force-pushed the VIEWs.docs.1 branch from bd41528 to aeaa828 Compare April 2, 2024 15:11

ydb-platform deleted a comment from github-actions bot Apr 2, 2024

jepett0 marked this pull request as ready for review April 2, 2024 15:24

jepett0 requested a review from a team as a code owner April 2, 2024 15:24

blinkov requested changes Apr 5, 2024

View reviewed changes

jepett0 force-pushed the VIEWs.docs.1 branch from aeaa828 to 4339d5f Compare April 11, 2024 10:40

This comment was marked as outdated.

Sign in to view

jepett0 force-pushed the VIEWs.docs.1 branch from 4339d5f to dc774e5 Compare April 11, 2024 11:09

This comment was marked as outdated.

Sign in to view

jepett0 force-pushed the VIEWs.docs.1 branch from 0819788 to 41665f6 Compare April 11, 2024 12:56

This comment was marked as outdated.

Sign in to view

jepett0 requested a review from blinkov April 11, 2024 13:50

blinkov previously requested changes Apr 23, 2024

View reviewed changes

jepett0 force-pushed the VIEWs.docs.1 branch from 3c1968a to d053007 Compare May 20, 2024 12:48

jepett0 requested a review from a team as a code owner May 20, 2024 12:48

jepett0 force-pushed the VIEWs.docs.1 branch from d053007 to f5b4b74 Compare May 20, 2024 12:50

jepett0 removed the request for review from a team May 20, 2024 12:51

jepett0 requested a review from blinkov May 20, 2024 16:58

fomichev3000 previously approved these changes May 22, 2024

View reviewed changes

jepett0 and others added 4 commits May 22, 2024 07:00

Docs on VIEWs

c696bb5

- VIEW concept page - CREATE VIEW - ALTER VIEW - DROP VIEW

Review fixes, iteration 1

36b0ff4

Review fixes, iteration 2

fa0e67d

Review fixes, iteration 3

40706cd

jepett0 dismissed fomichev3000’s stale review via 40706cd May 22, 2024 08:04

jepett0 force-pushed the VIEWs.docs.1 branch from 7f99a54 to 40706cd Compare May 22, 2024 08:04

fix the build

80e5e94

ydb-platform deleted a comment from github-actions bot May 22, 2024

blinkov enabled auto-merge (squash) May 22, 2024 09:01

blinkov approved these changes May 22, 2024

View reviewed changes

blinkov merged commit d3ca6fe into ydb-platform:main May 22, 2024
2 checks passed

serbel324 mentioned this pull request May 24, 2024

Add description of new ICB controls for CMS #4818

Merged

This was referenced May 27, 2024

Cli changes for autoscaling #4871

Closed

Fix getting mid of range for autoscaling #4884

Closed

Fix getting mid range #4885

Merged

MrLolthe1st pushed a commit to MrLolthe1st/ydb that referenced this pull request May 28, 2024

Docs on VIEWs (ydb-platform#3286)

1014d65

niksaveliev mentioned this pull request May 29, 2024

Autoscaling logs #4976

Merged

This was referenced May 29, 2024

YQ-3292 fixed kqprun ResourceBrokerConfig passing #4994

Merged

Added ExecutionId for script execution logs #5014

Merged

This was referenced May 30, 2024

Forbid autoscaling with size retention #5054

Merged

Mute split by load ut #5264

Closed

Mute split by load ut #5267

Closed

Mute split by load ut #5272

Merged

This was referenced Jun 7, 2024

Fix build #5310

Merged

Fix split by load ut #5383

Merged

niksaveliev mentioned this pull request Jun 17, 2024

Fix win build #5622

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Docs on VIEWs #3286

Docs on VIEWs #3286

jepett0 commented Mar 29, 2024 •

edited

Loading

github-actions bot commented Apr 2, 2024

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

github-actions bot commented Apr 11, 2024

blinkov Apr 23, 2024

jepett0 May 20, 2024 •

edited

Loading

blinkov Apr 23, 2024

jepett0 May 20, 2024 •

edited

Loading

blinkov Apr 23, 2024

jepett0 May 20, 2024 •

edited

Loading

blinkov Apr 23, 2024

blinkov Apr 23, 2024

jepett0 May 20, 2024 •

edited

Loading

fomichev3000 left a comment

fomichev3000 May 22, 2024

fomichev3000 May 22, 2024

fomichev3000 May 22, 2024

github-actions bot commented May 22, 2024

		@@ -0,0 +1,78 @@
		# Представления (VIEWs)

		Представление - это способ сохранить запрос и обращаться к его результатам как к настоящей таблице. Само представление не хранит данных, кроме текста запроса. Запрос, хранящийся в представлении, выполняется при каждом чтении из него, генерируя возвращаемый результат. Любые изменения в таблицах, на которые ссылается представление, немедленно отражаются в результатах чтения из него.

		{% endnote %}

		## Инвалидация представления


		Представьте себе следующую ситуацию.

		Алёна постоянно выполняет следующий запрос:


		### Кэш результатов компиляции

		{{ ydb-short-name }} кэширует результаты компиляции запросов на стороне сервера для большей скорости их выполнения. Для лёгких запросов вида `SELECT 1;` компиляция может длится в 100 раз дольше времени исполнения.

		@@ -0,0 +1,79 @@
		# CREATE VIEW

		`CREATE VIEW` создаёт представление.

Docs on VIEWs #3286

Docs on VIEWs #3286

Conversation

jepett0 commented Mar 29, 2024 • edited Loading

github-actions bot commented Apr 2, 2024

✅ Documentation build

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

github-actions bot commented Apr 11, 2024

✅ Documentation build

Choose a reason for hiding this comment

jepett0 May 20, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jepett0 May 20, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jepett0 May 20, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jepett0 May 20, 2024 • edited Loading

Choose a reason for hiding this comment

fomichev3000 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

github-actions bot commented May 22, 2024

✅ Documentation build

jepett0 commented Mar 29, 2024 •

edited

Loading

jepett0 May 20, 2024 •

edited

Loading

jepett0 May 20, 2024 •

edited

Loading

jepett0 May 20, 2024 •

edited

Loading

jepett0 May 20, 2024 •

edited

Loading