Błędy raportowania SSRS

Błędy raportowania SSRS to usterki dotyczące generowania zestawień przez usługę SQL Server Reporting Services.

Rola SSRS w generowaniu raportów

SQL Server Reporting Services, skracane do SSRS, jest platformą firmy Microsoft przeznaczoną do projektowania, publikowania i uruchamiania raportów opartych na danych. Raport może pobierać informacje między innymi z relacyjnej bazy SQL Server, a następnie przedstawiać je w postaci tabel, macierzy, wykresów, parametrów i podsumowań. Definicja raportu określa układ dokumentu, źródła danych, zapytania, parametry oraz sposób prezentacji wyników. Błąd raportowania SSRS oznacza więc problem występujący na jednym z etapów: połączenia ze źródłem danych, wykonania zapytania, przetworzenia wyników albo renderowania gotowego raportu.

SSRS może udostępniać raporty przez portal internetowy, aplikację zintegrowaną z usługą raportową albo eksportować je do formatów takich jak PDF, Excel, Word, CSV lub XML. Ten sam raport może działać poprawnie w jednym trybie wyświetlania, a nie powieść się podczas eksportu, ponieważ poszczególne formaty mają odmienne ograniczenia układu strony. Dlatego sam komunikat widoczny przy otwieraniu raportu nie zawsze wskazuje bezpośrednią przyczynę problemu. Znaczenie mają również dzienniki usługi, konfiguracja źródła danych i parametry przekazane do raportu.

Typowe źródła błędów w źródłach danych i zapytaniach

Jedną z częstych przyczyn jest nieudane połączenie SSRS z bazą danych. Raport może korzystać z osadzonego źródła danych albo ze współdzielonego obiektu źródła danych. W obu przypadkach znaczenie mają serwer, instancja, nazwa bazy, sposób uwierzytelniania oraz uprawnienia konta używanego podczas wykonywania raportu. Błąd logowania, niedostępna instancja SQL Server, zmiana hasła konta lub brak uprawnień do tabeli może spowodować komunikat o niemożności nawiązania połączenia albo wykonania zapytania.

Problem może znajdować się również w samym zbiorze danych raportu. Zmiana nazwy kolumny, tabeli, widoku lub parametru procedury składowanej powoduje, że wcześniej zapisane zapytanie przestaje odpowiadać strukturze bazy. SSRS zgłasza wtedy błędy składni, nieznane obiekty, niezgodność liczby parametrów albo brak wymaganej wartości. Szczególnej uwagi wymagają parametry raportu i parametry zapytań: parametr raportu może mieć inną nazwę, typ danych lub wartość domyślną niż parametr używany przez zbiór danych. Nieprawidłowa konwersja tekstu na datę lub liczbę także może zakończyć wykonanie raportu błędem.

W raportach opartych na wielu zbiorach danych mogą wystąpić błędy związane z relacjami między regionami danych, grupowaniem i odwołaniami do pól. Odwołanie do pola, którego nie zwraca dany zbiór danych, nie jest równoważne pustej wartości. Jest to błąd definicji raportu lub wyrażenia. Podobnie niepoprawne wyrażenie użyte w polu tekstowym, grupie albo filtrze może uniemożliwić przetworzenie całego raportu, nawet gdy zapytanie do bazy wykonuje się prawidłowo.

Rozróżnienie błędu wykonania od problemu z układem

Raport, który wyświetla dane w portalu SSRS, może zachowywać się inaczej po eksporcie. Format PDF wymaga obliczenia stron i położenia elementów na arkuszu, natomiast Excel odwzorowuje strukturę tabelaryczną i może tworzyć dodatkowe kolumny lub wiersze, gdy obiekty raportu nie są ustawione w jednej siatce. Element wystający poza szerokość obszaru treści może powodować puste strony w PDF albo niepożądany podział raportu. Jest to problem układu, a niekoniecznie awaria połączenia z bazą danych.

Właściwa analiza zaczyna się od ustalenia, na którym etapie pojawia się błąd. Jeżeli raport nie uruchamia się wcale, należy sprawdzić dostępność źródła danych, uwierzytelnianie, zapytanie i parametry. Jeżeli podgląd działa, lecz eksport kończy się niepowodzeniem, należy przeanalizować elementy raportu, rozmiar strony, szerokość obszaru roboczego, grupowanie oraz właściwości konkretnego renderera. Gdy raport działa, ale pokazuje niepełne lub nieaktualne dane, trzeba zweryfikować filtry, zakres dat, wartości parametrów, uprawnienia oraz czas odświeżenia danych.

Do rozdzielenia tych przypadków przydatne są komunikaty z interfejsu SSRS, logi usługi raportowej i logi SQL Server. Warto porównać czas wystąpienia błędu z wykonaniem zapytania oraz sprawdzić, czy problem dotyczy jednego raportu, wszystkich raportów korzystających z tego samego źródła danych, czy tylko jednego formatu eksportu. Taka korelacja ogranicza ryzyko poprawiania definicji raportu, gdy rzeczywistą przyczyną jest niedostępne połączenie, albo zmiany konfiguracji serwera, gdy błąd wynika z niepoprawnego filtra.

Zakres czynności przy technicznej diagnostyce SSRS

Diagnostyka błędu raportowania SSRS powinna obejmować kopię lub wersję definicji raportu, nazwę źródła danych, komunikat błędu, sposób jego odtworzenia oraz informację, czy raport był uruchamiany w portalu, aplikacji czy podczas eksportu. Następnie można sprawdzić połączenie ze źródłem danych, wykonać zapytanie z tymi samymi parametrami, porównać typy pól i zweryfikować zależności raportu. Nie należy zmieniać zapytań produkcyjnych bez ustalenia, czy problem leży w raporcie, bazie danych czy konfiguracji usługi.

W przypadku komputera użytkownika znaczenie może mieć także lokalne środowisko wyświetlania: przeglądarka, komponent odpowiedzialny za pobieranie pliku, program otwierający PDF lub Excel oraz połączenie z usługą raportową. Jeżeli ten sam raport działa na innym stanowisku, należy porównać adres usługi, konto, uprawnienia, ustawienia przeglądarki i sposób przekazywania parametrów. Sama reinstalacja programu biurowego nie naprawi błędu zapytania ani nieprawidłowej konfiguracji SSRS, dlatego diagnoza powinna rozdzielać problem aplikacji lokalnej od problemu raportu i serwera.

Przy naprawie warto zachować pierwotny komunikat oraz wynik kolejnych testów, ponieważ pozwala to potwierdzić, czy zmiana usunęła przyczynę, czy jedynie ukryła objaw. Jeżeli błąd dotyczy infrastruktury raportowej, procedura może wymagać dostępu administracyjnego do usługi SSRS i SQL Server. W takiej sytuacji na komputerze lokalnym można potwierdzić objawy, zebrać informacje diagnostyczne i ustalić zakres problemu, natomiast zmianę konfiguracji wykonuje osoba uprawniona do zarządzania tym środowiskiem.