A Futásidőnaplóval a sERPa rendszer által kiadott funkció műveletek (Funkcióindítás, Rögzítés) és SQL parancsok - valamint ezek végrehajtási időigénye - elemezhető. A funkció első sorban a fejlesztők számára hasznos a program optimalizálásakor.
Leírás
A Futásidőnapló elindítása
A Futásidőnapló a Nézet menüszalagról indítható:
Jogosultság
A funkciót rendszerfelügyelettel rendelkező felhasználóknak van jogosultságuk elindítani. Rendszerfelügyelettel nem rendelkező felhasználók esetében a funkció indítása PROGEN tanácsadói beavatkozást igényel. Ebben az esetben a funkció indításakor egy jelszó beviteli mezős párbeszéd ablak nyílik meg, amibe a megfelelő kód beírásakor indul el a funkció.
Eszközsáv
A Futásidőnapló ablakának tetején található egy eszközsáv az - a funkció kezeléséhez szükséges - alábbi gombokkal:
Start |
Szünet vagy leállítás után elindítja a naplózást, illetve az utóbbi esetben törli az eddigi tartalmat (naplózás közben a gomb nem engedélyezett). |
Szünet |
Szünetelteti a naplózást (a gomb csak naplózás közben van engedélyezve). |
Stop |
Megállítja a naplózást (a gomb csak naplózás közben és szüneteltetés alatt van engedélyezve). |
Mentés (Ctrl + S) |
A napló tartalmát txt fájlba menti oly módon, hogy a fájl végére hozzáteszi a névjegy tartalmát (naplózás közben a gomb nincs engedélyezve). |
Küldés |
A napló tartalmát e-mailbe másolja oly módon, hogy a szöveg végére hozzáteszi a névjegy tartalmát (naplózás közben a gomb nincs engedélyezve). |
Törlés |
Törli a napló tartalmát. |
Beállítások |
Megadható, hogy a naplózott utasításból maximálisan hány karakter kerüljön bele a naplóba. |
Súgó (F1) |
A súgót megnyitja az SQL-napló leírásánál. |
A napló elemei
Művelet kezdete
Az ilyen típusú sor jelzi a funkció művelet (Funkcióindítás, Rögzítés) kezdetét. A sortípus elemei az alábbiak:
-- |
A sor bevezető jelzése. |
#99 |
Az esemény sorszáma, mely összekapcsolja a művelet kezdetét a művelet befejezésével. |
[Funkció 99] |
Az esemény típusa (Funkció művelet) és a funkció - naplózáson belüli - sorszáma. |
Művelet kezdete: 9999-99-99 99:99:99.999 |
Az esemény pontos dátuma és időpontja. |
Összes eltelt idő: 99:99:99.999 |
A napló indításától eltelt idő. |
Példa:
-- #1 [SQL 1] Művelet kezdete: 2021-04-18 06:59:43.608, Összes eltelt idő: 00:00:04.665
Utasítás kiadva
Az ilyen típusú sor jelzi, hogy a sERPa rendszer egy SQL utasítást adott ki. A sortípus elemei az alábbiak:
-- |
A sor bevezető jelzése. |
#99 |
Az esemény sorszáma, mely összekapcsolja az utasítás kiadását az utasítás befejezésével. |
[SQL 99] |
Az esemény típusa (SQL utasítás) és az adatbáziskapcsolat - naplózáson belüli - sorszáma (nem az SPID). |
Utasítás kiadva: 9999-99-99 99:99:99.999 |
Az utasítás kiadásának pontos dátuma és időpontja. |
Összes eltelt idő: 99:99:99.999 |
A napló indításától eltelt idő. |
Várakozási idő: 99:99:99.999 |
A várakozási idő az előző utasítás befejezésétől a jelen utasítás kiadásáig eltelt időt mutatja. |
Összes várakozási idő: 99:99:99.999 |
Az összes várakozási idő, a napló indításától mért várakozási idők összege. Értéke a napló indításakor nulla. |
Példa:
-- #5 [SQL 1] Utasítás kiadva: 2021-04-18 06:59:43.608, Összes eltelt idő: 00:00:04.665, Várakozási idő: 00:00:00.018, Összes várakozási idő: 00:00:00.025
Művelet
A művelet típusú sor a művelet kezdete típusú sort követi, és a művelet leírását tartalmazza.
-- Funkcióindítás / Rögzítés: a funkció neve |
A művelet leírása. |
Példák:
-- Funkcióindítás: Kötésszám
-- Rögzítés: Kötésszám
Utasítás
Az utasítás típusú sor az utasítás kiadása típusú sort követi, és az alábbi elemei lehetnek:
-- Kapcsolódás: xxxxxxxxxxxxxxxx |
Az adatbázishoz kapcsolódás jelzése. A kettőspont után az adatbázis neve olvasható. A bevezető jelzés azért szerepel, mert nem ténylegesen kiadott SQL parancs. |
-- exec sp_setapprole |
Az alkalmazásszerep beállítása. A bevezető jelzés azért szerepel, mert hiányoznak a tárolt eljárás paraméterei annak érdekében, hogy ne derüljön ki az alkalmazásjelszó. |
tetszőleges SQL parancs |
A végrehajtásra kerülő SQL parancs |
-- Recordset #99 / 99 |
Ha több eredményhalmaza van egy tárolt eljárásnak, akkor ezek beolvasása a naplóban külön bejegyzésként szerepel. Az első szám az utasítás, a második az eredményhalmaz sorszáma. A bevezető jelzés azért szerepel, mert nem ténylegesen kiadott SQL parancs. |
Példák:
-- Kapcsolódás: sERPa_3_115
-- exec sp_setapprole
exec dbo.UrlapBeolvasas @Urlap_ID=NULL,@Adatnyelv_ID=NULL,@Datasets='Urlap,UrlapDefinicio'
-- Recordset #1 / 2
Művelet vége
A sortípus jelzi, hogy a művelet végrahajtásra került. Elemei az alábbiak:
-- |
A sor bevezető jelzése. |
#99 |
Az utasítás sorszáma, mely összekapcsolja az utasítás kiadását az utasítás befejezésével. |
[Funkció 99] |
Az esemény típusa (Funkció művelet) és a funkció - naplózáson belüli - sorszáma. |
Művelet vége: 9999-99-99 99:99:99.999 |
A művelet befejezésének pontos dátuma és időpontja. |
Összes eltelt idő: 99:99:99.999 |
A napló indításától eltelt idő. |
Művelet ideje: 99:99:99.999 |
A funkcióművelet kezdete és vége között eltelt idő. |
Példa:
-- #5 [Funkcio 3] Művelet vége: 2021-04-18 06:59:43.622, Összes eltelt idő: 00:00:04.679, Művelet ideje: 00:00:00.014
Utasítás befejezése
A sortípus jelzi, hogy a kiadott SQL utasítás végrahajtásra került. Az utasítások párhuzamosan is végrehajtásra kerülhetnek, tehát egy utasítás kiadása és utasítás típusú sort követhet egy másik utasítás kiadása az előzőleg kiadott utasítás befejezése előtt. A sortípus elemei az alábbiak:
-- |
A sor bevezető jelzése. |
#99 |
Az utasítás sorszáma, mely összekapcsolja az utasítás kiadását az utasítás befejezésével. |
[SQL 99] |
Az esemény típusa (SQL utasítás) és az adatbáziskapcsolat - naplózáson belüli - sorszáma (nem az SPID). |
Utasítás végrehajtva: 9999-99-99 99:99:99.999 |
Az utasítás végrehajtásának pontos dátuma és időpontja. |
Összes eltelt idő: 99:99:99.999 |
A napló indításától eltelt idő. |
Végrehajtási idő: 99:99:99.999 |
Az SQL parancs végrehajtásának időtartamát a program Execute elejétől a Terminate végéig méri. Ha a Fetchek között felhasználói beavatkozásra vár a program - például arra, hogy sort váltsanak a baloldali gridben - akkor az Execute végrehajtása után befejezi a program a mérést és kiírja: Az adatbeolvasás még tart. |
Összes végrehajtási idő: 99:99:99.999 |
Az összes végrehajtási idő a napló indításától mért végrehajtási idők összege. |
Példa:
-- #5 [SQL 1] Utasítás végrehajtva: 2021-04-18 06:59:43.622, Összes eltelt idő: 00:00:04.679, Végrehajtási idő: 00:00:00.014, Összes végrehajtási idő: 00:00:09.263
Példa az Futásidőnapló ablakra
A képen az Űrlap funkció elindításakor keletkező naplóbejegyzések láthatók:
Ablakok
Az ablakok részletes leírása ezeken a linkeken található:
