JFlow Labs / WIEDZA

Raport z bazy danych: czym jest i jak go zrobić krok po kroku

Raport bazy danych to zestawienie przygotowane z tabeli, zapytania albo widoku, które pokazuje dane w stałym układzie: pogrupowane, posortowane i podsumowane, gotowe do wydruku, pliku albo maila. Nie służy do wpisywania ani poprawiania rekordów, od tego jest formularz. Ten przewodnik jest dla firm, które mają sprzedaż, zamówienia albo magazyn w bazie SQL Server, PostgreSQL lub Access i chcą co tydzień dostawać to samo zestawienie bez ręcznego eksportu. Najprostsza wersja to zapytanie SELECT z GROUP BY zapisane w bazie jako widok; w Access i LibreOffice Base raport składasz kreatorem na tabeli albo zapytaniu, a w Power BI dokument do druku nazywa się raportem stronicowanym. Żeby zestawienie przychodziło samo, potrzebujesz jeszcze harmonogramu, repliki albo kopii zamiast obciążonej bazy produkcyjnej, konta tylko do odczytu i daty z godziną danych na każdym wydaniu. Niżej opisuję po kolei sekcje raportu, przykład w SQL z sumami częściowymi, Access, LibreOffice Base i Power BI, wybór źródła danych, harmonogram, format wyjścia, definicje wskaźników, uprawnienia i to, kiedy wystarczy praca na godziny.

Czym jest raport bazy danych i z czego się składa

W bazach danych to słowo ma wąskie znaczenie: obiekt do prezentowania danych, zbudowany na tabeli albo zapytaniu, a nie miejsce, w którym dane się zmienia.

Tak opisuje go dokumentacja Microsoft Access: raport to obiekt bazy danych, którego używasz, żeby przedstawić lub rozesłać podsumowanie danych, zachować migawkę danych na później, pokazać szczegóły pojedynczych rekordów albo przygotować etykiety. Źródłem rekordów może być tabela, nazwane zapytanie albo zapytanie osadzone.

Warto odróżnić trzy pojęcia, które w podręcznikach stoją obok siebie. Zapytanie, w polskim Access nazywane też kwerendą, wybiera i liczy dane. Formularz służy do wpisywania i edycji rekordów. Raport bierze wynik zapytania i nadaje mu układ do czytania: nagłówki, grupy, sumy i numery stron.

Układ dzieli się na sekcje i to od sekcji zależy, co policzy umieszczona w niej suma. W Access pole z funkcją Suma w nagłówku raportu liczy sumę dla całego dokumentu, a to samo pole w nagłówku grupy tylko dla bieżącej grupy. Konstruktor raportu w LibreOffice Base zaczyna od trzech sekcji: główki strony, szczegółów i stopki strony; główkę i stopkę całości dodajesz osobno, a wynik powstaje jako dokument programu Writer, który możesz dalej edytować.

Sekcje raportu i co w nich umieścić (według dokumentacji Microsoft Access)
SekcjaGdzie się pojawiaCo w niej umieścić
Nagłówek raportuRaz, na początku raportuTytuł, logo lub datę; suma w tej sekcji dotyczy całego raportu
Nagłówek stronyU góry każdej stronyTytuł raportu powtarzany na każdej stronie
Nagłówek grupyNa początku każdej grupy rekordówNazwę grupy, na przykład miesiąca albo kanału sprzedaży; suma w tej sekcji dotyczy bieżącej grupy
SzczegółyRaz dla każdego wiersza źródła rekordówWłaściwe dane: zamówienia, pozycje, rekordy
Stopka grupyNa końcu każdej grupyPodsumowanie grupy: sumy i liczniki
Stopka stronyNa dole każdej stronyNumer strony i inne informacje dotyczące tej strony
Stopka raportuRaz, na końcu raportuSumy i podsumowanie całego zestawienia

Dokument czy pulpit: rozstrzygnij to przed wyborem narzędzia

Zanim wybierzesz narzędzie, ustal, czy potrzebujesz dokumentu, czy ekranu do przeglądania danych. Od tej decyzji zależą narzędzie, koszty licencji i to, kto będzie całość utrzymywał.

Raport jest dokumentem. Ma ustaloną treść, ustalony moment powstania i odbiorcę, który go czyta, a nie klika. Taki dokument da się wydrukować, wysłać księgowej, dołączyć do wniosku kredytowego i odłożyć do folderu, żeby za rok sprawdzić, co wtedy pokazywał. Jego wartość bierze się z tego, że jest zawsze taki sam i zawsze przychodzi.

Dashboard, po polsku pulpit, jest ekranem do zadawania pytań. Zmieniasz zakres dat, filtrujesz po oddziale, klikasz w słupek i schodzisz poziom niżej. Pulpit ma sens, gdy ktoś siada do niego regularnie i szuka, a nie wtedy, gdy raz na miesiąc potrzebuje jednej liczby.

Najprostszy test jest taki: czy tę odpowiedź ktoś musi komuś przekazać poza systemem? Jeśli tak, czyli jeśli liczba idzie do maila, do banku, do zarządu albo do arkusza, w którym ktoś liczy dalej, zamawiasz raport. Jeśli odpowiedź żyje tylko w głowie osoby, która na nią patrzy, i za pięć minut zada kolejne pytanie, zamawiasz pulpit.

Pomyłka na tym etapie wychodzi drogo w obie strony. Zamówienie „raportów z bazy” może skończyć się ofertą na narzędzie BI z licencjami dla wszystkich, choć wystarczyłby jeden plik w każdy poniedziałek o siódmej. W drugą stronę „ten jeden plik” po kilku miesiącach potrafi rozrosnąć się do kilkunastu wariantów, z których nikt nie wie, który jest aktualny.

Uważaj na słownictwo Power BI, bo układa te pojęcia inaczej niż ten przewodnik. Pulpit Power BI to jedna strona z kafelkami, dostępna tylko w usłudze Power BI, i nie da się go filtrować ani przekrajać fragmentatorem. Raport Power BI może mieć wiele stron, filtry i drążenie danych, a opiera się na jednym modelu semantycznym, więc odpowiada temu, co w tym przewodniku nazywa się pulpitem. Dokumentowi, który ten przewodnik nazywa raportem, odpowiada w Power BI raport stronicowany, tworzony w osobnym narzędziu Power BI Report Builder.

