= Преглед: v_driver_lunch_timers =

||= Својство ||= Вредност ||
|| Шема || `kbnteam` ||
|| Категорија || Термини за ручек ||
|| Поврзани индекси || [wiki:DriverLunchTimersIndex Индекси за термини за ручек] ||

== Опис ==

Ги поврзува термините за ручек со договорите, компаниите, рестораните и доставувачите.

Се добива ред за секој термин и секој доставувач на ресторанот. Погледот не го ограничува резултатот на назначениот доставувач и не филтрира активни договори или денови. Термините за ресторани без доставувачи не се прикажуваат.

Еден ред за секој пар термин–доставувач на ресторанот. Термин за ресторан без доставувачи не се прикажува; поврзаната компаниска нарачка може да биде NULL.

== Зависности ==

||= Табела / преглед ||= Употреба ||
|| `kbnteam.lunch_time` || Термини за ручек и поврзаните договори. ||
|| `kbnteam.contract` || Договори меѓу компаниите и рестораните. ||
|| `kbnteam.company` || Податоци за компаниите. ||
|| `kbnteam.restaurant` || Податоци за рестораните. ||
|| `kbnteam.driver` || Доставувачи и нивните ресторани. ||
|| `kbnteam.api_user` || Лични и контактни податоци за корисниците. ||

== Излезни колони ==

||= Колона ||= Извор / пресметка ||= Опис ||
|| `lunch_time_id` || `lunch_time.lunch_time_id` || Идентификатор на терминот за ручек. ||
|| `lunch_weekday` || `lunch_time.lunch_weekday` || Ден од неделата. ||
|| `lunch_start` || `lunch_time.lunch_start` || Почеток на терминот. ||
|| `lunch_end` || `lunch_time.lunch_end` || Крај на терминот. ||
|| `lunch_preorder_offset` || `lunch_time.lunch_preorder_offset` || Период за претходно нарачување. ||
|| `comp_order_id` || `lunch_time.comp_order_id` || Идентификатор на компаниската нарачка. ||
|| `contract_id` || `contract.contract_id` || Идентификатор на договорот. ||
|| `company_id` || `company.company_id` || Идентификатор на компанијата. ||
|| `company_name` || `company.company_name` || Назив на компанијата. ||
|| `rest_id` || `restaurant.rest_id` || Идентификатор на ресторанот. ||
|| `rest_name` || `restaurant.rest_name` || Назив на ресторанот. ||
|| `driver_user_id` || `driver.user_id` || Идентификатор на доставувачот. ||
|| `driver_first_name` || `api_user.user_first_name` || Име на доставувачот. ||
|| `driver_last_name` || `api_user.user_last_name` || Презиме на доставувачот. ||
|| `driver_phone` || `api_user.user_phone_no` || Телефон на доставувачот. ||

== SQL дефиниција ==

{{{
#!sql
CREATE OR REPLACE VIEW kbnteam.v_driver_lunch_timers AS
SELECT
    lt.lunch_time_id,
    lt.lunch_weekday,
    lt.lunch_start,
    lt.lunch_end,
    lt.lunch_preorder_offset,
    lt.comp_order_id,
    ct.contract_id,
    cmp.company_id,
    cmp.company_name,
    r.rest_id,
    r.rest_name,
    drv.user_id AS driver_user_id,
    au.user_first_name AS driver_first_name,
    au.user_last_name AS driver_last_name,
    au.user_phone_no AS driver_phone
FROM kbnteam.lunch_time lt
JOIN kbnteam.contract ct ON ct.contract_id = lt.contract_id
JOIN kbnteam.company cmp ON cmp.company_id = ct.company_id
JOIN kbnteam.restaurant r ON r.rest_id = ct.rest_id
JOIN kbnteam.driver drv ON drv.rest_id = r.rest_id
JOIN kbnteam.api_user au ON au.user_id = drv.user_id;
}}}

== Тестирање на перформанси ==

Примерите користат илустративни идентификатори и датуми. За споредливи мерења се избираат вредности што постојат во базата и се задржуваат истите податоци, филтри, услови за кеширање и број на повторувања. Статистиките за табелите треба да бидат ажурирани во двете состојби.

=== Тест прашалници ===

{{{
#!sql
BEGIN READ ONLY;
SET LOCAL statement_timeout = '60s';

-- Тест 1: по ден
EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
SELECT * FROM kbnteam.v_driver_lunch_timers
WHERE lunch_weekday = 'Monday';

-- Тест 2: по договор
EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
SELECT * FROM kbnteam.v_driver_lunch_timers
WHERE contract_id = 1;

-- Тест 3: по ресторан
EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
SELECT * FROM kbnteam.v_driver_lunch_timers
WHERE rest_id = 1;

ROLLBACK;
}}}

