Problemen met SSIS Integration Runtime-beheer oplossen

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Dit artikel bevat richtlijnen voor het oplossen van problemen met beheer in Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR), ook wel bekend als SSIS IR.

Overzicht

Als er een probleem optreedt tijdens het inrichten of ongedaan maken van de inrichting van SSIS IR, ziet u een foutbericht in de Microsoft Azure Data Factory-portal of een fout die is geretourneerd vanuit een PowerShell-cmdlet. De fout wordt altijd weergegeven in de indeling van een foutcode met een gedetailleerd foutbericht.

Als de foutcode InternalServerError is, heeft de service tijdelijke problemen en moet u de bewerking later opnieuw uitvoeren. Als een nieuwe poging niet helpt, neemt u contact op met het ondersteuningsteam van Azure Data Factory.

Anders kunnen drie belangrijke externe afhankelijkheden fouten veroorzaken: Azure SQL Database of Azure SQL Managed Instance, een aangepast installatiescript en een configuratie van een virtueel netwerk.

Problemen met SQL Database of SQL Managed Instance

SQL Database of SQL Managed Instance is vereist als u SSIS IR inricht met een SSIS-catalogusdatabase. De SSIS IR moet toegang hebben tot SQL Database of SQL Managed Instance. Het aanmeldingsaccount voor SQL Database of SQL Managed Instance moet ook gemachtigd zijn om een SSIS-catalogusdatabase (SSISDB) te maken. Als er een fout optreedt, wordt een foutcode met een gedetailleerd SQL-uitzonderingsbericht weergegeven in de Data Factory-portal. Gebruik de informatie in de volgende lijst om de problemen met de foutcodes op te lossen.

AzureSqlConnectionFailure

U kunt dit probleem tegenkomen wanneer u een nieuwe SSIS IR inricht of wanneer IR wordt uitgevoerd. Als u deze fout tijdens het inrichten van IR ondervindt, kunt u een gedetailleerd SqlException-bericht ontvangen in het foutbericht dat op een van de volgende problemen wijst:

• Een probleem met een netwerkverbinding. Controleer of de hostnaam voor SQL Database of SQL Managed Instance toegankelijk is. Controleer ook of een firewall of netwerkbeveiligingsgroep (NSG) de toegang voor SSIS IR tot de server blokkeert.
• De aanmelding is mislukt tijdens SQL-verificatie. Met het opgegeven account kan niet bij de SQL Server-database worden aangemeld. Geef het juiste gebruikersaccount op.
• Aanmelden is mislukt tijdens Microsoft Entra ID-verificatie (beheerde identiteit). Voeg de beheerde identiteit van uw factory toe aan een Microsoft Entra-groep en zorg ervoor dat de beheerde identiteit toegangsmachtigingen heeft voor uw catalogusdatabaseserver.
• Time-out van verbinding. Deze fout wordt altijd veroorzaakt door een beveiligingsconfiguratie. We raden u aan het volgende te doen:
  1. Een nieuwe VM maakt.
  2. Koppel de VIRTUELE machine aan hetzelfde virtuele Microsoft Azure-netwerk van IR als IR zich in een virtueel netwerk bevindt.
  3. Installeer SSMS en controleer de status van sql Database of SQL Managed Instance.

Voor andere problemen lost u het probleem op dat wordt weergegeven in het uitgebreide SQL-uitzonderingsfoutbericht. Als u nog steeds problemen ondervindt, neemt u contact op met het ondersteuningsteam van SQL Database of SQL Managed Instance.

Als u de fout ziet wanneer IR wordt uitgevoerd, verhinderen netwerkbeveiligingsgroep of firewallwijzigingen waarschijnlijk dat het SSIS IR-werkknooppunt toegang krijgt tot SQL Database of SQL Managed Instance. Blokkeer het SSIS IR-werkknooppunt zodat het toegang heeft tot SQL Database of SQL Managed Instance.

CatalogCapacityLimitError