Kiedy to jest praca na godziny, a kiedy osobny projekt

Granica nie biegnie tam, gdzie zwykle się ją zakłada. Nie chodzi o trudność zapytania, tylko o to, ile rzeczy trzeba uzgodnić, zanim ktokolwiek napisze pierwszą linijkę.

Na godziny robi się raport, który ma jedno pytanie, jedno źródło i gotową definicję. Odbiorca wie, co chce zobaczyć, ktoś w firmie potrafi rozstrzygnąć wątpliwość w pół godziny, format jest plikiem, a częstotliwość nie przekracza raz na dobę. Wtedy praca to napisanie zapytania, obudowanie go widokiem, ustawienie harmonogramu i dodanie stopki z datą. To zamyka się w krótkim, przewidywalnym zleceniu.

Osobnego projektu wymaga sytuacja, w której dane leżą w kilku systemach, definicje są sporne, odbiorcy są zewnętrzni albo każdy ma widzieć wyłącznie swój wycinek. Wtedy prawdziwa praca nie polega na pisaniu SQL-a, lecz na zbudowaniu miejsca, z którego wszystkie raporty czytają: jednej bazy raportowej, jednego słownika definicji i jednego zestawu uprawnień. Bez tego każdy kolejny raport zaczyna się od nowa, a każdy liczy po swojemu.

Kilka sygnałów rozstrzyga sprawę szybciej niż długa analiza. Zdanie „potrzebujemy tego dla naszych klientów” oznacza, że budujesz produkt, a nie raport, bo dochodzą uprawnienia, wygląd i odpowiedzialność za treść. Zdanie „ktoś codziennie klika eksport i skleja w Excelu” oznacza, że kupujesz automat i zwrot policzysz w godzinach pracy ludzi. Zdanie „mamy to w trzech systemach i nigdy się nie zgadza” oznacza, że najpierw potrzebujesz wspólnego miejsca na dane, a dopiero potem raportu.

Jest też sytuacja odwrotna, w której najuczciwiej powiedzieć, że projekt nie jest potrzebny. Gdy pytanie jest jedno, pada raz na kwartał, a odpowiedź ma dwie liczby, automatyzacja kosztuje więcej, niż oszczędza. Wtedy lepszym rozwiązaniem jest zapisane zapytanie i krótka instrukcja niż harmonogram, który przez trzy miesiące nie robi nic, a po trzech miesiącach przestaje działać, bo zmienił się schemat i nikt tego nie zauważył.

Zestawienie w SQL krok po kroku: od zapytania do pliku

Access, Excel i Power BI pobierają dane z bazy zapytaniem, nawet jeśli użytkownik go nie widzi. Jeśli dane masz w PostgreSQL albo SQL Server, zapisz to zapytanie w samej bazie, a narzędziu zostaw tylko wyświetlanie: wtedy definicja przeżyje zmianę narzędzia. Przykład niżej liczy sprzedaż netto według miesiąca i kanału z sumami częściowymi; nazwy tabel i kolumn są przykładowe.

  1. Nazwij grupy i miaryZ pytania „ile zamówień i jaka sprzedaż netto w każdym miesiącu i kanale, z sumą dla miesiąca i całości” wynikają dwie kolumny grupowania, miesiąc i kanał, oraz dwie miary: liczba zamówień i suma netto. Co dokładnie znaczy „sprzedaż”, ustalasz wcześniej, według definicji wskaźników.
  2. Pogrupuj i dodaj sumy częścioweGROUP BY zwraca jeden wiersz na każdą grupę. ROLLUP dodaje do wyniku sumy częściowe i sumę całkowitą, czyli to samo, co w Access dają stopka grupy i stopka raportu. W wierszu sumy kolumna, według której nie grupowano, ma wartość NULL, a funkcja GROUPING() pozwala odróżnić taki wiersz od zwykłego braku danych.
  3. Obetnij daty w polskiej strefie czasowejW PostgreSQL funkcja date_trunc przyjmuje strefę jako trzeci argument, więc miesiąc zamyka się o północy czasu polskiego, a nie UTC. W SQL Server od wersji 2022, Azure SQL Database i Azure SQL Managed Instance odpowiednikiem jest DATETRUNC, ale ta funkcja strefy nie przyjmuje: jeśli daty trzymasz w UTC, najpierw przelicz je wyrażeniem AT TIME ZONE 'UTC' AT TIME ZONE 'Central European Standard Time'. W starszych wersjach SQL Server funkcji DATETRUNC nie ma.
  4. Zapisz zapytanie jako widokWidok trzyma definicję w bazie, więc Access, Excel, Power BI i skrypt eksportu czytają tę samą liczbę. Gdy zapytanie liczy się za długo, przejdź na widok materializowany.
  5. Wyeksportuj wynik na koncie tylko do odczytuW PostgreSQL polecenie COPY zapisujące plik na serwerze wymaga superużytkownika albo roli pg_write_server_files. Polecenie \copy w psql zapisuje plik po stronie klienta, więc wystarczy mu zwykłe konto raportowe z prawem odczytu.
  6. Zaplanuj odświeżaniepg_cron uruchamia polecenie według składni crona. Domyślnie liczy czas w GMT; strefę zmienisz parametrem cron.timezone w postgresql.conf, a zmiana działa dopiero po restarcie serwera. Zadanie wykonuje się z uprawnieniami użytkownika, który je zaplanował, a REFRESH MATERIALIZED VIEW wymaga uprawnienia MAINTAIN na widoku, które domyślnie ma jego właściciel. Dlatego tego zadania nie zakładasz na koncie raportowym tylko do odczytu.
PostgreSQL: sprzedaż netto według miesiąca i kanału, z sumami częściowymi (oplacono_at typu timestamptz)
CREATE VIEW raport_sprzedaz_miesieczna AS
SELECT
  miesiac,
  kanal,
  GROUPING(miesiac, kanal) AS poziom_sumy, -- 0 wiersz zwykły, 1 suma miesiąca, 3 suma całkowita
  count(*)                 AS liczba_zamowien,
  sum(wartosc_netto)       AS sprzedaz_netto
