API do profili zapytań

API do profili zapytań to interfejs umożliwiający programowy odczyt szczegółowych planów wykonania i statystyk zapytań.

Rola API w profilowaniu zapytań

API do profili zapytań to programowy interfejs, przez który aplikacja może pobierać informacje o sposobie wykonywania zapytań przez silnik bazodanowy. Zamiast analizować wyłącznie tekst polecenia SQL i jego czas całkowity, można odczytać plan wykonania, wykorzystane operatory, szacowaną oraz rzeczywistą liczbę wierszy, koszty poszczególnych etapów i statystyki zużycia zasobów. Taki interfejs jest zwykle przeznaczony do automatycznej obserwacji pracy bazy, narzędzi diagnostycznych, systemów monitoringu oraz testów wydajnościowych.

Profil zapytania należy odróżnić od samego wyniku zapytania. Wynik zawiera dane zwrócone przez instrukcję, natomiast profil opisuje drogę prowadzącą do ich uzyskania. API może udostępniać dane dla pojedynczego wykonania albo informacje zagregowane dla wielu wykonań tego samego zapytania. W zależności od implementacji identyfikacja zapytania może opierać się na jego tekście, znormalizowanej postaci, identyfikatorze planu, identyfikatorze sesji lub identyfikatorze wpisu w repozytorium statystyk.

Plan wykonania i dane obserwowane podczas pracy

Najważniejszym elementem profilu jest plan wykonania. Przed rozpoczęciem pracy silnik wybiera operatory potrzebne do odczytu lub modyfikacji danych. Mogą to być między innymi skanowanie tabeli, odczyt indeksu, filtrowanie, sortowanie, grupowanie, łączenie zbiorów danych oraz przekazywanie wyników między operatorami. API może zwracać plan jako strukturę hierarchiczną, w której operator nadrzędny korzysta z rezultatów operatorów podrzędnych. Taka forma pozwala ustalić, który etap generuje największą część kosztu.

Profil może zawierać zarówno wartości szacowane przez optymalizator, jak i wartości zmierzone w czasie wykonania. Szacunek liczby wierszy jest tworzony przed uruchomieniem planu na podstawie statystyk tabel, indeksów i predykatów. Rzeczywista liczba wierszy powstaje dopiero podczas pracy operatora. Duża różnica między tymi wartościami wskazuje na niedokładność statystyk, nietypowy rozkład danych, niepasujący predykat albo parametry zapytania, których optymalizator nie przewidział. Sama rozbieżność nie dowodzi jeszcze konkretnej przyczyny, ale wyznacza miejsce wymagające dalszej analizy.

Statystyki, identyfikatory i interpretacja wyników

Interfejs profilowania może udostępniać czas wykonania, czas oczekiwania, liczbę odczytanych stron lub bloków, liczbę zwróconych wierszy, liczbę zapisów, wykorzystanie pamięci oraz informacje o współbieżności. Nie każda implementacja zwraca wszystkie te wartości, a nazwy pól i sposób ich obliczania zależą od konkretnego silnika. Czas wykonania może obejmować samo przetwarzanie zapytania albo także oczekiwanie na blokady, operacje wejścia-wyjścia i przesyłanie danych do klienta. Dlatego poszczególne metryki trzeba interpretować zgodnie z dokumentacją danego API.

Przy automatycznym odczycie profili istotna jest stabilna identyfikacja zapytania. Dwa zapytania o podobnym działaniu mogą mieć różny tekst, na przykład przez inne wartości parametrów, a dwa identyczne teksty mogą otrzymać różne plany po zmianie statystyk, indeksów lub konfiguracji. System monitoringu powinien przechowywać co najmniej czas obserwacji, identyfikator zapytania, identyfikator planu, wersję struktury profilu oraz jednostki miar. Warto także rozróżniać profil planu od próbki pojedynczego wykonania, ponieważ średnia z wielu uruchomień może ukrywać sporadyczne opóźnienia.

API profilujące często wymaga odpowiednich uprawnień, ponieważ zwracane dane mogą ujawniać tekst zapytań, nazwy obiektów bazy, parametry, ścieżki dostępu i informacje o obciążeniu. Z punktu widzenia technicznego oznacza to konieczność ograniczenia dostępu do interfejsu, kontrolowania zakresu zapisywanych danych i zabezpieczenia kanału komunikacji. Profilowanie może również zwiększać koszt wykonania, zwłaszcza gdy włączone są szczegółowe pomiary dla każdego operatora. W praktyce należy ustalić, czy pomiar obejmuje wszystkie zapytania, tylko wybrane sesje, czy ograniczoną próbkę ruchu.

Wykorzystanie profili przy diagnozie problemów z wydajnością

Analizę warto rozpocząć od porównania zapytań o podobnym znaczeniu biznesowym, lecz różnym czasie wykonania. Profil pozwala sprawdzić, czy opóźnienie wynika z dużej liczby odczytów, sortowania wykonywanego poza pamięcią, nieoczekiwanego skanowania, nadmiernej liczby wierszy przekazywanych między operatorami, oczekiwania na blokadę albo przeciążenia wejścia-wyjścia. Przed zmianą zapytania należy jednak odróżnić problem planu od problemu środowiska. Ten sam plan może działać szybko przy ciepłej pamięci podręcznej, a wolniej po ponownym uruchomieniu systemu lub przy równoczesnym obciążeniu.

Profil nie jest automatyczną receptą na poprawę wydajności. Dodanie indeksu, zmiana predykatu, przebudowa zapytania lub modyfikacja statystyk powinny być poprzedzone sprawdzeniem wpływu na inne operacje. Po zmianie trzeba ponownie zebrać profil w porównywalnych warunkach i zweryfikować nie tylko czas, lecz także liczbę odczytów, liczbę przetwarzanych wierszy oraz stabilność wyników dla różnych parametrów. W przypadku komputera, na którym lokalnie uruchomiono narzędzie korzystające z bazy danych, błędne wyniki profilowania mogą wynikać również z konfiguracji połączenia, ograniczeń zasobów lub problemu z samym klientem. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów, komputerów PC i ich podzespołów, a analiza API profilującego pozostaje zadaniem związanym z konkretnym silnikiem bazodanowym oraz jego dokumentacją.