Az SSIS Integration Runtime kezelésének 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 vállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésekig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyen!

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

Áttekintés

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

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űvelettel. Ha az újrapróbálkozás nem segít, lépjen kapcsolatba a Azure Data Factory támogatási csapatával.

Ellenkező esetben három fő külső függőség okozhat hibát: Azure SQL Adatbázis vagy Azure SQL Managed Instance, egyéni beállítási szkript és virtuális hálózati konfiguráció.

SQL Database vagy SQL Managed Instance problémák

SQL Database vagy SQL Managed Instance akkor van szükség, ha SSIS integrációs modult épít ki egy SSIS-katalógus-adatbázissal. Az SSIS integrációs modulnak hozzá kell tudnia férni SQL Database vagy SQL Managed Instance. Emellett a SQL Database vagy SQL Managed Instance bejelentkezési fiókjának engedéllyel kell rendelkeznie egy SSIS-katalógusadatbázis (SSISDB) létrehozásához. 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 a SQL Database vagy SQL Managed Instance 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 sikertelen volt a Microsoft Azure Active Directory- (Azure AD-) hitelesítés során (felügyelt identitás). Adja hozzá a gyár felügyelt identitását egy AAD-csoporthoz, és győződjön meg arról, hogy a felügyelt identitás rendelkezik hozzáférési engedélyekkel a katalógus adatbázis-kiszolgálójához.
• Kapcsolati időtúllépés. Ezt a hibát mindig egy biztonsággal kapcsolatos konfiguráció okozza. A következő megoldást javasoljuk:
  1. Hozzon létre új virtuális gépet.
  2. Csatlakozzon a virtuális géphez ugyanahhoz a Microsoft Azure Virtual Network integrációs modulhoz, ha az integrációs modul virtuális hálózaton található.
  3. Telepítse az SSMS-t, és ellenőrizze a SQL Database vagy SQL Managed Instance á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 a SQL Database vagy SQL Managed Instance támogatási csapathoz.

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 IR munkavégző csomópontja hozzáférjen SQL Database vagy SQL Managed Instance. Oldja fel az SSIS INTEGRÁCIÓS MODUL munkavégző csomópontjának blokkolását, hogy hozzáférhessen SQL Database vagy SQL Managed Instance.

CatalogCapacityLimitError

A következőhöz hasonló hibaüzenet jelenhet meg: "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ásokért tekintse meg a dokumentációt."

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őképpen:
  • A megőrzési időtartam és a projektverziók számának csökkentése.
  • A napló megőrzési időtartamának csökkentése.
  • A napló alapértelmezett szintjének módosítása.

CatalogDbBelongsToAnotherIR

Ez a hiba azt jelenti, SQL Database vagy SQL Managed Instance már rendelkezik SSISDB-vel, és hogy egy másik integrációs modul használja. Másik SQL Database vagy SQL Managed Instance kell megadnia, 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 a SQL Database vagy SQL Managed Instance támogatási csapathoz.

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 a SQL Database vagy SQL Managed Instance támogatási csapathoz.

InvalidCatalogDb

Az ilyen típusú hibaüzenetek a következőképpen néznek 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ésének hibái okoznak. Elvetheti a meglévő adatbázist SSISDB néven, vagy konfigurálhat egy új SQL Database vagy SQL Managed Instance 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 kapcsolatos 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. Ha az SSIS INTEGRÁCIÓS MODUL sikeresen elindul, és hálózati kapcsolati problémákba ütközik, megpróbálkozhat a kapcsolat diagnosztizálására szolgáló eszközzel . 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ózat-azonosító nincs engedélyezve az aktuális fiókhoz. A Microsoft.Batch erőforrás-szolgáltató nincs regisztrálva ugyanazon virtuális hálózat 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 Integration Runtime 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 csatlakoztatja a Azure-SSIS IR az Azure Virtual Network, 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ímekre 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 a Azure-SSIS IR 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ált ip-címet az Azure-SSIS Integration Runtime.	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 a Azure-SSIS IR.
A megadott statikus nyilvános IP-cím nem rendelkezik DNS-névvel, adjon meg közülük kettőt az Azure-SSIS Integration Runtime DNS-nevével.	Az alábbi képen látható módon beállíthatja a nyilvános IP-cím DNS-nevét a Azure Portal. A konkrét lépések a következők: (1) Nyissa meg a Azure Portal, és adja meg a nyilvános IP-cím erőforrásoldalát; (2) Válassza a Konfiguráció szakaszt, és állítsa be a DNS-nevet, majd kattintson a Mentés gombra; (3) Indítsa újra a Azure-SSIS IR.
Az Azure-SSIS Integration Runtime 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 a Azure-SSIS IR.
A megadott statikus nyilvános IP-cím alapszintű. Adjon meg két standard ip-címet az Azure-SSIS Integration Runtime.	Segítségért tekintse meg a nyilvános IP-cím termékváltozatait .

PublicIPResourceGroupLockedDuringStart

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

PublicIPResourceGroupLockedDuringStop

Ha leállítja Azure-SSIS IR, 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 erőforrás-törlési zárolás van az előfizetés vagy az erőforráscsoport (amely tartalmazza a statikus nyilvános IP-címet) szintjén. Távolítsa el a törlési zárolást, és indítsa újra az integrációs modult.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR rendszeres időközönként automatikusan frissül. A frissítés során új integrációs modul-csomó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) is törlődnek, és az új hálózati erőforrások az előfizetése 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). Távolítsa el a törlési zárolást, hogy eltávolíthassuk a régi csomópontokat, és feloldhassuk 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 az integrációs modul csomópontjainak azonnali létrehozására, a másikat pedig az integrációs modul frissítése során fogja használni a rendszer. 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 (InvalidPublicIPSpecified) című témakört.

Erőforrás-kezelés

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

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