Dit type foutbericht kan er als volgt uitzien: 'De database 'SSISDB' heeft het quotum voor de grootte bereikt. Gegevens partitioneren of verwijderen, indexen verwijderen of de documentatie raadplegen voor mogelijke oplossingen.

De mogelijke oplossingen zijn:

• Verhoog de quotumgrootte van uw SSISDB.
• Wijzig de configuratie van SSISDB om de grootte te verkleinen door:
  • De bewaarperiode en het aantal projectversies verminderen.
  • De bewaarperiode van het logboek verminderen.
  • Het standaardniveau van het logboek wijzigen.

CatalogDbBelongsToAnotherIR

Deze fout betekent dat SQL Database of SQL Managed Instance al een SSISDB heeft en dat deze wordt gebruikt door een andere IR. U moet een andere SQL Database of SQL Managed Instance opgeven of de bestaande SSISDB verwijderen en de nieuwe IR opnieuw starten.

CatalogDbCreationFailure

Deze fout kan een van de volgende oorzaken hebben:

• Het gebruikersaccount dat is geconfigureerd voor de SSIS IR beschikt niet over de machtiging om de database te maken. U kunt de gebruiker machtigen om de database te maken.
• Er treedt een time-out op tijdens het maken van de database, zoals een time-out tijdens uitvoering of een time-out voor de werking van de database. U kunt de bewerking later opnieuw uitvoeren. Als het opnieuw proberen niet werkt, neemt u contact op met het ondersteuningsteam van SQL Database of SQL Managed Instance.

Voor andere problemen controleert u het foutbericht van SQL-uitzondering en lost u het probleem op dat wordt vermeld in de foutdetails. Als u nog steeds problemen ondervindt, neemt u contact op met het ondersteuningsteam van SQL Database of SQL Managed Instance.

InvalidCatalogDb

Dit type foutbericht ziet er als volgt uit: 'Ongeldige objectnaam 'catalog.catalog_properties'. In dit geval hebt u al een database met de naam SSISDB, maar deze is niet gemaakt door SSIS IR of de database heeft een ongeldige status die wordt veroorzaakt door fouten in de laatste SSIS IR-inrichting. U kunt de bestaande database verwijderen met de naam SSISDB of u kunt een nieuwe SQL Database of SQL Managed Instance voor de IR configureren.

Problemen met aangepaste installatie

Aangepaste installatie biedt een interface voor het toevoegen van uw eigen installatiestappen tijdens het inrichten of opnieuw configureren van uw SSIS IR. Zie Installatie aanpassen voor Azure-SSIS Integration Runtime voor meer informatie.

Zorg ervoor dat uw container alleen de benodigde aangepaste installatiebestanden bevat. Alle bestanden in de container worden gedownload naar het SSIS IR-werkknooppunt. Het is raadzaam om het aangepaste installatiescript op een lokale machine te testen om eventuele problemen met het uitvoeren van scripts op te lossen voordat u het script uitvoert in SSIS IR.

De aangepaste container voor het installatiescript wordt gecontroleerd terwijl IR wordt uitgevoerd, omdat SSIS IR regelmatig wordt bijgewerkt. Voor deze update is toegang tot de container vereist om het aangepaste installatiescript te downloaden en opnieuw te installeren. Het proces controleert ook of de container toegankelijk is en of het bestand maim.cmd bestaat.

Voor elke fout die betrekking heeft op aangepaste installatie, ziet u een CustomSetupScriptFailure-foutcode met subcode zoals CustomSetupScriptBlobContainerInaccessible of CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Deze fout betekent dat SSIS IR geen toegang heeft tot uw Azure Blob-container voor aangepaste installatie. Zorg ervoor dat de SAS-URI van de container bereikbaar is en niet is verlopen.

Stop de IR als deze wordt uitgevoerd, configureer de IR opnieuw met de nieuwe aangepaste installatiecontainer SAS URI en start de IR opnieuw op.

CustomSetupScriptNotFound

Deze fout betekent dat SSIS IR geen aangepast installatiescript (main.cmd) kan vinden in de Blob-container. Zorg ervoor dat main.cmd in de container aanwezig is. Dit is het invoerpunt voor de aangepaste installatie.

