From 5bd5d05b85da3c817004ca80af1116f53e12121c Mon Sep 17 00:00:00 2001
From: "a.sabirov" <a.sabirov@picodata.io>
Date: Wed, 19 Jun 2024 19:11:30 +0300
Subject: [PATCH] chore: various edits

---
 docs/reference/sql/create_procedure.md |  6 ++--
 docs/reference/sql/delete.md           |  2 +-
 docs/reference/sql/explain.md          | 13 ++++----
 docs/reference/sql/insert.md           |  1 -
 docs/reference/sql/join.md             | 41 +++++---------------------
 docs/reference/sql/select.md           |  6 +---
 6 files changed, 19 insertions(+), 50 deletions(-)

diff --git a/docs/reference/sql/create_procedure.md b/docs/reference/sql/create_procedure.md
index 71c674a0..a62325a8 100644
--- a/docs/reference/sql/create_procedure.md
+++ b/docs/reference/sql/create_procedure.md
@@ -41,7 +41,7 @@
 Процедура для добавления новых строк в таблицу `warehouse`:
 
 ```sql
-CREATE PROCEDURE proc (int, text, int)
+CREATE PROCEDURE proc (int, text, text)
 AS $$INSERT INTO warehouse VALUES($1, $2, $3)$$
 OPTION (TIMEOUT = 5.0)
 ```
@@ -49,5 +49,5 @@ OPTION (TIMEOUT = 5.0)
 где:
 
 - `proc` — название процедуры
-- `int, text, int` — типы аргументов процедуры
-- `$1, $2, $3`— позиции значений из аргументов процедуры
+- `int, text, text` — типы аргументов процедуры
+- `$1, $2, $3` — позиции значений из аргументов процедуры
diff --git a/docs/reference/sql/delete.md b/docs/reference/sql/delete.md
index 09422259..168d969e 100644
--- a/docs/reference/sql/delete.md
+++ b/docs/reference/sql/delete.md
@@ -61,4 +61,4 @@ DELETE FROM warehouse where id = 1;
 DELETE FROM warehouse WHERE id IN (1,2,3);
 ```
 
-В всех случаях в выводе в консоль будет указано количество удаленных кортежей.
+Во всех случаях в выводе в консоль будет указано количество удаленных кортежей.
diff --git a/docs/reference/sql/explain.md b/docs/reference/sql/explain.md
index 9e6c02a9..57dd8e55 100644
--- a/docs/reference/sql/explain.md
+++ b/docs/reference/sql/explain.md
@@ -90,10 +90,9 @@ WHERE amount > 1000;
 except
     projection ("ITEMS"."ID"::integer -> "ID", "ITEMS"."NAME"::string -> "NAME")
         scan "ITEMS"
-        projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM")
-            selection ROW("ORDERS"."AMOUNT"::integer) > ROW(1000::unsigned)
-                scan "ORDERS"
-
+    projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM")
+        selection ROW("ORDERS"."AMOUNT"::integer) > ROW(1000::unsigned)
+            scan "ORDERS"
 ```
 
 В таком плане запроса присутствует два блока `projection`, перед
@@ -228,14 +227,14 @@ update "WAREHOUSE"
 которой отличается ключ шардирования:
 
 ```sql
-EXPLAIN INSERT INTO orders SELECT * FROM items WHERE id = 5;
+EXPLAIN INSERT INTO orders (id, item, amount) SELECT * FROM items WHERE id = 5;
 ```
 
 Вывод в консоль:
 
 ```
 insert "ORDERS" on conflict: fail
-    motion [policy: segment([ref("NAME")])]
+    motion [policy: local segment([ref("ID")])]
         projection ("ITEMS"."ID"::integer -> "ID", "ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK")
             selection ROW("ITEMS"."ID"::integer) = ROW(5::unsigned)
                 scan "ITEMS"
@@ -256,7 +255,7 @@ ON orders.id=new_table.nmbr;
 projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM")
     join on ROW("ORDERS"."ID"::integer) = ROW("NEW_TABLE"."NMBR"::integer)
         scan "ORDERS"
-            projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT")
+            projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT", "ORDERS"."SINCE"::datetime -> "SINCE")
                 scan "ORDERS"
         motion [policy: segment([ref("NMBR")])]
             scan "NEW_TABLE"
diff --git a/docs/reference/sql/insert.md b/docs/reference/sql/insert.md
index 6359d885..ccf1f591 100644
--- a/docs/reference/sql/insert.md
+++ b/docs/reference/sql/insert.md
@@ -132,4 +132,3 @@ SQL](non_block.md). Если речь идет о запросе на встав
 в `decimal 2.5`). В параметризированном виде дробнному числу будет
 назначен типа с плавающей запятой (например, `values(?), {2.5}` в
 `double 2.5`). См. [подробнее](../sql_types.md) о типах данных.
-
diff --git a/docs/reference/sql/join.md b/docs/reference/sql/join.md
index e89c18d2..a6da07ad 100644
--- a/docs/reference/sql/join.md
+++ b/docs/reference/sql/join.md
@@ -88,7 +88,7 @@ Picodata поддерживает два типа соединения: `INNER J
 месте отсутствующих значений будет `nil`.
 
 Покажем это на примере соединения по равенству колонок для таблиц
