SSIS integrációs futásidő-kezelés hibaelhárítása

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk hibaelhárítási útmutatást nyújt az Azure-SQL Server Integration Services (SSIS) integrációs modul (IR) felügyeleti problémáihoz, más néven SSIS IR-hez.

Áttekintés

Ha az SSIS IR kiépítése vagy megszüntetése során bármilyen probléma merül fel, hibaüzenet jelenik meg a Microsoft Azure Data Factory portálján, vagy egy PowerShell-parancsmagból visszaadott hiba. A hiba mindig hibakód formátumban jelenik meg részletes hibaüzenettel.

Ha a hibakód InternalServerError, a szolgáltatás átmeneti problémákkal rendelkezik, és később újra meg kell próbálkoznia a műveletet. Ha az újrapróbálkozás nem segít, forduljon az Azure Data Factory támogatási csapatához.

Ellenkező esetben három fő külső függőség okozhat hibát: Azure SQL Database vagy Felügyelt Azure SQL-példány, egyéni beállítási szkript és virtuális hálózati konfiguráció.

SQL Database- vagy felügyelt SQL-példányokkal kapcsolatos problémák

Az SQL Database vagy a felügyelt SQL-példányra akkor van szükség, ha SSIS integrációs modult épít ki egy SSIS-katalógusadatbázissal. Az SSIS integrációs modulnak hozzá kell tudnia férni az SQL Database-hez vagy a felügyelt SQL-példányhoz. Emellett az SQL Database vagy a felügyelt SQL-példány bejelentkezési fiókjának rendelkeznie kell SSIS-katalógusadatbázis (SSISDB) létrehozásához szükséges engedéllyel. Ha hiba történik, a Data Factory portálján megjelenik a hibakód és egy, az SQL-kivétellel kapcsolatos részletes üzenet. Az alábbi listában található információkkal értelmezheti a hibakódokat.

AzureSqlConnectionFailure

Ezt a hibát akkor láthatja, ha új SSIS IR-t helyez üzembe, vagy miközben az IR fut. Ha ezt a hibát az IR üzembe helyezése során tapasztalja, akkor az SQL-kivétellel kapcsolatos részletes üzenetet találhat a hibaüzenetben, amely a következő problémák valamelyikét jelzi:

• Hálózati kapcsolati hiba. Ellenőrizze, hogy az SQL Database vagy a felügyelt SQL-példány gazdagépneve elérhető-e. Azt is ellenőrizze, hogy nem blokkolja-e tűzfal vagy hálózati biztonsági csoport (NSG) az SSIS IR-t a kiszolgáló elérése során.
• A bejelentkezés sikertelen volt az SQL-hitelesítés során. A megadott fiókkal nem lehet bejelentkezni az SQL Server-adatbázisba. Ügyeljen rá, hogy helyes felhasználói fiókot adjon meg.
• A bejelentkezés a Microsoft Entra-azonosító hitelesítése (felügyelt identitás) során meghiúsult. Adja hozzá a gyár felügyelt identitását egy Microsoft Entra-csoporthoz, és győződjön meg arról, hogy a felügyelt identitás rendelkezik hozzáférési engedélyekkel a katalógusadatbázis-kiszolgálóhoz.
• Kapcsolati időtúllépés. Ezt a hibát mindig egy biztonsággal kapcsolatos konfiguráció okozza. Javasoljuk, hogy:
  1. Hozzon létre új virtuális gépet.
  2. Csatlakozzon a virtuális géphez ugyanahhoz az integrációs modulhoz, ha az integrációs modul virtuális hálózatban van.
  3. Telepítse az SSMS-t, és ellenőrizze az SQL Database vagy a felügyelt SQL-példány állapotát.

Egyéb problémák esetén javítsa ki az SQL-kivétellel kapcsolatos részletes hibaüzenetben látható hibát. Ha továbbra is problémákat tapasztal, forduljon az SQL Database vagy az SQL Managed Instance támogatási csapatához.

Ha az integrációs modul futtatásakor hibaüzenet jelenik meg, a hálózati biztonsági csoport vagy a tűzfal módosításai valószínűleg megakadályozzák, hogy az SSIS INTEGRÁCIÓS MODUL feldolgozó csomópontja hozzáférjen az SQL Database-hez vagy a felügyelt SQL-példányhoz. Oldja fel az SSIS integrációs modul feldolgozó csomópontjának letiltását, hogy hozzáférhessen az SQL Database-hez vagy a felügyelt SQL-példányhoz.