FROM (
  SELECT date_trunc('month', oplacono_at, 'Europe/Warsaw') AS miesiac,
         kanal,
         wartosc_netto
  FROM zamowienia
  WHERE status = 'oplacone'
) AS z
GROUP BY ROLLUP (miesiac, kanal);
SQL Server 2022 lub nowszy, Azure SQL Database i Managed Instance: to samo zestawienie (oplacono_at zapisane w czasie polskim; dla UTC zobacz krok 3)
CREATE VIEW dbo.raport_sprzedaz_miesieczna AS
SELECT
  DATETRUNC(month, z.oplacono_at) AS miesiac,
  z.kanal,
  GROUPING_ID(DATETRUNC(month, z.oplacono_at), z.kanal) AS poziom_sumy,
  COUNT(*)             AS liczba_zamowien,
  SUM(z.wartosc_netto) AS sprzedaz_netto
FROM dbo.zamowienia AS z
WHERE z.status = N'oplacone'
GROUP BY ROLLUP (DATETRUNC(month, z.oplacono_at), z.kanal);
psql: eksport widoku do CSV na koncie tylko do odczytu
\copy (SELECT * FROM raport_sprzedaz_miesieczna ORDER BY miesiac, kanal) TO 'sprzedaz_miesieczna.csv' WITH (FORMAT csv, HEADER)
PostgreSQL i pg_cron: widok materializowany z unikalnym indeksem i odświeżanie w każdy poniedziałek o 5:00
-- jednorazowo: CONCURRENTLY wymaga unikalnego indeksu zbudowanego z samych nazw kolumn
CREATE MATERIALIZED VIEW raport_sprzedaz_mv AS
  SELECT * FROM raport_sprzedaz_miesieczna;
CREATE UNIQUE INDEX ON raport_sprzedaz_mv (miesiac, kanal, poziom_sumy);

-- w postgresql.conf: cron.timezone = 'Europe/Warsaw' (domyślnie GMT, działa po restarcie)
SELECT cron.schedule(
  'raport-sprzedaz-poniedzialek',
  '0 5 * * 1',
  $$REFRESH MATERIALIZED VIEW CONCURRENTLY raport_sprzedaz_mv$$
);

Access, LibreOffice Base czy Power BI: co wybrać

Access i LibreOffice Base składają raport do druku z tabel i zapytań zapisanych w pliku bazy albo w tabelach podłączonych z serwera. Power BI pokazuje w przeglądarce interaktywne raporty i pulpity, a dokument do druku robi się w nim osobnym narzędziem, Power BI Report Builder. Wybór zależy więc od tego, gdzie leżą dane i czy wynik ma być drukowany, czy klikany.

Jeśli ktoś ma dostać pełne zestawienie mailem albo w PDF, szukasz raportu stronicowanego, który drukuje całą tabelę nawet na wielu stronach, a nie pulpitu, który mieści się na jednej stronie z kafelkami. Power BI Report Builder pobierzesz za darmo, a z darmową licencją opublikujesz go w swoim obszarze My Workspace; do obszarów współdzielonych z zespołem potrzebujesz licencji Pro albo PPU. W usłudze Power BI ustawisz też jego subskrypcję mailową, codzienną, cotygodniową albo co godzinę, z całością w załączniku PDF. Porównanie kosztów i źródeł danych dwóch popularnych narzędzi BI jest w osobnym przewodniku: Looker Studio czy Power BI.

Gdzie zrobisz raport z bazy danych i co z tego powstaje
NarzędzieJak zacząćCo powstajeKiedy pasuje
Microsoft AccessKarta Tworzenie, grupa Raporty: Raport, Kreator raportów, Projekt raportu, Pusty raport albo Etykiety.Raport z sekcjami, grupowaniem, sumami i podglądem wydruku.Dane w pliku Access i zestawienie do druku albo eksportu.
LibreOffice BaseIkona Raporty, potem Utwórz raport w widoku projektu; Konstruktor raportu wymaga środowiska Java (JRE).Dokument programu Writer, który możesz dalej edytować.Baza prowadzona w LibreOffice i zestawienie do druku.
Power BI: raportPower BI Desktop albo usługa Power BI, połączenie z bazą i model semantyczny.Jedna lub wiele stron z filtrami i drążeniem danych; jeden model semantyczny na raport.Odbiorca sam filtruje i porównuje okresy.
Power BI: raport stronicowanyPower BI Report Builder.Dokument o dokładnie ustalonym układzie strony; tabela drukuje się w całości, nawet na wielu stronach.Zestawienia do archiwum, faktury, PDF wysyłany mailem.
Power BI: pulpitTylko w usłudze Power BI; w Power BI Desktop pulpitów nie ma.Jedna strona z kafelkami przypiętymi z jednego lub wielu raportów, bez filtrowania.Szybki przegląd kilku liczb z odnośnikami do szczegółów.

Skąd brać dane: baza produkcyjna, replika czy kopia

Zapytanie, które podsumowuje miesiąc albo rok, skanuje szerokie zakresy dat i łączy kilka dużych tabel. Na bazie produkcyjnej rywalizuje o procesor, pamięć i dysk z tym, co robi klient w koszyku.

Zestawienie liczone na produkcji konkuruje o zasoby z aplikacją, bo uderza w tę samą maszynę. Weź hipotetyczne zapytanie, które na spokojnej bazie liczy się kilka sekund: w szczycie ten sam plan wykonania walczy o procesor, pamięć i dysk z tym, co robi klient w koszyku, więc trwa dłużej i wydłuża czas odpowiedzi aplikacji. Nie podam tu, o ile, bo to zależy od planu zapytania, wolumenu i sprzętu, a każda liczba bez Twojej bazy byłaby zgadywaniem. Dlatego pierwsza decyzja projektowa dotyczy nie SQL-a, tylko tego, w którą maszynę uderza zapytanie.

