Sdílet prostřednictvím

Řešení potíží se správou prostředí SSIS Integration Runtime

  • Článek

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek obsahuje pokyny pro řešení potíží se správou v prostředí Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR), označované také jako SSIS IR.

Přehled

Pokud při zřizování nebo rušení zřizování prostředí SSIS IR narazíte na nějaký problém, zobrazí se na portálu Microsoft Azure Data Factory chybová zpráva nebo chyba vrácená rutinou PowerShellu. Chyba se vždy zobrazí ve formátu kódu chyby s podrobnou chybovou zprávou.

Pokud je kód chyby InternalServerError, služba má přechodné problémy a měli byste operaci zopakovat později. Pokud vám to nepomůže, obraťte se na tým podpory služby Azure Data Factory.

Jinak můžou tři hlavní externí závislosti způsobit chyby: Azure SQL Database nebo Azure SQL Managed Instance, vlastní instalační skript a konfigurace virtuální sítě.

Problémy se službou SQL Database nebo spravovanou instancí SQL

Pokud zřizujete prostředí SSIS IR s databází katalogu SSIS, vyžaduje se SQL Database nebo SQL Managed Instance. Prostředí SSIS IR musí mít přístup ke službě SQL Database nebo spravované instanci SQL. Přihlašovací účet pro SLUŽBU SQL Database nebo SQL Managed Instance musí mít také oprávnění k vytvoření databáze katalogu SSIS (SSISDB). Pokud dojde k chybě, na portálu služby Data Factory se zobrazí kód chyby s podrobnou zprávou o výjimce SQL. Při řešení potíží s jednotlivými kódy chyb využijte informace v následujícím seznamu.

AzureSqlConnectionFailure

K tomuto problému může dojít při zřizování nového prostředí SSIS IR nebo za běhu prostředí IR. Pokud k této chybě dojde při zřizování prostředí IR, můžete z chybové zprávy získat podrobnou zprávu o výjimce SQL, která značí jeden z následujících problémů:

  • Problém se síťovým připojením. Zkontrolujte, jestli je název hostitele pro službu SQL Database nebo sql Managed Instance přístupný. Ověřte také, že žádná brána firewall ani skupina zabezpečení sítě (NSG) neblokuje přístup prostředí SSIS IR k serveru.
  • Přihlášení selhalo během ověřování SQL. Zadaný účet se nemůže přihlásit k databázi SQL Serveru. Ujistěte se, že jste zadali správný uživatelský účet.
  • Přihlášení selhalo během ověřování Microsoft Entra ID (spravovaná identita). Přidejte spravovanou identitu vaší továrny do skupiny Microsoft Entra a ujistěte se, že spravovaná identita má přístupová oprávnění k databázovému serveru katalogu.
  • Vypršení časového limitu připojení. Příčinou této chyby je vždy konfigurace související se zabezpečením. Doporučujeme:
    1. Vytvořte nový virtuální počítač.
    2. Pokud je prostředí IR ve virtuální síti, připojte virtuální počítač ke stejné virtuální síti Microsoft Azure.
    3. Nainstalujte SSMS a zkontrolujte stav služby SQL Database nebo spravované instance SQL.

V případě jiných problémů opravte problém uvedený v podrobné chybové zprávě o výjimce SQL. Pokud stále máte problémy, obraťte se na tým podpory služby SQL Database nebo spravované instance SQL.

Pokud se při spuštění prostředí IR zobrazí chyba, pravděpodobně brání pracovnímu uzlu SSIS IR přístup ke službě SQL Database nebo spravované instanci SQL. Odblokujte pracovní uzel SSIS IR, aby mohl přistupovat ke službě SQL Database nebo spravované instanci SQL.

CatalogCapacityLimitError

Tento druh chybové zprávy může vypadat takto: Databáze SSISDB dosáhla kvóty velikosti. Rozdělte nebo odstraňte data, odstraňte indexy nebo si projděte dokumentaci, kde najdete možná řešení.

