= Индекси: v_contracts_revenue_index =

||= Својство ||= Вредност ||
|| Шема || `kbnteam` ||
|| Област || Договори и приходи ||
|| Главен преглед || [wiki:ContractsRevenueView v_contracts_revenue] ||

== Опис ==

Индексите го поддржуваат пристапот до податоците за договори и приходи. Се поставуваат врз изворните табели и можат да се користат од повеќе прегледи.

`contract(company_id, rest_id)` поддржува и услов само по company_id. Индексот со rest_id како прва колона ја поддржува другата насока на пребарување.

== DDL ==

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

== Поддржани прегледи ==

||= Индекс ||= Прегледи ||= Намена ||
|| `idx_company_order_company_id` || [wiki:OrdersFullView v_orders_full], [wiki:DriverDeliveriesView v_driver_deliveries], [wiki:ReviewsFullView v_reviews_full], [wiki:ContractsRevenueView v_contracts_revenue], [wiki:CompanyBillingOverviewView v_company_billing_overview] || Пронаоѓање компаниски нарачки по компанија. ||
|| `idx_customer_order_comp_order_id` || [wiki:OrdersFullView v_orders_full], [wiki:DriverDeliveriesView v_driver_deliveries], [wiki:ReviewsFullView v_reviews_full], [wiki:ContractsRevenueView v_contracts_revenue], [wiki:CompanyBillingOverviewView v_company_billing_overview] || Пронаоѓање клиентски нарачки по компаниска нарачка. ||
|| `idx_order_meal_order_id_meal_id` || [wiki:OrdersFullView v_orders_full], [wiki:DriverDeliveriesView v_driver_deliveries], [wiki:ContractsRevenueView v_contracts_revenue] || Пристап до јадењата на нарачката и групирање по order_id. ||
|| `idx_order_drink_order_id_drink_id` || [wiki:OrdersFullView v_orders_full], [wiki:DriverDeliveriesView v_driver_deliveries], [wiki:ContractsRevenueView v_contracts_revenue] || Пристап до пијалоците на нарачката и групирање по order_id. ||
|| `idx_contract_company_id_rest_id` || [wiki:ContractsRevenueView v_contracts_revenue], [wiki:CompanyBillingOverviewView v_company_billing_overview], [wiki:DriverLunchTimersView v_driver_lunch_timers] || Пребарување договори по компанија и ресторан и групирање по компанија. ||
|| `idx_contract_rest_id_company_id` || [wiki:DriverLunchTimersView v_driver_lunch_timers], [wiki:ContractsRevenueView v_contracts_revenue] || Пронаоѓање договори почнувајќи од ресторан. ||

== Заеднички индекси ==

||= Индекс ||= Поврзана документација ||
|| `idx_company_order_company_id` || [wiki:OrdersFullIndex Индекси за нарачки и достави] ||
|| `idx_customer_order_comp_order_id` || [wiki:OrdersFullIndex Индекси за нарачки и достави] ||
|| `idx_order_meal_order_id_meal_id` || [wiki:OrdersFullIndex Индекси за нарачки и достави] ||
|| `idx_order_drink_order_id_drink_id` || [wiki:OrdersFullIndex Индекси за нарачки и достави] ||
|| `idx_contract_rest_id_company_id` || [wiki:DriverLunchTimersIndex Индекси за термини за ручек] ||

== Колонски план ==

||= Индекс ||= Табела ||= Прва колона ||= Следни колони ||= Намена ||
|| `idx_company_order_company_id` || `company_order` || `company_id` || — || Пронаоѓање компаниски нарачки по компанија. ||
|| `idx_customer_order_comp_order_id` || `customer_order` || `comp_order_id` || — || Пронаоѓање клиентски нарачки по компаниска нарачка. ||
|| `idx_order_meal_order_id_meal_id` || `order_meal` || `order_id` || `meal_id` || Пристап до јадењата на нарачката и групирање по order_id. ||
|| `idx_order_drink_order_id_drink_id` || `order_drink` || `order_id` || `drink_id` || Пристап до пијалоците на нарачката и групирање по order_id. ||
|| `idx_contract_company_id_rest_id` || `contract` || `company_id` || `rest_id` || Пребарување договори по компанија и ресторан и групирање по компанија. ||
|| `idx_contract_rest_id_company_id` || `contract` || `rest_id` || `company_id` || Пронаоѓање договори почнувајќи од ресторан. ||

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

== Верификација ==

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

Проверката ги прикажува имињата и дефинициите. IF NOT EXISTS спречува повторно креирање под исто име, но не проверува дали постојната дефиниција е еднаква на наведената.

== Влијание врз перформансите ==

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

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

Резултатите се однесуваат на [wiki:ContractsRevenueView v_contracts_revenue] и неговата главна табела `contract`.

=== SELECT ===

Мерењата се евидентирани во DBeaver. Времињата се во милисекунди (ms).

{{{
#!sql
SELECT * FROM kbnteam.v_contracts_revenue
WHERE company_id = 250;
}}}

||= Метрика ||= Пред индексирање ||= По индексирање ||
|| Клиентско време (ms) || 2555 || 1966 ||
|| Вратени редови || 0 || 0 ||

Измереното време е пократко за 589 ms, односно 23,1%. Двете извршувања враќаат нула редови, па резултатот се однесува на овој конкретен филтер.

=== INSERT и UPDATE ===

Тестирани се по еден INSERT и еден UPDATE врз `kbnteam.contract`, главната табела на погледот. Се тестира додавање договор и продолжување на неговиот рок.

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

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

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

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

Резултатите се за целите прашалници, а не за одделниот придонес на секој индекс.