CustomSetupScriptExecutionFailure

Deze fout betekent dat de uitvoering van het aangepaste installatiescript (main.cmd) is mislukt. Voer het script eerst op de lokale machine uit of controleer de logboeken voor de uitvoering van de aangepaste installatie in uw Blob-container.

CustomSetupScriptTimeout

Deze fout wijst op een time-out voor het uitvoeren van een script voor een aangepaste installatie. Zorg ervoor dat het script op de achtergrond kan worden uitgevoerd en dat er geen interactieve invoer nodig is, en dat uw blobcontainer alleen de benodigde aangepaste installatiebestanden bevat. Het is raadzaam om het script eerst op de lokale computer te testen. Controleer ook de logboeken voor de uitvoering van de aangepaste installatie in uw Blob-container. De maximale periode voor aangepaste installatie is 45 minuten voordat er een time-out optreedt. De maximale periode omvat de tijd voor het downloaden van alle bestanden uit uw container en het installeren ervan op SSIS IR. Als u een langere periode nodig hebt, dient u een ondersteuningsticket in.

CustomSetupScriptLogUploadFailure

Deze fout betekent dat de poging om de logboeken voor de uitvoering van de aangepaste installatie in uw Blob-container te uploaden, is mislukt. Dit probleem treedt op omdat SSIS IR geen schrijfmachtigingen heeft voor uw Blob-container of vanwege opslag- of netwerkproblemen. Als de aangepaste installatie is geslaagd, is deze fout niet van invloed op een SSIS-functie, maar de logboeken ontbreken. Als de aangepaste installatie mislukt met een andere fout en het logboek niet wordt geüpload, wordt deze fout eerst gerapporteerd zodat het logboek voor analyse kan worden geüpload. Nadat dit probleem is opgelost, worden er ook meer specifieke problemen gerapporteerd. Als dit probleem na een nieuwe poging niet wordt opgelost, neemt u contact op met het Azure Data Factory-ondersteuningsteam.

Configuratie van virtueel netwerk

Als u SSIS IR toevoegt aan Azure Virtual Network, maakt SSIS IR gebruik van het virtuele netwerk onder dit gebruikersabonnement. Zie Azure-SSIS Integration Runtime toevoegen aan een virtueel netwerk voor meer informatie. Nadat SSIS IR is gestart, kunt u, als u problemen met de netwerkverbinding ondervindt, proberen om het connectiviteitsprogramma te diagnosticeren om het probleem zelf te diagnosticeren. Wanneer er een probleem optreedt dat is gerelateerd aan een virtueel netwerk, ziet u een van de volgende fouten.

InvalidVnetConfiguration

Deze fout kan om verschillende redenen optreden. Raadpleeg de secties Forbidden, InvalidPropertyValue en MisconfiguredDnsServerOrNsgSettings om de problemen op te lossen.

Verboden

Dit type fout kan er ongeveer als volgt uitzien: 'SubnetId is niet ingeschakeld voor het huidige account. Microsoft.Batch-resourceprovider is niet geregistreerd onder hetzelfde abonnement van VNet.

Deze details geven aan dat Azure Batch geen toegang heeft tot uw virtuele netwerk. Registreer de Microsoft.Batch-resourceprovider onder hetzelfde abonnement als Virtual Network.

InvalidPropertyValue

Dit soort fout lijkt mogelijk op een van de volgende:

• 'Het opgegeven VNet bestaat niet of de Batch-service heeft er geen toegang toe.'
• "Het opgegeven subnet xxx bestaat niet."

Deze fouten geven aan dat het virtuele netwerk niet bestaat, de Azure Batch-service geen toegang tot het VNET heeft, of dat het opgegeven subnet niet bestaat.) Zorg ervoor dat het virtuele netwerk en het subnet bestaan, en dat Azure Batch er toegang toe heeft.

MisconfiguredDnsServerOrNsgSettings

