Vezérlőfolyamat hibakeresése

A következőkre vonatkozik:SQL Server SSIS integrációs futtatókörnyezet az Azure Data Factory-ban

Az SQL Server Data Tools (SSDT) és a Microsoft Integration Services olyan funkciókat és eszközöket tartalmaz, amelyekkel elháríthatja az integrációs szolgáltatások csomagjának vezérlési folyamatát.

• Az Integration Services támogatja a tárolók és feladatok töréspontjait.

• Az SSIS Designer futásidőben biztosítja a folyamatjelentést.

• Az SQL Server Data Tools (SSDT) hibakeresési ablakokat biztosít.

Breakpoints

Az SSIS Designer biztosítja a Töréspontok beállítása párbeszédpanelt, amelyben töréspontokat állíthat be a törési feltételek engedélyezésével, és megadhatja, hogy hányszor fordulhat elő töréspont a csomag végrehajtása előtt. A töréspontok a csomag szintjén vagy az egyes összetevők szintjén engedélyezhetők. Ha a feladat vagy a tároló szintjén engedélyezve vannak a törésfeltételek, a töréspont ikon a tevékenység vagy tároló mellett jelenik meg a Vezérlőfolyamat lap tervezési felületén. Ha a csomagban engedélyezve vannak a törési feltételek, a töréspont ikon megjelenik a Control Flow lap feliratán.

Töréspont elérésekor a töréspont ikonja megváltozik, így könnyebben azonosíthatja a töréspont forrását. A csomag futtatásakor töréspontokat adhat hozzá, törölhet és módosíthat.

Az Integration Services tíz törési feltételt biztosít, amelyeket minden tevékenységen és tárolón engedélyezhet. A Töréspontok beállítása párbeszédpanelen a töréspontokat a következő feltételekkel engedélyezheti:

Törési feltétel	Description
Amikor a feladat vagy tároló megkapja az OnPreExecute eseményt .	Akkor hívjuk meg, ha egy feladat éppen végrehajtásra készül. Ezt az eseményt egy tevékenység vagy egy tároló közvetlenül a futtatás előtt aktiválja.
Amikor a feladat vagy tároló megkapja az OnPostExecute eseményt .	Közvetlenül a feladat végrehajtási logikájának befejezése után hívjuk meg. Ezt az eseményt egy tevékenység vagy tároló közvetlenül a futtatás után aktiválja.
Amikor a feladat vagy tároló megkapja az OnError eseményt.	Hibás esemény esetén egy feladat vagy tároló hívódik meg.
Amikor a feladat vagy tároló megkapja az OnWarning eseményt .	Akkor hívható meg, ha a tevékenység olyan állapotban van, amely nem indokolja a hibát, de figyelmeztetést igényel.
Amikor a feladat vagy tároló megkapja az OnInformation eseményt .	Akkor hívjuk meg, ha a feladat szükséges az információk megadásához.
Amikor a feladat vagy tároló megkapja az OnTaskFailed eseményt .	A feladatgazda hívja meg, ha nem sikerül.
Amikor a tevékenység vagy tároló megkapja az OnProgress eseményt.	A feladatvégrehajtás haladásának frissítésére hívás érkezett.
Amikor a feladat vagy tároló megkapja az OnQueryCancel eseményt.	A feladatfeldolgozás során bármikor meghívható, amikor megszakíthatja a végrehajtást.
Amikor a feladat vagy tároló megkapja az OnVariableValueChanged eseményt .	Az Integration Services futtatókörnyezete hívja meg, amikor egy változó értéke megváltozik. A változó RaiseChangeEvent értékét igaz értékre kell állítani az esemény létrehozásához. **Figyelmeztetés** A törésponthoz társított változót a tároló hatókörében kell meghatározni. Ha a változó a csomag hatókörében van definiálva, a töréspont nem aktiválódik.
Amikor a feladat vagy tároló megkapja az OnCustomEvent eseményt.	Feladatok által meghívva egyéni, feladat által definiált eseményeket hozhat létre.

