Доводка стилистики документации

sql/stg/airplanes_ddl.sql

@@ -32,7 +32,7 @@ WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Обоснование: airplane_code — это уникальный идентификатор самолёта.
 -- Использование airplane_code обеспечивает:
 -- 1. Равномерное распределение данных по сегментам (airplane_code имеет высокую кардинальность)
--- 2. Co-location данных airplanes и routes при JOIN по airplane_code
--- 3. Co-location данных airplanes и seats при JOIN по airplane_code
--- 4. Оптимизацию запросов, которые фильтруют или группируют по airplane_code
+-- 2. Коллокацию данных airplanes и seats при JOIN по airplane_code
+-- 3. Оптимизацию запросов, которые фильтруют или группируют по airplane_code
+-- Примечание: JOIN с таблицей routes (распределённой по route_no) может требовать motion.
 DISTRIBUTED BY (airplane_code);

sql/stg/airplanes_dq.sql

@@ -15,7 +15,7 @@ BEGIN
 
     IF v_src_count = 0 THEN
         RAISE EXCEPTION
-            'В источнике airplanes_ext нет строк.';
+            'В источнике airplanes_ext нет строк. Проверьте: bookings-db запущен, PXF работает, STG DDL применён (bookings_stg_ddl или make ddl-gp).';
     END IF;
 
     -- Считаем строки, реально вставленные в stg.airplanes в этом батче

sql/stg/airports_ddl.sql

@@ -36,6 +36,6 @@ WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Обоснование: airport_code — это уникальный идентификатор аэропорта.
 -- Использование airport_code обеспечивает:
 -- 1. Равномерное распределение данных по сегментам (airport_code имеет высокую кардинальность)
--- 2. Co-location данных airports и routes при JOIN по departure_airport/arrival_airport
--- 3. Оптимизацию запросов, которые фильтруют или группируют по airport_code
+-- 2. Оптимизацию запросов, которые фильтруют или группируют по airport_code
+-- Примечание: JOIN с таблицей routes (распределённой по route_no) может требовать motion.
 DISTRIBUTED BY (airport_code);

sql/stg/airports_dq.sql

@@ -15,7 +15,7 @@ BEGIN
 
     IF v_src_count = 0 THEN
         RAISE EXCEPTION
-            'В источнике airports_ext нет строк.';
+            'В источнике airports_ext нет строк. Проверьте: bookings-db запущен, PXF работает, STG DDL применён (bookings_stg_ddl или make ddl-gp).';
     END IF;
 
     -- Считаем строки, реально вставленные в stg.airports в этом батче

sql/stg/boarding_passes_ddl.sql

@@ -32,7 +32,7 @@ WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Ключ распределения: ticket_no
 -- Обоснование: ticket_no — это основной бизнес-ключ для билетов.
 -- Использование ticket_no обеспечивает:
--- 1. Co-location данных boarding_passes и segments при JOIN по ticket_no
+-- 1. Коллокацию данных boarding_passes и segments при JOIN по ticket_no
 -- 2. Равномерное распределение данных по сегментам (ticket_no имеет высокую кардинальность)
 -- Примечание: stg.tickets распределена по book_ref, поэтому JOIN boarding_passes ↔ tickets по ticket_no может требовать motion.
 DISTRIBUTED BY (ticket_no);

sql/stg/bookings_ddl.sql

@@ -29,7 +29,6 @@ WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Обоснование: book_ref — это уникальный идентификатор бронирования.
 -- Использование book_ref обеспечивает:
 -- 1. Равномерное распределение данных по сегментам (book_ref имеет высокую кардинальность)
--- 2. Co-location данных bookings и tickets при JOIN по book_ref
+-- 2. Коллокацию данных bookings и tickets при JOIN по book_ref
 -- 3. Оптимизацию запросов, которые фильтруют или группируют по book_ref
 DISTRIBUTED BY (book_ref);
-

sql/stg/routes_dq.sql

@@ -17,7 +17,7 @@ BEGIN
 
     IF v_src_count = 0 THEN
         RAISE EXCEPTION
-            'В источнике routes_ext нет строк.';
+            'В источнике routes_ext нет строк. Проверьте: bookings-db запущен, PXF работает, STG DDL применён (bookings_stg_ddl или make ddl-gp).';
     END IF;
 
     -- Считаем строки, реально вставленные в stg.routes в этом батче

sql/stg/seats_ddl.sql

@@ -26,9 +26,6 @@ CREATE TABLE IF NOT EXISTS stg.seats (
 )
 WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Ключ распределения: airplane_code
--- Обоснование: airplane_code обеспечивает co-location с таблицей airplanes.
--- Использование airplane_code обеспечивает:
--- 1. Co-location данных seats и airplanes при JOIN по airplane_code
--- 2. Группировка мест по самолётам (в одном самолёте обычно много мест)
--- 3. Оптимизацию запросов, которые фильтруют или группируют по airplane_code
+-- Обоснование: airplane_code обеспечивает коллокацию seats ↔ airplanes при JOIN по airplane_code
+-- (в MPP это уменьшает вероятность перераспределения данных / motion).
 DISTRIBUTED BY (airplane_code);

sql/stg/seats_dq.sql

@@ -16,7 +16,7 @@ BEGIN
 
     IF v_src_count = 0 THEN
         RAISE EXCEPTION
-            'В источнике seats_ext нет строк.';
+            'В источнике seats_ext нет строк. Проверьте: bookings-db запущен, PXF работает, STG DDL применён (bookings_stg_ddl или make ddl-gp).';
     END IF;
 
     -- Считаем строки, реально вставленные в stg.seats в этом батче

sql/stg/segments_ddl.sql

@@ -30,7 +30,7 @@ WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Ключ распределения: ticket_no
 -- Обоснование: ticket_no — это основной бизнес-ключ для билетов.
 -- Использование ticket_no обеспечивает:
--- 1. Co-location данных segments и boarding_passes при JOIN по ticket_no
+-- 1. Коллокацию данных segments и boarding_passes при JOIN по ticket_no
 -- 2. Равномерное распределение данных по сегментам (ticket_no имеет высокую кардинальность)
 -- Примечание: stg.tickets распределена по book_ref, поэтому JOIN segments ↔ tickets по ticket_no может требовать motion.
 DISTRIBUTED BY (ticket_no);

sql/stg/tickets_ddl.sql

@@ -32,8 +32,7 @@ WITH (appendonly=true, orientation=row, compresstype=zlib, compresslevel=1)
 -- Ключ распределения: book_ref
 -- Обоснование: book_ref — это основной бизнес-ключ для бронирований.
 -- Использование book_ref обеспечивает:
--- 1. Co-location данных tickets и bookings при JOIN по book_ref
+-- 1. Коллокацию данных tickets и bookings при JOIN по book_ref
 -- 2. Равномерное распределение данных по сегментам (book_ref имеет высокую кардинальность)
 -- 3. Оптимизацию запросов, которые фильтруют или группируют по book_ref
 DISTRIBUTED BY (book_ref);
-