CatalogCapacityLimitError

Az ilyen típusú hibaüzenetek a következőképpen nézhetnek ki: "Az "SSISDB" adatbázis elérte a méretkvótát. Adatok particionálása vagy törlése, indexek elvetése, vagy a lehetséges megoldásokat a dokumentációban találja."

A lehetséges megoldások a következők:

• Növelje az SSISDB kvótaméretét.
• Módosítsa az SSISDB konfigurációját a méret csökkentéséhez a következő lépéssel:
  • A megőrzési időszak és a projektverziók számának csökkentése.
  • A napló megőrzési idejének csökkentése.
  • A napló alapértelmezett szintjének módosítása.

CatalogDbBelongsToAnotherIR

Ez a hiba azt jelenti, hogy az SQL Database vagy a felügyelt SQL-példány már rendelkezik SSISDB-vel, és azt egy másik integrációs modul használja. Meg kell adnia egy másik SQL Database-t vagy felügyelt SQL-példányt, vagy törölnie kell a meglévő SSISDB-t, és újra kell indítania az új integrációs modult.

CatalogDbCreationFailure

Ez a hiba a következő okok valamelyike miatt jelentkezhet:

• Az SSIS IR-hez konfigurált felhasználói fiók nem rendelkezik engedéllyel az adatbázis létrehozásához. Engedélyt adhat a felhasználónak az adatbázis létrehozásához.
• Időtúllépés (például végrehajtási időtúllépés vagy adatbázis-műveleti időtúllépés) történik az adatbázis létrehozása során. Próbálja meg később újra végrehajtani a műveletet. Ha az újrapróbálkozás nem működik, forduljon az SQL Database vagy az SQL Managed Instance támogatási csapatához.

Egyéb problémák esetén tekintse meg az SQL-kivétel hibaüzenetét, és javítsa ki a hiba részleteiben szereplő problémát. Ha továbbra is problémákat tapasztal, forduljon az SQL Database vagy az SQL Managed Instance támogatási csapatához.

InvalidCatalogDb

Az ilyen típusú hibaüzenet a következőképpen néz ki: "Érvénytelen objektumnév : "catalog.catalog_properties". Ebben az esetben vagy már rendelkezik egy SSISDB nevű adatbázissal, de nem az SSIS IR hozta létre, vagy az adatbázis érvénytelen állapotban van, amelyet az SSIS integrációs modul legutóbbi kiépítése során fellépő hibák okoznak. Elvetheti a meglévő adatbázist SSISDB néven, vagy konfigurálhat egy új SQL Database-t vagy felügyelt SQL-példányt az integrációs modulhoz.

Egyéni beállítási problémák

Az egyéni telepítés során használható felülten hozzáadhatja saját telepítési lépései az SSIS IR üzembe helyezése vagy újrakonfigurálása során. További információ: Az Azure SSIS IR telepítésének testreszabása.

Győződjön meg arról, hogy a tároló csak a szükséges egyéni telepítőfájlokat tartalmazza; a tároló összes fájlja le lesz töltve az SSIS IR feldolgozó csomópontjára. Azt javasoljuk, hogy a szkript az SSIS IR-ban való futtatása előtt tesztelje az egyéni telepítési szkriptet egy helyi gépen a szkriptvégrehajtási hibák javítása érdekében.

Az egyéni telepítési szkripttárolót a rendszer az integrációs modul futása közben ellenőrzi, mivel az SSIS IR rendszeresen frissül. Ennek a frissítésnek hozzá kell férnie a tárolóhoz az egyéni telepítési szkript letöltéséhez és újratelepítéséhez. A folyamat azt is ellenőrzi, hogy a tároló elérhető-e, illetve hogy létezik-e a main.cmd fájl.

Az egyéni beállítással járó hibák esetén megjelenik egy CustomSetupScriptFailure hibakód, amely olyan alkódot tartalmaz, mint a CustomSetupScriptBlobContainerInaccessible vagy a CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Ez a hiba azt jelenti, hogy az SSIS IR nem fér hozzá az Azure Blob-tárolóhoz az egyéni telepítés céljából. Győződjön meg róla, hogy a tároló SAS URI-ja elérhető és érvényes.

Ha az integrációs modul fut, állítsa le, konfigurálja újra az új egyéni telepítési tároló SAS URI-jával, majd indítsa újra.

CustomSetupScriptNotFound