Dit type foutbericht kan er als volgt uitzien: 'Kan Integration Runtime niet inrichten in VNet. Als de DNS-server- of NSG-instellingen zijn geconfigureerd, controleert u of de DNS-server toegankelijk is en de NSG juist is geconfigureerd.

In deze situatie hebt u waarschijnlijk een aangepaste configuratie van de DNS-server of NSG-instellingen, waardoor de Azure-servernaam die is vereist voor SSIS IR, niet kan worden omgezet of weergegeven. Zie Virtual Network-configuratie voor SSIS IR voor meer informatie. Als u nog steeds problemen ondervindt, neemt u contact op met het ondersteuningsteam van Azure Data Factory.

VNetResourceGroupLockedDuringUpgrade

SSIS IR wordt regelmatig automatisch bijgewerkt. Er wordt een nieuwe Azure Batch-pool gemaakt tijdens de upgrade, en de oude Azure Batch-pool wordt verwijderd. Ook worden aan Virtual Network gerelateerde resources voor de oude pool verwijderd, en de nieuwe aan Virtual Network gerelateerde resources worden gemaakt onder uw abonnement. Deze fout geeft aan dat het verwijderen van aan Virtual Network gerelateerde resources voor de oude pool is mislukt vanwege een verwijderingsvergrendeling op het niveau van het abonnement of de resourcegroep. Aangezien de klant de verwijderingsvergrendeling beheert en instelt, moet in dit geval de klant de verwijderingsvergrendeling verwijderen.

VNetResourceGroupLockedDuringStart

Als het inrichten van SSIS IR mislukt, worden alle gemaakte resources verwijderd. Als er echter sprake is van een verwijderingsvergrendeling voor de resource op het niveau van het abonnement of de resourcegroep, worden Virtual Network-resources niet verwijderd zoals verwacht. Verwijder de verwijderingsvergrendeling en start de IR opnieuw om deze fout te herstellen.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Als u SSIS IR stopt, worden alle aan Virtual Network gerelateerde resources verwijderd. Verwijderen kan echter mislukken als er sprake is van een verwijderingsvergrendeling voor de resource op het niveau van het abonnement of de resourcegroep. Ook hier wordt de verwijderingsvergrendeling beheerd en ingesteld door de klant. Daarom moet deze de verwijderingsvergrendeling verwijderen en SSIS IR opnieuw stoppen.

NodeUnavailable

Deze fout treedt op als IR actief is, en duidt erop dat IR is beschadigd. Deze fout wordt altijd veroorzaakt door een wijziging in de DNS-server of NSG-configuratie, waardoor SSIS IR geen verbinding kan maken met een noodzakelijke service. Omdat de configuratie van DNS-server en NSG wordt beheerd door de klant, moet deze de blokkerende problemen aan de eigen zijde oplossen. Zie Virtual Network-configuratie voor SSIS IR voor meer informatie. Als u nog steeds problemen ondervindt, neemt u contact op met het ondersteuningsteam van Azure Data Factory.

Configuratie van statische openbare IP-adressen

Wanneer u de Azure-SSIS IR koppelt aan Azure Virtual Network, kunt u ook uw eigen statische openbare IP-adressen voor de IR gebruiken, zodat de IR toegang heeft tot gegevensbronnen die de toegang tot specifieke IP-adressen beperken. Zie Azure-SSIS Integration Runtime toevoegen aan een virtueel netwerk voor meer informatie.

Naast de bovenstaande problemen met virtuele netwerken kunt u ook voldoen aan een statisch probleem met betrekking tot openbare IP-adressen. Controleer de volgende fouten voor hulp.

InvalidPublicIPSpecified

Deze fout kan verschillende oorzaken hebben wanneer u de Azure-SSIS IR start:

Foutbericht	Oplossing
Het opgegeven statische openbare IP-adres wordt al gebruikt. Geef twee ongebruikte ip-adressen op voor uw Azure-SSIS Integration Runtime.	U moet twee ongebruikte openbare IP-adressen selecteren of huidige verwijzingen naar het opgegeven openbare IP-adres verwijderen en vervolgens de Azure-SSIS IR opnieuw starten.
Het opgegeven statische openbare IP-adres heeft geen DNS-naam. Geef er twee met dns-naam op voor uw Azure-SSIS Integration Runtime.	U kunt de DNS-naam van het openbare IP-adres in Azure Portal instellen, zoals in de onderstaande afbeelding wordt weergegeven. Specifieke stappen zijn als volgt: (1) Open Azure Portal en ga naar de resourcepagina van dit openbare IP-adres; (2) Selecteer de sectie Configuratie en stel de DNS-naam in en klik vervolgens op de knop Opslaan ; (3) Start uw Azure-SSIS IR opnieuw op.
Het opgegeven VNet en statische openbare IP-adressen voor uw Azure-SSIS Integration Runtime moeten zich op dezelfde locatie bevinden.	Volgens de vereisten van het Azure-netwerk moeten het statische openbare IP-adres en het virtuele netwerk zich op dezelfde locatie en hetzelfde abonnement bevinden. Geef twee geldige openbare IP-adressen op en start de Azure-SSIS IR opnieuw.
Het opgegeven statische openbare IP-adres is een basis-IP-adres. Geef twee standaardadressen op voor uw Azure-SSIS Integration Runtime.	Raadpleeg SKU's van openbaar IP-adres voor hulp.

PublicIPResourceGroupLockedDuringStart

Als het inrichten van Azure-SSIS IR mislukt, worden alle resources die zijn gemaakt, verwijderd. Als er echter een verwijderingsvergrendeling voor resources is op het niveau van het abonnement of de resourcegroep (die uw statische openbare IP-adres bevat), worden de netwerkresources niet verwijderd zoals verwacht. Als u de fout wilt oplossen, verwijdert u de verwijderingsvergrendeling en start u de IR opnieuw.

PublicIPResourceGroupLockedDuringStop

Wanneer u Azure-SSIS IR stopt, worden alle netwerkresources die zijn gemaakt in de resourcegroep met uw openbare IP-adres verwijderd. Het verwijderen kan echter mislukken als er een resourceverwijderingsvergrendeling is op het niveau van het abonnement of de resourcegroep (die uw statische openbare IP-adres bevat). Verwijder de verwijderingsvergrendeling en start de IR opnieuw op.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR wordt regelmatig automatisch bijgewerkt. Er worden nieuwe IR-knooppunten gemaakt tijdens de upgrade en de oude knooppunten worden verwijderd. Ook worden de gemaakte netwerkbronnen (bijvoorbeeld de load balancer en de netwerkbeveiligingsgroep) voor de oude knooppunten verwijderd en worden de nieuwe netwerkbronnen gemaakt onder uw abonnement. Deze fout betekent dat het verwijderen van de netwerkresources voor de oude knooppunten is mislukt vanwege een verwijderingsvergrendeling op het niveau van het abonnement of de resourcegroep (die uw statische openbare IP-adres bevat). Verwijder de verwijderingsvergrendeling zodat we de oude knooppunten kunnen opschonen en het statische openbare IP-adres voor de oude knooppunten kunnen vrijgeven. Anders kan het statische openbare IP-adres niet worden vrijgegeven en kunnen we uw IR niet verder upgraden.

PublicIPNotUsableDuringUpgrade

Als u uw eigen statische openbare IP-adressen wilt gebruiken, moeten er twee openbare IP-adressen worden opgegeven. Een van deze wordt gebruikt om de IR-knooppunten onmiddellijk te maken en er wordt een andere gebruikt tijdens de upgrade van de IR. Deze fout kan optreden wanneer het andere openbare IP-adres onbruikbaar is tijdens de upgrade. Raadpleeg InvalidPublicIPSpecified voor mogelijke oorzaken.

Resourcebeheer

Resourcetag niet bijgewerkt

U kunt tags toepassen op uw Azure-resources om ze logisch te ordenen in een taxonomie. Terwijl de SSIS IR wordt uitgevoerd, worden wijzigingen in bovenliggende data factory-tags van SSIS IR pas van kracht nadat SSIS IR opnieuw is opgestart.