Replika to druga kopia bazy, która sama nadąża za pierwszą i przyjmuje wyłącznie odczyty. W PostgreSQL odpowiada za to hot standby: dokumentacja mówi wprost, że po włączeniu tego trybu serwer przyjmuje połączenia, ale wszystkie są ściśle tylko do odczytu, bo nie zapiszesz na nim nawet tabeli tymczasowej. Polecenia INSERT, UPDATE, DELETE i cała warstwa DDL kończą się na replice błędem.

Replika ma jednak swoją cenę i warto ją znać przed wdrożeniem. Dane na standby są, jak to nazywa dokumentacja PostgreSQL, ostatecznie spójne z bazą główną, więc czytasz stan sprzed pewnej chwili. Do tego dochodzą konflikty zapytań: gdy na bazie głównej ktoś wykona operację wymagającą wyłącznego zamka, replika musi albo wstrzymać odtwarzanie dziennika, albo przerwać Twoje zapytanie. Sterują tym parametry max_standby_streaming_delay i max_standby_archive_delay, a wartość -1 oznacza czekanie w nieskończoność na zakończenie zapytania, kosztem rosnącego opóźnienia repliki.

W Azure SQL Database mechanizm nazywa się read scale-out i działa inaczej, niż wielu ludzi zakłada. Repliki tylko do odczytu są w warstwach Premium, Business Critical i Hyperscale; w Basic, Standard i General Purpose ich nie ma, więc tam nie masz na czym odciążyć produkcji. Połączenie kierujesz na replikę, dopisując do parametrów połączenia ApplicationIntent=ReadOnly, a sprawdzisz to zapytaniem SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability'), które na replice zwróci READ_ONLY. Typowe opóźnienie propagacji Microsoft opisuje jako zakres od dziesiątek milisekund do pojedynczych sekund, ale zaznacza, że nie ma stałej górnej granicy.

Kopia to trzecia droga, wystarczająca, gdy zestawienie ma być dzienne albo rzadsze. Zrzucasz bazę raz na dobę i liczysz wszystko na zrzucie, na osobnej maszynie, gdzie nikomu nie zaszkodzisz. Dokumentacja PostgreSQL opisuje zachowanie pg_dump wprost: narzędzie nie blokuje innych użytkowników, ani czytających, ani piszących, i robi spójny eksport nawet wtedy, gdy baza jest w tym czasie używana. Warto pamiętać o pułapce zrzutu równoległego, bo przy opcji -j proces pomocniczy, który nie dostanie współdzielonego zamka, przerywa cały zrzut, żeby nie doszło do zakleszczenia.

Jeśli mimo wszystko musisz uderzyć w produkcję, załóż bezpiecznik. W PostgreSQL służy do tego statement_timeout, czyli przerwanie polecenia trwającego dłużej niż zadany czas; domyślna wartość zero oznacza brak limitu. Dokumentacja odradza ustawianie tego parametru globalnie w postgresql.conf, bo dotknąłby wszystkich sesji, więc ustaw go osobno dla roli raportowej albo dla samej sesji raportu.

Trzy źródła danych dla raportu i konsekwencje wyboru.
ŹródłoWpływ na sprzedażŚwieżość danychKiedy wybrać
Baza produkcyjnaNajwiększy: raport konkuruje z aplikacją o te same zasoby.Stan bieżący, co do sekundy.Tylko dla lekkich zapytań, z ustawionym limitem czasu i poza godzinami szczytu.
Replika tylko do odczytuŻaden przy odczycie, ale długie zapytanie może opóźnić nadążanie repliki.Opóźniona o zmienną, niegwarantowaną wartość.Raporty w ciągu dnia i pulpity, gdy warstwa usługi w ogóle daje repliki.
Kopia lub zrzutŻaden po zakończeniu zrzutu; sam zrzut nie blokuje czytających ani piszących.Stan z momentu zrzutu, zwykle nocny.Raporty dzienne, tygodniowe i miesięczne, czyli większość tego, co zamawiają firmy.

Widok, zapisane zapytanie, procedura i widok materializowany

Różnica między tymi czterema obiektami sprowadza się do dwóch pytań: czy obiekt przechowuje wynik i kto go odświeża. Od odpowiedzi zależy, czy zestawienie liczy się od nowa przy każdym otwarciu, czy czyta gotowe dane sprzed kilku godzin.

Zapisane zapytanie to po prostu plik z SQL-em w repozytorium. Nie istnieje w bazie, więc nikt go przypadkiem nie skasuje ani nie podmieni, i masz historię zmian razem z resztą kodu. Wadą jest to, że każdy, kto chce z niego skorzystać, musi mieć ten plik i klienta bazy.

Widok to nazwana definicja zapytania wewnątrz bazy. Najważniejsza rzecz, której ludzie po nim oczekują, a której on nie robi: widok nie przechowuje danych. Dokumentacja PostgreSQL stwierdza to jednym zdaniem, czyli że zapytanie jest uruchamiane za każdym razem, gdy widok zostanie użyty. Widok porządkuje i ukrywa złożoność, ale sam z siebie nie przyspiesza niczego.

Widok materializowany trzyma wynik w postaci podobnej do tabeli i dlatego czyta się go znacznie szybciej niż tabele źródłowe. Cena jest taka, że nie odświeża się sam. Polecenie REFRESH MATERIALIZED VIEW całkowicie zastępuje zawartość widoku, a bez klauzuli CONCURRENTLY potrafi zablokować połączenia, które właśnie próbują z tego widoku czytać. Klauzula CONCURRENTLY zdejmuje tę blokadę, ale wymaga co najmniej jednego unikalnego indeksu zbudowanego wyłącznie z nazw kolumn i obejmującego wszystkie wiersze, a widok musi być już wypełniony. Do tego tylko jedno odświeżanie naraz może chodzić na danym widoku. Sama dokumentacja PostgreSQL podpowiada przy okazji wzorzec, o który chodzi w tym przewodniku: zadanie zaplanowane na noc, które wykonuje REFRESH MATERIALIZED VIEW na widoku z podsumowaniem sprzedaży.