Mezi možná řešení patří:

  • Zvětšete velikost kvóty databáze SSISDB.
  • Změňte konfiguraci databáze SSISDB tak, aby se zmenšila velikost o:
    • Snížení doby uchovávání a počtu verzí projektu.
    • Snížení doby uchovávání protokolu.
    • Změna výchozí úrovně protokolu

CatalogDbBelongsToAnotherIR

Tato chyba znamená, že SQL Database nebo SQL Managed Instance už mají databázi SSISDB a že ji používá jiné prostředí IR. Musíte buď zadat jinou službu SQL Database nebo spravovanou instanci SQL, nebo odstranit stávající databázi SSISDB a restartovat nové prostředí IR.

CatalogDbCreationFailure

K této chybě může dojít z některého z následujících důvodů:

  • Uživatelský účet nakonfigurovaný pro prostředí SSIS IR nemá oprávnění k vytvoření databáze. Můžete uživateli udělit oprávnění k vytvoření databáze.
  • Při vytváření databáze dojde k vypršení časového limitu například spuštění nebo databázové operace. Operaci byste měli zopakovat později. Pokud opakování nefunguje, obraťte se na tým podpory služby SQL Database nebo spravované instance SQL.

V případě jiných problémů zkontrolujte chybovou zprávu o výjimce SQL a opravte problém uvedený v podrobnostech o chybě. Pokud stále máte problémy, obraťte se na tým podpory služby SQL Database nebo spravované instance SQL.

InvalidCatalogDb

Tento druh chybové zprávy vypadá takto: Neplatný název objektu catalog.catalog_properties. V této situaci už máte databázi s názvem SSISDB, ale nevytvořila ji prostředí SSIS IR, nebo je databáze v neplatném stavu, který způsobuje chyby při posledním zřizování prostředí SSIS IR. Existující databázi můžete odstranit s názvem SSISDB nebo můžete pro prostředí IR nakonfigurovat novou službu SQL Database nebo spravovanou instanci SQL.

Problémy s vlastním nastavením

Vlastní instalace nabízí rozhraní pro přidání vlastních pokynů k instalaci během zřizování a rekonfigurace prostředí SSIS IR. Další informace najdete v tématu Přizpůsobení instalace prostředí Azure-SSIS Integration Runtime.

Ujistěte se, že váš kontejner obsahuje pouze potřebné soubory vlastní instalace. Všechny soubory v kontejneru se stáhnou do pracovního uzlu prostředí SSIS IR. Před spuštěním skriptu vlastní instalace v prostředí SSIS IR doporučujeme skript otestovat na místním počítači a opravit případné problémy s jeho spuštěním.

Vzhledem k tomu, že se prostředí SSIS IR pravidelně aktualizuje, za běhu prostředí IR se zkontroluje kontejner se skriptem vlastní instalace. Tyto aktualizace vyžadují přístup ke kontejneru, aby bylo možné stáhnout skript vlastní instalace a znovu provést instalaci. V rámci tohoto procesu se také zkontroluje, jestli je kontejner dostupný a jestli existuje soubor main.cmd.

V případě jakékoli chyby, která zahrnuje vlastní instalaci, uvidíte kód chyby CustomSetupScriptFailure s dílčím kódem, jako je CustomSetupScriptBlobContainerInaccessible nebo CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Tato chyba znamená, že prostředí SSIS IR nemá přístup ke kontejneru objektů blob v Azure pro vlastní instalaci. Ujistěte se, že je identifikátor URI SAS kontejneru dostupný a že jeho platnost nevypršela.

Pokud je prostředí IR spuštěné, zastavte ho, nakonfigurujte v něm nový identifikátor URI SAS kontejneru vlastní instalace a pak ho restartujte.

CustomSetupScriptNotFound

