= Преглед: 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;
}}}

== Индексна поддршка ==

Водечката колона 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;
}}}

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

=== SELECT ===

Времето на извршување на SELECT прашалникот е прифатливо за редовното користење на погледот. Постоечката индексна поддршка е доволна за тестираните прашалници.

=== INSERT и UPDATE ===

Тестирани се по еден INSERT и еден UPDATE врз `kbnteam.lunch_time`, главната табела на погледот. Се тестира додавање термин и промена на времето за претходна нарачка.

||= Операција ||= Execute (ms) ||= Fetch (ms) ||= Вратени редови ||
|| INSERT || 24 || 24 || 1 ||
|| UPDATE || 13 || 24 || 1 ||

Execute е времето на извршување прикажано во DBeaver. Fetch вредностите се преземени од дополнетата евиденција на тестирањето. Ова се клиентски времиња, изразени во милисекунди.

Двете операции се успешни и враќаат по еден ред преку RETURNING. По мерењето промените се вратени со ROLLBACK.

INSERT и UPDATE се извршуваат со прифатлива брзина. Овие мерења ја опишуваат тестираната состојба на базата и не се споредба пред и по индексирање.