W SQL Server najbliższym odpowiednikiem jest widok indeksowany, ale zasada działania jest inna i trzeba to rozumieć przed decyzją. Pierwszy indeks założony na widoku musi być unikalnym indeksem klastrowym, widok trzeba utworzyć z opcją WITH SCHEMABINDING, a jego definicja musi być deterministyczna. Taki widok jest utrzymywany na bieżąco, więc każdy INSERT, UPDATE i DELETE na tabelach źródłowych musi zaktualizować także widoki indeksowane. Microsoft ostrzega wprost, że przy dużej liczbie takich widoków wydajność operacji zapisu może się znacząco pogorszyć, a czasem plan zapytania w ogóle nie powstanie. Drobiazg, który zaskakuje przy wdrożeniu: w edycji Standard, żeby czytać wprost z widoku indeksowanego, trzeba dopisać podpowiedź NOEXPAND, podczas gdy Azure SQL Database i Azure SQL Managed Instance używają go automatycznie.

Procedura jest miejscem na kroki, a nie na jedno zapytanie. Wywołujesz ją poleceniem CALL i w PostgreSQL może, w odróżnieniu od funkcji, sterować transakcją, czyli wykonywać COMMIT i ROLLBACK. Warto znać wyjątek: procedura zadeklarowana jako SECURITY DEFINER nie może wykonywać poleceń sterowania transakcją. Procedurę wybierasz wtedy, gdy zestawienie powstaje w kilku krokach: wyczyść tabelę wyników, policz, zapisz, oznacz datę i godzinę, zapisz wpis do dziennika.

Moja zasada jest prosta. Zaczynaj od widoku, bo jest najtańszy w utrzymaniu i niczego nie duplikuje. Przejdź na widok materializowany dopiero wtedy, gdy zmierzysz, że zapytanie trwa za długo, i gdy jesteś w stanie powiedzieć, o ile stare dane są jeszcze akceptowalne. Po procedurę sięgaj, gdy pojawia się więcej niż jeden krok albo trzeba zapisać ślad wykonania.

Harmonogram: jak sprawić, żeby zestawienie przychodziło samo

Zestawienie, które ktoś musi uruchomić ręcznie, przestaje przychodzić, gdy ta osoba zachoruje albo zmieni pracę. Harmonogram łatwo pominąć w wycenie, a to on decyduje, czy rozwiązanie działa bez nadzoru.

Wybór narzędzia do harmonogramu zależy głównie od tego, gdzie stoi baza, a nie od tego, co lubi wykonawca. Niżej pięć dróg wraz z ograniczeniami opisanymi w dokumentacji.

Niezależnie od wybranego narzędzia trzy rzeczy muszą być w zakresie od początku. Po pierwsze dziennik uruchomień, żeby dało się odpowiedzieć na pytanie, czy raport w ogóle się wykonał. Po drugie powiadomienie o błędzie kierowane do człowieka, a nie do skrzynki, której nikt nie czyta. Po trzecie skrypt odporny na powtórzenie: dokumentacja elastic jobs mówi wprost, że skrypty mają być idempotentne, bo zadanie samo ponawia wykonanie po błędzie sieci, a raport policzony dwa razy nie może wygenerować dwóch kompletów danych.

Format wyjścia: Excel, PDF, mail czy link do panelu

Format wybiera się pod odbiorcę i pod to, co on zrobi z liczbą w następnym kroku. To jedna decyzja, a przesądza o połowie pracy.

Excel wybierasz, gdy odbiorca będzie liczył dalej: doklei kolumnę, zrobi tabelę przestawną, wklei do własnego modelu. Wtedy raport ma być płaską tabelą z nagłówkami, bez scalonych komórek i bez ozdób, bo każda ozdoba psuje filtrowanie. PDF wybierasz wtedy, gdy dokument ma być niezmienny: idzie do archiwum, do banku, do akt sprawy albo pod podpis.

Mail wybierasz, gdy wiesz, że odbiorca nie wejdzie do żadnego panelu. To nie jest złośliwość wobec odbiorcy, tylko realia: właściciel firmy czyta w telefonie między spotkaniami i chce mieć trzy liczby w treści wiadomości, a szczegóły w załączniku. Link do panelu wybierasz, gdy dane zmieniają się w ciągu dnia albo gdy odbiorców jest wielu i każdy ma widzieć swój wycinek.

Po stronie SQL Server gotowym mechanizmem jest subskrypcja w Reporting Services. Dokumentacja opisuje ją jako konfigurację, która dostarcza raport o określonej porze albo w reakcji na zdarzenie i w formacie, który wskażesz. Dostępne drogi dostarczania to udział plikowy Windows, poczta elektroniczna i biblioteka SharePoint, a dla odbiorcy wskazanego w subskrypcji do wyboru są między innymi XML, CSV, PDF, MHTML, Excel, TIFF i Word.

Dokumentacja Reporting Services opisuje dwa ograniczenia subskrypcji, które łatwo przeoczyć przed wdrożeniem. Pierwsze: raport, do którego tworzysz subskrypcję, musi korzystać z zapisanych poświadczeń albo z żadnych, bo nie zasubskrybujesz raportu, który łączy się do źródła jako bieżący użytkownik. Drugie: subskrypcje nie są dostępne w każdej edycji SQL Server, więc przed obietnicą „będzie przychodzić mailem” sprawdź, jaką edycję ma Twoja firma. Przy nowym wdrożeniu dochodzi trzecia rzecz: od SQL Server 2025 Microsoft nie wydaje już nowych wersji Reporting Services, a raporty lokalne przejmuje Power BI Report Server, dostępny w edycjach Enterprise i Standard SQL Server 2025.

Jeśli odbiorców jest wielu i każdy ma dostać własną wersję tego samego raportu, służy do tego subskrypcja sterowana danymi. Zapytanie zwraca listę odbiorców razem z parametrami i formatem, a serwer tworzy po jednej przesyłce na każdy wiersz wyniku. To rozwiązuje przypadek „każdy kierownik oddziału ma dostać swój oddział” bez budowania czternastu osobnych raportów.

Definicje wskaźników: dlaczego dwa działy mają różne liczby

Gdy sprzedaż i księgowość podają różne liczby, zwykle obie liczą poprawnie, tylko według innej definicji: datą zamówienia albo faktury, z podatkiem albo bez, ze zwrotami albo bez. Rozwiązaniem jest zapisanie definicji, a nie poprawianie SQL-a.