Ez a hiba azt jelenti, hogy az SSIS IR nem talál egyéni telepítési szkriptet (main.cmd) a blobtárolóban. Győződjön meg arról, hogy a main.cmd létezik a tárolóban, amely belépési pontként szolgál az egyéni telepítéshez.

CustomSetupScriptExecutionFailure

Ez a hiba azt jelenti, hogy az egyéni telepítési szkript (main.cmd) végrehajtása sikertelen volt. Először próbálja ki a helyi gépén a szkriptet, vagy ellenőrizze az egyéni telepítés végrehajtási naplóit a blobtárolóban.

CustomSetupScriptTimeout

Ez a hiba az egyéni telepítési szkript végrehajtásának időtúllépését jelzi. Győződjön meg arról, hogy a szkript végrehajtható csendes módban, felhasználói beavatkozás nélkül, és hogy a blobtároló csak a szükséges egyéni telepítési fájlokat tartalmazza. Javasoljuk, hogy a szkriptet először tesztelje a helyi számítógépen. Az egyéni telepítés végrehajtási naplóit is ellenőriznie kell a blobtárolóban. Az egyéni telepítés maximális időtartama 45 perc, mielőtt időtúllépés történik, amely magában foglalja az összes fájl a tárolóból való letöltéséhez, majd az SSIS IR-ban való telepítéséhez szükséges időt is. Ha hosszabb időre van szüksége, hozzon létre egy támogatási jegyet.

CustomSetupScriptLogUploadFailure

Ez a hiba azt jelenti, hogy az egyéni telepítés végrehajtási naplóinak a blobtárolóba való feltöltésére tett kísérlet sikertelen volt. Ez a probléma akkor fordul elő, ha a SSIS IR nem rendelkezik írási engedéllyel a blobtárolóhoz, vagy ha tárolási vagy hálózati problémák állnak fenn. Ha az egyéni telepítés sikeres, a hiba nem befolyásolja a SSIS működését, de a naplók hiányozni fognak. Ha az egyéni telepítés egy másik hiba miatt meghiúsul, és a napló nincs feltöltve, ezt a hibát jelentjük először, hogy a naplót fel lehessen tölteni az elemzéshez. Emellett a probléma megoldása után minden további konkrét problémát jelenteni fogunk. Ha ez a probléma nem oldódik meg az újrapróbálkozás után, lépjen kapcsolatba az Azure Data Factory támogatási csapatával.

Virtuális hálózati konfiguráció

Amikor az SSIS integrációs modult az Azure Virtual Networkhöz csatlakoztatja, a SSIS IR a felhasználói előfizetéshez tartozó virtuális hálózatot használja. További információért tekintse meg az Azure-SSIS IR virtuális hálózathoz történő csatlakoztatásával foglalkozó cikket. Az SSIS integrációs modul sikeres elindítása után, ha hálózati csatlakozási problémákba ütközik, megpróbálhatja diagnosztizálni a kapcsolati eszközt a probléma diagnosztizálásához. Ha virtuális hálózattal kapcsolatos probléma jelentkezik, az alábbi hibák egyike jelenik meg.

InvalidVnetConfiguration

Ennek a hibának több különböző okból jelentkezhet. A hiba elhárításához tekintse meg a Forbidden, az InvalidPropertyValue és a MisconfiguredDnsServerOrNsgSettings szakaszt.

Forbidden

Ez a hiba a következőhöz hasonló lehet: "Az alhálózati azonosító nincs engedélyezve az aktuális fiókhoz. A Microsoft.Batch erőforrás-szolgáltató nincs regisztrálva a virtuális hálózat ugyanazon előfizetésében."

Ezek a részletek azt jelentik, hogy az Azure Batch nem fér hozzá a virtuális hálózathoz. Regisztrálja a Microsoft.Batch erőforrás-szolgáltatót ugyanabban az előfizetésében, amelybe a virtuális hálózat is tartozik.

InvalidPropertyValue

Az ilyen típusú hiba az alábbiakhoz lehet hasonló:

• "A megadott virtuális hálózat nem létezik, vagy a Batch szolgáltatás nem rendelkezik hozzáféréssel."
• "A megadott xxx alhálózat nem létezik."

Ezek a hibák azt jelentik, hogy a virtuális hálózat nem létezik, az Azure Batch szolgáltatás nem fér hozzá, vagy a megadott alhálózat nem létezik. Győződjön meg arról, hogy a virtuális hálózat és az alhálózat létezik, illetve hogy az Azure Batch hozzájuk tud férni.