Tato chyba znamená, že prostředí SSIS IR ve vašem kontejneru objektů blob nemůže najít skript vlastní instalace (main.cmd). Ujistěte se, že kontejner obsahuje soubor main.cmd, který je vstupním bodem pro vlastní instalaci.

CustomSetupScriptExecutionFailure

Tato chyba znamená, že selhalo spuštění skriptu vlastní instalace (main.cmd). Vyzkoušejte skript nejprve na místním počítači nebo zkontrolujte protokoly spuštění vlastní instalace v kontejneru objektů blob.

CustomSetupScriptTimeout

Tato chyba znamená, že došlo k vypršení časového limitu spuštění skriptu vlastní instalace. Ujistěte se, že je možné váš skript spustit bez upozornění a bez interaktivního vstupu, a také se ujistěte, že váš kontejner objektů blob obsahuje pouze potřebné soubory vlastní instalace. Doporučujeme nejdříve skript otestovat na místním počítači. Měli byste také zkontrolovat protokoly spuštění vlastní instalace v kontejneru objektů blob. Vlastní instalace může trvat maximálně 45 minut, pak dojde k vypršení časového limitu. Tato maximální doba zahrnuje čas potřebný ke stažení všech souborů z kontejneru a jejich instalaci v prostředí SSIS IR. Pokud potřebujete tuto dobu prodloužit, vytvořte lístek podpory.

CustomSetupScriptLogUploadFailure

Tato chyba znamená, že došlo k selhání při pokusu o nahrání protokolů spuštění vlastní instalace do kontejneru objektů blob. K tomuto problému dochází proto, že prostředí SSIS IR nemá oprávnění k zápisu do kontejneru objektů blob, nebo kvůli problémům se sítí nebo úložištěm. Pokud vlastní instalace proběhne úspěšně, tato chyba neovlivní fungování prostředí SSIS, ale nebudou k dispozici protokoly. Pokud vlastní instalace selže s jinou chybou a protokol se nenahraje, ohlásíme nejprve tuto chybu, aby bylo možné nahrát protokol k analýze. Jakmile se tento problém vyřeší, ohlásíme také všechny další konkrétní problémy. Pokud se tento problém nevyřeší opakovaným pokusem, kontaktujte tým podpory pro Azure Data Factory.

Konfigurace virtuální sítě

Když připojíte prostředí SSIS IR k virtuální síti Azure, SSIS IR bude využívat virtuální síť v rámci předplatného uživatele. Další informace najdete v tématu Připojení prostředí Azure-SSIS Integration Runtime k virtuální síti. Jakmile se prostředí SSIS IR úspěšně spustí, můžete se pokusit problém diagnostikovat pomocí nástroje pro diagnostiku připojení sami. Pokud dojde k problému, který souvisí s virtuální sítí, zobrazí se některá z následujících chyb.

InvalidVnetConfiguration

K této chybě může dojít z nejrůznějších důvodů. Informace o jejím řešení najdete v částech Forbidden, InvalidPropertyValue a MisconfiguredDnsServerOrNsgSettings.

Zakázáno

Tento druh chyby může vypadat takto: Pro aktuální účet není povolené ID podsítě. Poskytovatel prostředků Microsoft.Batch není zaregistrovaný ve stejném předplatném virtuální sítě."

Tyto podrobnosti znamenají, že služba Azure Batch nemá přístup k vaší virtuální síti. Zaregistrujte poskytovatele prostředků Microsoft.Batch ve stejném předplatném jako virtuální síť.

InvalidPropertyValue

Tento druh chyby může vypadat nějak takto:

  • "Zadaná virtuální síť neexistuje nebo k ní služba Batch nemá přístup."
  • Zadaná podsíť xxx neexistuje.

Tyto chyby znamenají, že virtuální síť neexistuje, služba Azure Batch k ní nemá přístup nebo neexistuje poskytovatel podsítě. Ujistěte se, že virtuální síť i podsíť existují a že k nim má služba Azure Batch přístup.