-`items` и `orders`:
+`items` и `orders`.
 
 ??? example "Тестовые таблицы"
     Примеры использования команд включают в себя запросы к [тестовым
@@ -150,29 +150,6 @@ ON items.name = orders.item
 несколькими соединениями могут быть использованы разные комбинации
 левого и внутреннего соединения.
 
-Для примера с двумя соединениями задействуем третью тестовую таблицу.
-
-<details><summary>Содержимое таблицы</summary><p>
-
-```sql
-picodata> select * from "warehouse"
-+----+----------+---------+
-| ID | ITEM     | TYPE    |
-+=========================+
-| 1  | "bricks" | "heavy" |
-|----+----------+---------|
-| 2  | "bars"   | "light" |
-|----+----------+---------|
-| 3  | "blocks" | "heavy" |
-|----+----------+---------|
-| 4  | "piles"  | "light" |
-|----+----------+---------|
-| 5  | "panels" | "light" |
-+----+----------+---------+
-(5 rows)
-```
-</details>
-
 Сделаем соединение трех таблиц с тем, чтобы получить список всех позиций
 на складе с указанием их типа и остатков независимо от того,
 заказывались для них дополнительные поставки или нет.
@@ -248,12 +225,11 @@ projection ("ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK
             projection ("ITEMS"."ID"::integer -> "ID", "ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK")
                 scan "ITEMS"
         scan "ORDERS"
-            projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT")
+            projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT", "ORDERS"."SINCE"::datetime -> "SINCE")
                 scan "ORDERS"
 execution options:
 sql_vdbe_max_steps = 45000
 vtable_max_rows = 5000
-
 ```
 
 ### Частичное перемещение {: #segment_motion }
@@ -275,10 +251,9 @@ projection ("ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK
         scan "ITEMS"
             projection ("ITEMS"."ID"::integer -> "ID", "ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK")
                 scan "ITEMS"
-        motion [policy: segment([ref("ID")])]
-            scan "ORDERS"
-                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT")
-                    scan "ORDERS"
+        scan "ORDERS"
+            projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT", "ORDERS"."SINCE"::datetime -> "SINCE")
+                scan "ORDERS"
 execution options:
 sql_vdbe_max_steps = 45000
 vtable_max_rows = 5000
@@ -307,7 +282,7 @@ projection ("ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK
                 scan "ITEMS"
         motion [policy: full]
             scan "ORDERS"
-                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT")
+                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT", "ORDERS"."SINCE"::datetime -> "SINCE")
                     scan "ORDERS"
 execution options:
 sql_vdbe_max_steps = 45000
@@ -328,7 +303,7 @@ projection ("ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK
                 scan "ITEMS"
         motion [policy: full]
             scan "ORDERS"
-                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT")
+                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT", "ORDERS"."SINCE"::datetime -> "SINCE")
                     scan "ORDERS"
 execution options:
 sql_vdbe_max_steps = 45000
@@ -347,7 +322,7 @@ projection ("ITEMS"."NAME"::string -> "NAME", "ITEMS"."STOCK"::integer -> "STOCK
                 scan "ITEMS"
         motion [policy: full]
             scan "ORDERS"
-                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT")
+                projection ("ORDERS"."ID"::integer -> "ID", "ORDERS"."ITEM"::string -> "ITEM", "ORDERS"."AMOUNT"::integer -> "AMOUNT", "ORDERS"."SINCE"::datetime -> "SINCE")
                     scan "ORDERS"
 execution options:
 sql_vdbe_max_steps = 45000
diff --git a/docs/reference/sql/select.md b/docs/reference/sql/select.md
index d5191768..f6f8c558 100644
--- a/docs/reference/sql/select.md
+++ b/docs/reference/sql/select.md
@@ -94,14 +94,12 @@
 
 ### Получение данных из таблицы с фильтрацией {: #select_with_filter }
 
-
 ```sql
-SELECT name from ITEM WHERE STOCK > 1000;
+SELECT name from items WHERE stock > 1000;
 ```
 
 ### Получение данных без повторов {: #select_distinct }
 
-
 ```sql
 SELECT DISTINCT type FROM warehouse;
 ```
@@ -159,7 +157,6 @@ GROUP BY type;
 ```
 
 <!--
-
 ### Группировка с последующей фильтрацией по сгруппированным данным {: #group_and_filter }
 
 ```sql
@@ -168,7 +165,6 @@ GROUP BY type
 HAVING c > 3;
 
 sbroad: column with name "C" not found
-
 ```
 -->
 
-- 
GitLab