Weź jedno słowo: sprzedaż. Czy liczy się datą zamówienia, czy datą faktury? Z podatkiem czy bez? Czy odejmujesz zwroty, a jeśli tak, to w miesiącu zamówienia czy w miesiącu zwrotu? Czy wliczasz koszt dostawy? Czy zamówienia anulowane w tym samym dniu w ogóle się pojawiają? Każda z tych odpowiedzi jest sensowna, a każda daje inną liczbę. Dopóki sprzedaż i księgowość odpowiadają inaczej, spór o raport jest sporem o definicję, a nie o SQL.

Rozwiązuje się to raz i w jednym miejscu, nie na każdym raporcie osobno. Definicję zapisujesz zdaniem po polsku, razem z listą wykluczeń, a potem implementujesz ją dokładnie raz: jako widok, procedurę albo miarę w modelu danych. Wszystko inne ma czytać z tego obiektu, zamiast kopiować sobie zapytanie. Kopiowane zapytanie żyje własnym życiem i po pierwszej poprawce zaczyna się rozjeżdżać.

Zapisz definicję tam, gdzie jest kod, a nie tylko w notatce. Komentarz przy obiekcie w bazie i akapit w repozytorium przeżyją zmianę osoby na stanowisku, a ustalenie ze spotkania nie przeżyje. Gdy definicja się zmienia, zmieniasz ją w jednym miejscu i dopisujesz na raporcie krótką notkę, od kiedy obowiązuje nowa; bez tej notki ktoś porówna dwa okresy liczone różnie i wyciągnie fałszywy wniosek.

  1. Zapisz pytanie jednym zdaniemNa przykład: ile przychodu bez podatku wygenerowały zamówienia opłacone w danym miesiącu. Jedno zdanie, bez „i jeszcze”.
  2. Wypisz wykluczeniaZwroty, anulowane, testowe, zamówienia pracowników, zamówienia z kuponem stuprocentowym. To one różnicują wyniki działów.
  3. Wskaż osobę rozstrzygającąJedna osoba w firmie ma prawo powiedzieć, jak brzmi definicja. Bez tego spór wraca przy każdym raporcie.
  4. Zaimplementuj razJeden obiekt w bazie albo jedna miara w modelu. Każdy nowy raport czyta z niego, zamiast pisać własną wersję.
  5. Oznaczaj zmiany definicjiData zmiany widoczna na raporcie i wpis w repozytorium. Porównywanie okresów liczonych różnymi definicjami to najczęstszy sposób na złą decyzję.

Świeżość danych: data i godzina na każdym wydaniu

Plik bez znacznika czasu traci wartość w chwili, gdy ktoś go prześle dalej, bo za tydzień nikt nie odróżni wydania z poniedziałku od wydania ze środy.

Na raporcie powinny być dwa czasy, nie jeden, i to jest rozróżnienie, które oszczędza najwięcej nieporozumień. Pierwszy to moment wygenerowania dokumentu. Drugi to moment, do którego dane są kompletne. Gdy raport liczy się na nocnym zrzucie, a wysyła o ósmej rano, te dwie wartości dzieli kilka godzin i wszystko, co wydarzyło się rano, nie jest w środku.

Ta różnica ma pokrycie w mechanice źródeł. Czytając z repliki, czytasz stan sprzed pewnej chwili, a Microsoft w dokumentacji read scale-out zaznacza, że typowe opóźnienie mieści się między dziesiątkami milisekund a pojedynczymi sekundami, lecz stałej górnej granicy nie ma. Czytając z widoku materializowanego, czytasz stan z ostatniego odświeżenia, bo ten obiekt nie aktualizuje się sam. W obu przypadkach liczba na ekranie jest prawdziwa, tylko dotyczy innego momentu, niż zakłada czytający.

Praktyczne minimum w stopce każdego wydania wygląda tak: dane do dnia i godziny, moment wygenerowania, źródło i wersja definicji. Cztery linijki, które zamykają większość sporów, zanim się zaczną.

Strefa czasowa to osobna pułapka i warto ją sprawdzić na samym początku. Elastic jobs w Azure SQL Database operują wyłącznie w czasie UTC, więc raport ustawiony na północ wyląduje w Polsce o pierwszej albo drugiej w nocy, zależnie od pory roku, i obetnie dobę w innym miejscu, niż spodziewa się odbiorca. Harmonogram odświeżania w Power BI działa z kolei w strefie wybranej w ustawieniach modelu, a pula ośmiu odświeżeń na wspólnej pojemności zeruje się o 00:01 czasu lokalnego. Jeśli raport ma zamykać dobę zgodnie z polskim kalendarzem, sprawdź to zawczasu, bo pierwszym objawem błędu jest wynik niezgodny z systemem sprzedażowym o kilka punktów obrotu.

Uprawnienia: kto widzi co i dlaczego nie konto administratora

Raport chodzący na koncie administratora jest najkrótszą drogą do tego, żeby przypadkowy błąd w zapytaniu albo wyciek jednego pliku kosztował całą bazę.

Konto raportowe ma robić dokładnie jedną rzecz: czytać dane, których raport potrzebuje. Nie ma prawa zapisu, nie ma prawa do zmiany schematu, nie ma prawa do kasowania. To nie jest przesada, tylko ograniczenie szkody. Konto administratora, które siedzi w harmonogramie i ma zapisane hasło, prędzej czy później trafi w ręce, dla których nie było przeznaczone.

W PostgreSQL najprostszym punktem wyjścia jest predefiniowana rola pg_read_all_data. Dokumentacja opisuje ją jako prawo do odczytu wszystkich danych, czyli tabel, widoków i sekwencji, tak jakby rola miała uprawnienie SELECT na tych obiektach i USAGE na wszystkich schematach. Trzeba przy tym wiedzieć, że ta rola nie omija zabezpieczeń na poziomie wiersza.