MisconfiguredDnsServerOrNsgSettings

Tento druh chybové zprávy může vypadat takto: Nepodařilo se zřídit prostředí Integration Runtime ve virtuální síti. Pokud je nakonfigurované nastavení serveru DNS nebo skupiny zabezpečení sítě, ujistěte se, že je server DNS přístupný a skupina zabezpečení sítě je správně nakonfigurovaná."

V této situaci pravděpodobně máte přizpůsobenou konfiguraci nastavení serveru DNS nebo skupiny zabezpečení sítě, což brání překladu názvu serveru Azure, který vyžaduje prostředí SSIS IR, nebo přístupu k tomuto serveru. Další informace najdete v tématu Konfigurace virtuální sítě SSIS IR. Pokud stále máte problémy, obraťte se na tým podpory pro Azure Data Factory.

VNetResourceGroupLockedDuringUpgrade

Prostředí SSIS IR se pravidelně automaticky aktualizuje. Během upgradu se vytvoří nový fond služby Azure Batch a starý fond služby Azure Batch se odstraní. Odstraní se také prostředky související s virtuální sítí pro starý fond a ve vašem předplatném se vytvoří nové prostředky související s virtuální sítí. Tato chyba znamená, že došlo k selhání odstranění prostředků souvisejících s virtuální sítí pro starý fond kvůli zámku proti odstranění na úrovni předplatného nebo skupiny prostředků. Vzhledem k tomu, že zámek proti odstranění řídí a nastavuje zákazník, musí ho v této situaci odstranit.

VNetResourceGroupLockedDuringStart

Pokud selže zřizování prostředí SSIS IR, všechny vytvořené prostředky se odstraní. Pokud je však na úrovni předplatného nebo skupiny prostředků zámek proti odstranění prostředků, k očekávanému odstranění prostředků virtuální sítě nedojde. Pokud chcete tuto chybu opravit, odeberte zámek proti odstranění a restartujte prostředí IR.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Když zastavíte prostředí SSIS IR, všechny prostředky související s virtuální sítí se odstraní. Odstranění ale může selhat, pokud je na úrovni předplatného nebo skupiny prostředků zámek proti odstranění prostředků. Také v tomto případě zámek proti odstranění řídí a nastavuje zákazník. Proto musí zámek proti odstranění odebrat a pak znovu zastavit prostředí SSIS IR.

NodeUnavailable

K této chybě dochází, když je prostředí IR spuštěné, a znamená, že prostředí IR přešlo do špatného stavu. Tato chyba je vždy způsobená změnou v konfiguraci serveru DNS nebo skupiny zabezpečení sítě, která brání prostředí SSIS IR v připojení k potřebné službě. Vzhledem k tomu, že konfiguraci serveru DNS a skupiny zabezpečení sítě řídí zákazník, musí zákazník opravit blokující problémy na své straně. Další informace najdete v tématu Konfigurace virtuální sítě SSIS IR. Pokud stále máte problémy, obraťte se na tým podpory pro Azure Data Factory.

Konfigurace statických veřejných IP adres

Když připojíte Prostředí Azure-SSIS IR k Azure Virtual Network, můžete také použít vlastní statické veřejné IP adresy pro prostředí IR, aby prostředí IR mohlo přistupovat ke zdrojům dat, které omezují přístup na konkrétní IP adresy. Další informace najdete v tématu Připojení prostředí Azure-SSIS Integration Runtime k virtuální síti.

Kromě výše uvedenýchproblémůch Nápovědu najdete v následujících chybách.

Zadaný neplatný typPublicIP

K této chybě může dojít z různých důvodů při spuštění prostředí Azure-SSIS IR:

Chybová zpráva Řešení
Za předpokladu, že se už používá statická veřejná IP adresa, zadejte dvě nepoužité pro prostředí Azure-SSIS Integration Runtime. Měli byste vybrat dvě nepoužívané statické veřejné IP adresy nebo odebrat aktuální odkazy na zadanou veřejnou IP adresu a pak restartovat Azure-SSIS IR.
Za předpokladu, že statická veřejná IP adresa nemá žádný název DNS, zadejte dva z nich s názvem DNS pro prostředí Azure-SSIS Integration Runtime. Název DNS veřejné IP adresy můžete nastavit na webu Azure Portal, jak je znázorněno na následujícím obrázku. Konkrétní kroky jsou následující: (1) Otevřete Azure Portal a na stránce prostředku této veřejné IP adresy. (2) Vyberte část Konfigurace a nastavte název DNS a potom klikněte na tlačítko Uložit ; (3) Restartujte prostředí Azure-SSIS IR.
Poskytnutá virtuální síť a statické veřejné IP adresy pro prostředí Azure-SSIS Integration Runtime musí být ve stejném umístění. Podle požadavků sítě Azure by měla být statická veřejná IP adresa a virtuální síť ve stejném umístění a předplatném. Zadejte dvě platné statické veřejné IP adresy a restartujte prostředí Azure-SSIS IR.
Za předpokladu, že statická veřejná IP adresa je základní ip adresa, zadejte dvě standardní ip adresy pro prostředí Azure-SSIS Integration Runtime. Nápovědu najdete v SKU veřejné IP adresy .

Prostředí Azure-SSIS IR

PublicIPResourceGroupLockedDuringStart

Pokud zřizování Azure-SSIS IR selže, odstraní se všechny vytvořené prostředky. Pokud je však zámek odstranění prostředku na úrovni předplatného nebo skupiny prostředků (která obsahuje vaši statickou veřejnou IP adresu), síťové prostředky se neodstraní podle očekávání. Pokud chcete chybu opravit, odeberte zámek odstranění a restartujte prostředí IR.

PublicIPResourceGroupLockedDuringStop

Když azure-SSIS IR zastavíte, odstraní se všechny síťové prostředky vytvořené ve skupině prostředků obsahující vaši veřejnou IP adresu. Odstranění ale může selhat, pokud existuje zámek odstranění prostředku na úrovni předplatného nebo skupiny prostředků (která obsahuje vaši statickou veřejnou IP adresu). Odeberte zámek odstranění a restartujte prostředí IR.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR se pravidelně aktualizuje automaticky. Nové uzly IR se vytvoří během upgradu a staré uzly se odstraní. Také se odstraní vytvořené síťové prostředky (např. nástroj pro vyrovnávání zatížení a skupina zabezpečení sítě) pro staré uzly a nové síťové prostředky se vytvoří v rámci vašeho předplatného. Tato chyba znamená, že odstranění síťových prostředků pro staré uzly selhalo kvůli zámku odstranění na úrovni předplatného nebo skupiny prostředků (která obsahuje vaši statickou veřejnou IP adresu). Odeberte zámek odstranění, abychom mohli staré uzly vyčistit a uvolnit statickou veřejnou IP adresu pro staré uzly. Jinak nejde uvolnit statickou veřejnou IP adresu a nebudeme moct vaše prostředí IR dál upgradovat.

PublicIPNotUsableDuringUpgrade

Pokud chcete použít vlastní statické veřejné IP adresy, měli byste zadat dvě veřejné IP adresy. Jeden z nich se použije k okamžitému vytvoření uzlů IR a druhý se použije během upgradu prostředí IR. K této chybě může dojít v případě, že ostatní veřejná IP adresa je během upgradu nepoužitelná. Informace o možných příčinách najdete v části InvalidPublicIP Zadané .

Řízení zdrojů

Značka prostředku se neaktualizovala

Značky můžete použít u prostředků Azure a logicky je uspořádat do taxonomie. Když je prostředí SSIS IR spuštěné, změny nadřazených značek datové továrny SSIS IR nebudou platit, dokud se prostředí SSIS IR nerestartuje.