Тестот само по ден служи како споредбен случај. Дополнителниот индекс за термини е по contract_id, па првенствено го поддржува тестот по договор.

=== Резултати пред индексирање ===

Основната состојба ги задржува индексите на примарните клучеви и уникатните ограничувања. Останатите присутни индекси се евидентираат одделно. При споредба на заеднички индекси се користи истата почетна состојба за секој преглед.

||= Метрика ||= Тест 1 (по ден) ||= Тест 2 (по договор) ||= Тест 3 (по ресторан) ||
|| Planning Time || ___ ms || ___ ms || ___ ms ||
|| Execution Time || ___ ms || ___ ms || ___ ms ||
|| Rows Returned || ___ || ___ || ___ ||
|| Начин на читање по табела || ___ || ___ || ___ ||
|| Shared Hit Blocks || ___ || ___ || ___ ||
|| Shared Read Blocks || ___ || ___ || ___ ||

{{{
-- Планови и резултати пред дополнителното индексирање:

}}}

=== Дополнителни и заеднички индекси ===

Водечката колона contract_id овозможува пристап до термините според договорот. Самостоен услов само по lunch_weekday нема соодветен дополнителен индекс во овој сет.

||= Индекс ||= Табела и колони ||= Намена ||
|| `idx_contract_company_id_rest_id` || `contract(company_id, rest_id)` || Пребарување договори по компанија и ресторан и групирање по компанија. ||
|| `idx_driver_rest_id` || `driver(rest_id)` || Пронаоѓање доставувачи по ресторан. ||
|| `idx_contract_rest_id_company_id` || `contract(rest_id, company_id)` || Пронаоѓање договори почнувајќи од ресторан. ||
|| `idx_lunch_time_contract_id` || `lunch_time(contract_id)` || Пронаоѓање термини за конкретен договор, без услов за денот од неделата. ||

{{{
#!sql
CREATE INDEX IF NOT EXISTS idx_contract_company_id_rest_id
ON kbnteam.contract (company_id, rest_id);

CREATE INDEX IF NOT EXISTS idx_driver_rest_id
ON kbnteam.driver (rest_id);

CREATE INDEX IF NOT EXISTS idx_contract_rest_id_company_id
ON kbnteam.contract (rest_id, company_id);

CREATE INDEX IF NOT EXISTS idx_lunch_time_contract_id
ON kbnteam.lunch_time (contract_id);
}}}

=== Проверка на индексите ===

{{{
#!sql
SELECT tablename, indexname, indexdef
FROM pg_indexes
WHERE schemaname = 'kbnteam'
  AND indexname IN (
    'idx_contract_company_id_rest_id',
    'idx_driver_rest_id',
    'idx_contract_rest_id_company_id',
    'idx_lunch_time_contract_id'
)
ORDER BY tablename, indexname;
}}}

=== Резултати по индексирање ===

Мерењето ги користи истите тест прашалници и услови како почетното мерење.

||= Метрика ||= Тест 1 (по ден) ||= Тест 2 (по договор) ||= Тест 3 (по ресторан) ||
|| Planning Time || ___ ms || ___ ms || ___ ms ||
|| Execution Time || ___ ms || ___ ms || ___ ms ||
|| Rows Returned || ___ || ___ || ___ ||
|| Начин на читање по табела || ___ || ___ || ___ ||
|| Shared Hit Blocks || ___ || ___ || ___ ||
|| Shared Read Blocks || ___ || ___ || ___ ||

{{{
-- Планови и резултати по дополнителното индексирање:

}}}

=== Анализа на подобрување ===

||= Метрика ||= Пред ||= По ||= Промена (%) ||
|| Execution Time (Тест 1) || ___ ms || ___ ms || ___ % ||
|| Execution Time (Тест 2) || ___ ms || ___ ms || ___ % ||
|| Execution Time (Тест 3) || ___ ms || ___ ms || ___ % ||

Промената се пресметува како 100 × (време пред − време по) / време пред, кога почетното време е поголемо од нула. Негативна вредност означува побавно извршување.

Изборот меѓу секвенцијално читање, индексно читање и други планови зависи од обемот на податоците, селективноста на филтрите и статистиките. Индексите не гарантираат забрзување или отстранување на сортирањата и спојувањата. Плановите и времињата се утврдуваат со мерење.