Az összes tevékenység és tároló számára elérhető törésfeltételek mellett egyes tevékenységek és tárolók speciális törési feltételeket is tartalmaznak a töréspontok beállításához. Engedélyezheti például a For Loop tároló törési feltételét, amely beállít egy töréspontot, amely felfüggeszti a végrehajtást a ciklus egyes iterációinak elején.

Ha rugalmasságot és teljesítményt szeretne hozzáadni egy törésponthoz, módosíthatja a töréspontok viselkedését az alábbi beállítások megadásával:

• A találatok száma vagy a megszakítási feltétel végrehajtásának maximális száma a végrehajtás felfüggesztése előtt.

• A találatszám típusa, vagy az a szabály, amely meghatározza, hogy a törésfeltétel mikor aktiválja a töréspontot.

Az Always típus kivételével a találatok száma tovább minősíti a találatok számát. Ha például a típus "Találatok száma egyenlő", és a találatok száma 5, a végrehajtás a törésállapot hatodik előfordulásakor függeszthető fel.

Az alábbi táblázat a találattípusokat ismerteti.

Találatszám típusa	Description
Mindig	A végrehajtás mindig fel van függesztve a töréspont elérésekor.
A találatok száma egyenlő	A végrehajtás felfüggesztésre kerül, ha a töréspont előfordulási száma megegyezik a találatok számával.
A találatok száma nagyobb vagy egyenlő, mint	A végrehajtás felfüggesztésre kerül, ha a töréspont előfordulási száma egyenlő vagy nagyobb, mint a találatok száma.
Találatok számának szorzója	A végrehajtás fel van függesztve, ha a találatok száma többszöröse következik be. Ha például ezt a beállítást 5 értékre állítja, a végrehajtás ötödször fel van függesztve.

Töréspontok beállítása

• Csomag hibakeresése töréspontok beállításával feladaton vagy tárolón

Állapotjelentés

Az SSIS Designer kétféle állapotjelentést tartalmaz: színkódolás a Control Flow lap tervezőfelületén, és folyamatüzenetek a Folyamat lapon.

Csomag futtatásakor az SSIS Designer az egyes tevékenységek vagy tárolók végrehajtási állapotát megjelenítő színnel jeleníti meg a végrehajtás előrehaladását. A szín alapján megállapíthatja, hogy az elem futásra vár-e, jelenleg fut, sikeresen befejeződött vagy sikertelenül ért véget. A csomag végrehajtásának leállítása után a színkódolás eltűnik.

Az alábbi táblázat a végrehajtási állapot ábrázolásához használt színeket ismerteti.

Szín	Végrehajtási állapot
Gray	Várakozás a futtatásra
Yellow	Running
Green	Sikeresen futott
Kiemelt	Hibákkal futtatva

A Folyamat lap a végrehajtási sorrendben felsorolja a tevékenységeket és a tárolókat, és tartalmazza a kezdési és befejezési időpontokat, a figyelmeztetéseket és a hibaüzeneteket. A csomagvégrehajtás leállítása után a végrehajtási eredmények lapon továbbra is elérhetők maradnak az állapotinformációk.

Megjegyzés:

Ha engedélyezni vagy letiltani szeretné az üzenetek megjelenítését a Folyamat lapon, váltson a Hibakeresési állapotjelentés beállításra az SSIS menüben.

Az alábbi ábrán a Folyamat lap látható.

Windows hibakeresése

Az SQL Server Data Tools (SSDT) számos olyan ablakot tartalmaz, amellyel töréspontokkal dolgozhat, és töréspontokat tartalmazó csomagokat is hibakeresésre használhat. Ha többet szeretne megtudni az egyes ablakokról, nyissa meg az ablakot, majd nyomja le az F1 billentyűt az ablak súgójának megjelenítéséhez.

Ha meg szeretné nyitni ezeket az ablakokat az SQL Server Data Tools (SSDT) alkalmazásban, kattintson a Hibakeresés menüre, mutasson a Windowsra, majd kattintson a Töréspontok, a Kimenet vagy az Azonnali parancsra.