Zabezpieczenie na poziomie wiersza, czyli RLS, jest tym, czego potrzebujesz, gdy jeden raport ma pokazywać każdemu tylko jego wycinek. Włącza się je poleceniem ALTER TABLE ... ENABLE ROW LEVEL SECURITY, a gdy dla tabeli nie ma żadnej polityki, działa domyślna odmowa i nie widać ani jednego wiersza. Tu kryje się pułapka, która potrafi wywrócić całą konfigurację: superużytkownicy i role z atrybutem BYPASSRLS zawsze omijają ten mechanizm, a właściciel tabeli również go normalnie omija, chyba że świadomie włączysz ALTER TABLE ... FORCE ROW LEVEL SECURITY. Raport uruchamiany jako właściciel tabeli zobaczy więc wszystko, mimo poprawnie napisanych polityk.

W SQL Server odpowiednikiem konta do odczytu jest członkostwo w roli db_datareader, która pozwala czytać wszystkie dane ze wszystkich tabel i widoków użytkownika. Po przeciwnej stronie stoi db_owner, która ma uprawnienie CONTROL DATABASE, czyli komplet uprawnień w bazie, a w SQL Server pozwala nawet usunąć bazę danych. Jeżeli konto raportowe ma db_owner, to nie jest konto raportowe.

W samym harmonogramie kontekst bezpieczeństwa też jest osobną decyzją. W SQL Server Agent kroki typu Transact-SQL ustawiają kontekst poleceniem EXECUTE AS, a pozostałe rodzaje kroków korzystają z konta pośredniczącego, czyli proxy, które ma dostęp tylko do wskazanych podsystemów. Dostęp do samego Agenta dla osób spoza roli serwerowej sysadmin nadaje się przez role w bazie msdb, takie jak SQLAgentUserRole, SQLAgentReaderRole i SQLAgentOperatorRole.

Na koniec rzecz, o której zapomina się najczęściej, bo leży poza bazą. Plik wygenerowany przez raport dziedziczy uprawnienia folderu, w którym wylądował, a nie uprawnienia bazy. Świetnie zabezpieczony raport zapisany na otwartym dysku sieciowym jest otwartym raportem. To samo dotyczy załącznika w mailu, który ktoś przekaże dalej jednym kliknięciem.

Cztery drogi do tego samego zestawienia i czym się różnią

Zanim wybierzesz, sprawdź nie to, jak szybko coś powstanie, tylko co się stanie, gdy za trzy miesiące odbiorca zmieni pytanie. To ten koszt zjada budżety.

Najważniejsza w tej tabeli jest kolumna o zmianie pytania. Mówi więcej o rzeczywistym koszcie niż kolumna o czasie powstania, bo pytania w firmie zmieniają się zawsze, a pierwsze uruchomienie jest tylko raz.

Cztery drogi wyjścia dla cyklicznego raportu z bazy danych.
DrogaKto to utrzymujeJak szybko powstajeZmiana pytaniaKto może to czytać
Zapytanie ad hocOsoba, która je napisała; poza jej głową nie istnieje nic.Najszybciej, zwykle w ramach jednej rozmowy.Trzeba poprosić tę samą osobę i czekać; przy jej nieobecności raportu nie ma.Tylko ktoś z dostępem do bazy i klienta SQL.
Widok albo procedura z harmonogramemFirma, bo definicja leży w bazie i w repozytorium, a nie w czyichś notatkach.Szybko, gdy dane są w jednym miejscu i definicja jest uzgodniona.Poprawka w jednym obiekcie; nowy przekrój bywa nowym obiektem.Każdy odbiorca pliku albo maila, bez dostępu do bazy.
Narzędzie BIFirma, ale wymaga osoby, która zna to konkretne narzędzie i pilnuje odświeżania.Średnio; najwięcej czasu zajmuje model danych, nie wykresy.Odbiorca często zmienia sam, filtrami; głębsza zmiana wymaga poprawki modelu.Zależy od licencji i uprawnień w narzędziu; przy wielu odbiorcach to bywa główny koszt.
Własny panelWykonawca albo zespół; to jest oprogramowanie, z utrzymaniem i aktualizacjami.Najdłużej ze wszystkich czterech dróg.Zmiana to praca programisty, ale można ją dowolnie dopasować.Dowolna osoba, także klient z zewnątrz, z uprawnieniami ustawionymi przez Ciebie.

Co przygotować, zanim zamówisz raport

Sześć rzeczy, które skracają rozmowę o połowę i zdejmują z wyceny największą część niepewności.

  1. Pytanie w jednym zdaniuNapisz, na co raport ma odpowiadać, bez spójnika „oraz”. Jeśli nie mieści się w jednym zdaniu, to są dwa raporty i warto je rozdzielić od razu.
  2. Ręcznie policzona odpowiedź za jeden okresJedna liczba za jeden miesiąc, policzona tak, jak robisz to dziś. To jedyny sposób, żeby sprawdzić, czy automat liczy to samo, co człowiek, zanim raport pójdzie do obiegu.
  3. Dostęp do repliki albo kopii, nie do produkcjiJeśli nie ma repliki, ustalcie zawczasu, czy powstanie, czy raport ma liczyć się na nocnym zrzucie. Ta decyzja zmienia wszystko, co dzieje się dalej.
  4. Lista odbiorców i formatKto dostaje, o której godzinie, czym to otworzy i co zrobi z liczbą w następnym kroku. Arkusz, PDF i link to trzy różne zakresy prac.
  5. Osoba rozstrzygająca definicjeJedno nazwisko, nie dział. Ta osoba decyduje, czy zwroty odejmujemy w miesiącu zamówienia, czy w miesiącu zwrotu.
  6. Adres na powiadomienia o awariiSkrzynka, którą ktoś naprawdę czyta. Raport, który przestał przychodzić, zauważa się zwykle dopiero wtedy, gdy jest potrzebny, a to zawsze najgorszy moment.

Pytania i odpowiedzi

Czym różni się raport od formularza w bazie danych?

Formularz służy do wpisywania, edycji i przeglądania pojedynczych rekordów. Raport tylko prezentuje dane: grupuje je, sortuje, liczy sumy i przygotowuje do wydruku albo wysyłki. Przez raport nie zmienisz żadnego rekordu w tabeli.

Jak dodać sumy częściowe do raportu w SQL?

Użyj GROUP BY ROLLUP. Klauzula ROLLUP (a, b) liczy grupy dla pary a i b, osobno dla samego a oraz sumę całkowitą, czyli to, co w Access dają stopka grupy i stopka raportu. W wierszach sum kolumna, po której nie grupowano, ma NULL, a funkcja GROUPING() pokazuje, który wiersz jest sumą. Składnię ROLLUP mają zarówno PostgreSQL, jak i SQL Server.

Czym jest raport stronicowany w Power BI?

To raport projektowany do druku i udostępniania, tworzony w osobnym narzędziu Power BI Report Builder. W odróżnieniu od zwykłego raportu Power BI raport stronicowany drukuje całą tabelę, nawet jeśli zajmuje ona wiele stron, i pozwala dokładnie ustalić układ strony. Pasuje do faktur, zestawień do archiwum i dokumentów wysyłanych jako PDF.

Czy raport można liczyć prosto z bazy produkcyjnej?

Można, ale tylko dla lekkich zapytań, z limitem czasu wykonania i poza godzinami szczytu. Ciężki raport konkuruje z aplikacją o te same zasoby i potrafi wydłużyć czas odpowiedzi sklepu albo systemu sprzedaży. W PostgreSQL ustaw dla roli raportowej statement_timeout, bo domyślna wartość zero oznacza brak jakiegokolwiek limitu; dokumentacja odradza przy tym ustawianie tego parametru globalnie w postgresql.conf, bo dotknąłby wszystkich sesji. Bezpieczniejszy wzorzec to replika tylko do odczytu albo nocna kopia.

Widok czy widok materializowany?

Widok nie przechowuje danych: zapytanie uruchamia się za każdym razem, gdy ktoś z widoku korzysta, więc widok porządkuje kod, ale niczego nie przyspiesza. Widok materializowany trzyma wynik i czyta się go szybciej, lecz nie odświeża się sam, a polecenie REFRESH MATERIALIZED VIEW zastępuje całą jego zawartość. Bez klauzuli CONCURRENTLY odświeżanie potrafi zablokować tych, którzy właśnie z widoku czytają, a sama klauzula CONCURRENTLY wymaga unikalnego indeksu zbudowanego z nazw kolumn i obejmującego wszystkie wiersze. Zaczynaj od widoku, przechodź na materializowany dopiero po zmierzeniu czasu zapytania.

Mamy Azure SQL Database. Gdzie jest SQL Server Agent?

Nie ma go tam i to regularnie zaskakuje po migracji. SQL Server Agent obsługuje SQL Server oraz Azure SQL Managed Instance, natomiast w Azure SQL Database jego rolę pełnią elastic jobs, które uruchamiają skrypty T-SQL cyklicznie na jednej lub wielu bazach, logują status i same ponawiają nieudane operacje. Zwróć uwagę na dwie rzeczy: wszystkie harmonogramy działają w czasie UTC, a historia wykonań jest automatycznie czyszczona po 45 dniach. Skrypty muszą być idempotentne, bo zadanie może zostać powtórzone po błędzie sieci.

Excel czy PDF?

Excel wtedy, gdy odbiorca będzie liczył dalej, a PDF wtedy, gdy dokument ma pozostać niezmienny, bo idzie do archiwum, do banku albo pod podpis. Jeśli raport ma po prostu przychodzić o umówionej porze, po stronie SQL Server zrobi to subskrypcja w Reporting Services, która dostarcza raport we wskazanym formacie na udział plikowy Windows, pocztą albo do biblioteki SharePoint; do wyboru są między innymi CSV, PDF, Excel i Word. Pamiętaj tylko, że raport musi używać zapisanych poświadczeń, a subskrypcje nie są dostępne w każdej edycji SQL Server.

Dlaczego dwa działy mają różne liczby dla tego samego pytania?

Prawie zawsze dlatego, że liczą różne rzeczy, a nie dlatego, że któraś strona się myli. Sprzedaż liczona datą zamówienia i datą faktury to dwie różne liczby, tak samo jak sprzedaż ze zwrotami odjętymi w miesiącu zamówienia i w miesiącu zwrotu. Rozwiązuje się to raz: definicja zapisana zdaniem po polsku, lista wykluczeń, jedna osoba rozstrzygająca i dokładnie jedna implementacja w bazie albo w modelu danych, z której czytają wszystkie raporty.

Jak często raport może się odświeżać w Power BI?

Modele na współdzielonej pojemności mają limit ośmiu zaplanowanych odświeżeń dziennie, a pula zeruje się codziennie o 00:01 czasu lokalnego wybranego w ustawieniach modelu. Na pojemności Premium, pojemności użytkownika PPU albo Fabric zaplanujesz do 48 odświeżeń dziennie. Jeśli potrzebujesz danych świeższych, niż pozwala harmonogram, zamiast walczyć z limitem odświeżeń rozważ połączenie na żywo do źródła albo osobny panel czytający wprost z repliki. Ręczne „Odśwież teraz” w ustawieniach modelu nie zużywa puli ośmiu zaplanowanych odświeżeń, ale odświeżenia wywołane przez REST API już tak.

Źródła

Liczby i terminy w tym przewodniku sprawdziłem w oficjalnych źródłach. Ceny i przepisy się zmieniają, więc przy decyzji warto zajrzeć do nich ponownie.

Masz pytanie do swojego projektu?

Opisz, co chcesz osiągnąć. Odpowiem konkretnie, także wtedy, gdy najlepszą odpowiedzią jest „nie rób tego”.

Jonasz Jankowski · Bezpośrednia współpraca · Mikołów (Śląsk), zdalnie w całej Polsce

CO DALEJ PO WYSŁANIU
  1. Odpowiadam osobiście w ciągu jednego dnia roboczego.
  2. Krótka rozmowa o celu, funkcjach, materiałach i integracjach.
  3. Dostajesz zakres z etapami i konkretną kwotę, zanim cokolwiek zaczniemy.

Pola oznaczone jako opcjonalne możesz pominąć. Odpowiadam na każdą wiadomość.

Minimum 20 znaków. Wystarczy zalążek pomysłu.0/5000

Na podany e-mail otrzymasz potwierdzenie z numerem zapytania. Odpowiadam w ciągu jednego dnia roboczego. Dalszą rozmowę możemy prowadzić w tym samym wątku.