MisconfiguredDnsServerOrNsgSettings

Ez a hibaüzenet a következőhöz hasonló lehet: "Nem sikerült kiépíteni az integrációs modult a virtuális hálózaton. Ha a DNS-kiszolgáló vagy az NSG beállításai konfigurálva vannak, győződjön meg arról, hogy a DNS-kiszolgáló elérhető, és az NSG megfelelően van konfigurálva."

Ebben az esetben valószínűleg egyéni konfigurációt alkalmazott a DNS-kiszolgáló vagy a hálózati biztonsági csoport beállításait illetően, amely megakadályozza az SSIS IR által igényelt Azure-kiszolgálónév feloldását vagy elérését. További információ: Az SSIS IR virtuális hálózatának konfigurálása. Ha továbbra is problémákat tapasztal, lépjen kapcsolatba az Azure Data Factory támogatási csapatával.

VNetResourceGroupLockedDuringUpgrade

Az SSIS IR rendszeres időközönként automatikusan frissül. A frissítés során létrejön egy új Azure Batch-készlet, a régi Azure Batch-készlet pedig törlődik. A régi készlet virtuális hálózathoz kapcsolódó erőforrásait is törli a rendszer, az új virtuális hálózathoz kapcsolódó erőforrások pedig az előfizetése alatt jönnek létre. Ez a hiba azt jelenti, hogy az előfizetés vagy az erőforráscsoport szintjén érvényben lévő törlési zárolás miatt nem sikerült törölni a régi készlet virtuális hálózathoz kapcsolódó erőforrásait. Mivel az ügyfél szabályozza és állítja be a törlési zárolást, ilyen esetben neki kell eltávolítania a törlési zárolást.

VNetResourceGroupLockedDuringStart

Ha az SSIS IR üzembe helyezése meghiúsul, a rendszer az összes létrehozott erőforrást törli. Ha viszont van egy erőforrástörlési zárolás az előfizetés vagy az erőforráscsoport szintjén, a virtuális hálózat erőforrásai nem törlődnek a várt módon. A hiba kijavításához oldja fel a törlési zárolást, majd indítsa újra az integrációs modult.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Ha leállítja a SSIS IR-t, a rendszer a virtuális hálózathoz kapcsolódó összes erőforrást törli. A törlés azonban meghiúsulhat, ha előfizetés vagy az erőforráscsoport szintjén erőforrástörlési zárolás van életben. Itt is az ügyfél szabályozza és állítja be a törlési zárolást. Ezért el kell távolítaniuk a törlési zárolást, majd újra le kell állítaniuk a SSIS IR-t.

NodeUnavailable

Ez a hiba akkor fordul elő, ha az integrációs modul fut, és azt jelenti, hogy az integrációs modul állapota nem megfelelő. Ezt a hibát mindig a DNS-kiszolgáló vagy a hálózati biztonsági csoport konfigurációjának változása okozza, amely blokkolja a SSIS IR-t a szükséges szolgáltatáshoz való csatlakozáskor. Mivel a DNS-kiszolgáló és a hálózati biztonsági csoport konfigurációját az ügyfél szabályozza, az ügyfélnek kell kijavítania a blokkolást okozó problémákat a saját oldaláról. További információ: Az SSIS IR virtuális hálózatának konfigurálása. Ha továbbra is problémákat tapasztal, lépjen kapcsolatba az Azure Data Factory támogatási csapatával.

Statikus nyilvános IP-címek konfigurálása

Amikor csatlakozik az Azure-SSIS integrációs modulhoz az Azure Virtual Networkhez, saját statikus nyilvános IP-címeket is használhat az integrációs modulhoz, hogy az integrációs modul hozzáférhessen azokhoz az adatforrásokhoz, amelyek bizonyos IP-címekhez korlátozzák a hozzáférést. További információért tekintse meg az Azure-SSIS IR virtuális hálózathoz történő csatlakoztatásával foglalkozó cikket.

A fenti virtuális hálózati problémák mellett statikus nyilvános IP-címekkel kapcsolatos problémákat is tapasztalhat. Segítségért tekintse meg az alábbi hibákat.

InvalidPublicIPSpecified

Ez a hiba többféle okból is előfordulhat az Azure-SSIS integrációs modul indításakor:

Hibaüzenet	Megoldás
A megadott statikus nyilvános IP-cím már használatban van, adjon meg két nem használtat az Azure-SSIS integrációs modulhoz.	Jelöljön ki két nem használt statikus nyilvános IP-címet, vagy távolítsa el a megadott nyilvános IP-címre mutató aktuális hivatkozásokat, majd indítsa újra az Azure-SSIS integrációs modult.
A megadott statikus nyilvános IP-cím nem rendelkezik DNS-névvel, kérjük, adjon meg kettő dns-nevet az Azure-SSIS integrációs modulhoz.	Az Alábbi képen látható módon beállíthatja a nyilvános IP-cím DNS-nevét az Azure Portalon. A konkrét lépések a következők: (1) Nyissa meg az Azure Portalt, és adja meg ennek a nyilvános IP-címnek az erőforrásoldalát; (2) Válassza ki a Konfiguráció szakaszt, és állítsa be a DNS-nevet, majd kattintson a Mentés gombra; (3) Indítsa újra az Azure-SSIS integrációs modult.
Az Azure-SSIS integrációs modulhoz megadott virtuális hálózatnak és statikus nyilvános IP-címeknek ugyanazon a helyen kell lenniük.	Az Azure Network követelményei szerint a statikus nyilvános IP-címnek és a virtuális hálózatnak ugyanabban a helyen és előfizetésben kell lennie. Adjon meg két érvényes statikus nyilvános IP-címet, és indítsa újra az Azure-SSIS integrációs modult.
A megadott statikus nyilvános IP-cím alapszintű, kérjük, adjon meg két szabványosat az Azure-SSIS integrációs modulhoz.	Segítségért tekintse meg a nyilvános IP-cím termékváltozatait.

PublicIPResourceGroupLockedDuringStart

Ha az Azure-SSIS integrációs modul kiépítése sikertelen, a rendszer törli az összes létrehozott erőforrást. Ha azonban az előfizetés vagy az erőforráscsoport (amely tartalmazza a statikus nyilvános IP-címet) szintjén van erőforrás-törlési zárolás, a hálózati erőforrások nem lesznek a várt módon törölve. A hiba kijavításához távolítsa el a törlési zárolást, és indítsa újra az integrációs modult.

PublicIPResourceGroupLockedDuringStop

Az Azure-SSIS integrációs modul leállításakor a nyilvános IP-címet tartalmazó erőforráscsoportban létrehozott összes hálózati erőforrás törlődik. A törlés azonban meghiúsulhat, ha az előfizetés vagy az erőforráscsoport (amely tartalmazza a statikus nyilvános IP-címet) szintjén van erőforrás-törlési zárolás. Távolítsa el a törlési zárolást, és indítsa újra az integrációs modult.

PublicIPResourceGroupLockedDuringUpgrade

Az Azure-SSIS integrációs modul rendszeres időközönként automatikusan frissül. A frissítés során új integrációs modulcsomópontok jönnek létre, és a régi csomópontok törlődnek. Emellett a régi csomópontokhoz létrehozott hálózati erőforrások (például a terheléselosztó és a hálózati biztonsági csoport) törlődnek, és az új hálózati erőforrások az előfizetés alatt jönnek létre. Ez a hiba azt jelenti, hogy a régi csomópontok hálózati erőforrásainak törlése meghiúsult az előfizetés vagy erőforráscsoport törlési zárolása miatt (amely tartalmazza a statikus nyilvános IP-címet) szintjén. Távolítsa el a törlési zárolást, hogy megtisztíthassuk a régi csomópontokat, és felszabadíthassuk a régi csomópontok statikus nyilvános IP-címét. Ellenkező esetben a statikus nyilvános IP-cím nem adható ki, és nem tudjuk tovább frissíteni az integrációs modult.

PublicIPNotUsableDuringUpgrade

Ha saját statikus nyilvános IP-címeket szeretne használni, két nyilvános IP-címet kell megadnia. Az egyiket a rendszer azonnal létrehozza az integrációs modul csomópontjait, a másikat pedig az integrációs modul frissítése során. Ez a hiba akkor fordulhat elő, ha a másik nyilvános IP-cím nem használható a frissítés során. A lehetséges okokért tekintse meg az InvalidPublicIPSpecified fájlt.

Erőforrás-kezelés

Az erőforráscímke nem frissült

Címkéket alkalmazhat az Azure-erőforrásokra, hogy logikusan rendszerezze őket egy osztályozásba. Amíg az SSIS integrációs modul fut, az SSIS IR szülőadat-előállító címkéinek módosítása nem lép érvénybe, amíg az SSIS IR újra nem indul.