Az alábbi táblázat az egyes ablakokat ismerteti.

Ablak	Description
Breakpoints	Felsorolja a csomag töréspontjait, és lehetővé teszi a töréspontok engedélyezését és törlését.
Kimenet	Állapotüzeneteket jelenít meg az SQL Server Data Tools (SSDT) funkcióihoz.
Azonnali	Kifejezések hibakeresésére és kiértékelésére, valamint változóértékek nyomtatására szolgál.

Csomag hibakeresése töréspontok beállításával feladaton vagy tárolón

Ez az eljárás bemutatja, hogyan állíthat be töréspontokat egy csomagban, feladatban, For Loop-tárolóban, Foreach Loop-tárolóban vagy szekvenciatárolóban.

Töréspontok beállítása csomagban, feladatban vagy tárolóban

1. Az SQL Server Data Tools (SSDT) alkalmazásban nyissa meg a kívánt csomagot tartalmazó Integration Services-projektet.

2. Kattintson duplán arra a csomagra, amelyben töréspontokat szeretne beállítani.

3. Az SSIS Designerben tegye a következőket:

   • Ha töréspontokat szeretne beállítani a csomagobjektumban, kattintson a Control Flow fülre, helyezze a kurzort a tervezőfelület hátterének tetszőleges pontjára, kattintson a jobb gombbal, majd kattintson a Töréspontok szerkesztése parancsra.

   • Ha töréspontokat szeretne beállítani egy csomagvezérlő folyamatában, kattintson a Vezérlőfolyamat fülre, kattintson a jobb gombbal egy feladatra, egy For Loop-tárolóra, egy Foreach-huroktárolóra vagy egy szekvenciatárolóra, majd kattintson a Töréspontok szerkesztése parancsra.

   • Ha töréspontokat szeretne beállítani egy eseménykezelőben, kattintson az Eseménykezelő fülre, kattintson a jobb gombbal egy feladatra, egy For Loop-tárolóra, egy Foreach-huroktárolóra vagy egy szekvenciatárolóra, majd kattintson a Töréspontok szerkesztése parancsra.

4. A Töréspontok <tárolónév> beállítása párbeszédpanelen válassza ki az engedélyezni kívánt töréspontokat.

5. Igény szerint módosítsa a találatok típusát és a találatok számát az egyes töréspontokhoz.

6. A csomag mentéséhez kattintson a Fájl menü Kijelölt elemek mentése parancsára.

Töréspontok beállítása

A Töréspontok beállítása párbeszédpanelen megadhatja azokat az eseményeket, amelyeken engedélyezni szeretné a töréspontokat, és szabályozhatja a töréspont viselkedését.

Beállítások

Engedélyezett
Válassza ki, hogy engedélyez egy töréspontot egy eseményhez.

Törési feltétel
Megtekintheti azoknak az elérhető eseményeknek a listáját, amelyeken töréspontokat szeretne beállítani.

Találatok számlálási típusa
Adja meg, hogy mikor lép érvénybe a töréspont.

Érték	Description
Mindig	A végrehajtás mindig fel van függesztve a töréspont elérésekor.
A találatok száma egyenlő	A végrehajtás felfüggesztésre kerül, ha a töréspont előfordulási száma megegyezik a találatok számával.
Nagyobb vagy egyenlő találat	A végrehajtás felfüggesztésre kerül, ha a töréspont előfordulási száma egyenlő vagy nagyobb, mint a találatok száma.
Találatok száma több	A végrehajtás fel van függesztve, ha a találatok száma többszöröse következik be. Ha például ezt a beállítást 5 értékre állítja, a végrehajtás ötödször fel van függesztve.

Találatok száma
Adja meg, hogy hányszor kell találatot elérni, hogy szünetet aktiváljon. Ez a beállítás nem érhető el, ha a töréspont mindig érvényben van.

Lásd még:

hibaelhárítási eszközei csomagfejlesztéshez
Szkript hibakeresése töréspontok beállításával szkriptfeladatban és szkriptösszetevőben