Rozwiązywanie problemów z zarządzaniem środowiskiem SSIS Integration Runtime

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

Ten artykuł zawiera wskazówki dotyczące rozwiązywania problemów z zarządzaniem w środowisku Azure-SQL Server Integration Runtime (SSIS) Integration Runtime (IR), nazywanym również środowiskiem SSIS IR.

Omówienie

Jeśli wystąpi jakikolwiek problem podczas aprowizacji lub anulowania aprowizacji środowiska SSIS IR, w portalu usługi Microsoft Azure Data Factory zostanie wyświetlony komunikat o błędzie lub błąd zwrócony z polecenia cmdlet programu PowerShell. Błąd jest zawsze wyświetlany w formacie kodu błędu ze szczegółowym komunikatem o błędzie.

Jeśli kod błędu to InternalServerError, usługa ma przejściowe problemy i spróbuj ponownie wykonać operację później. Jeśli ponowienie próby nie pomoże, skontaktuj się z zespołem pomocy technicznej usługi Azure Data Factory.

W przeciwnym razie trzy główne zależności zewnętrzne mogą powodować błędy: Usługa Azure SQL Database lub Azure SQL Managed Instance, skrypt konfiguracji niestandardowej i konfiguracja sieci wirtualnej.

Problemy z usługą SQL Database lub wystąpieniem zarządzanym SQL

Jeśli aprowizujesz środowisko SSIS IR przy użyciu bazy danych wykazu usług SSIS, wymagana jest usługa SQL Database lub wystąpienie zarządzane SQL. Środowisko SSIS IR musi mieć dostęp do usługi SQL Database lub wystąpienia zarządzanego SQL. Ponadto konto logowania dla usługi SQL Database lub wystąpienia zarządzanego SQL musi mieć uprawnienia do tworzenia bazy danych katalogu usług SSIS (SSISDB). Jeśli wystąpił błąd, w portalu usługi Data Factory będzie widoczny kod błędu oraz szczegółowy komunikat o wyjątku SQL. Rozwiąż problem, korzystając z informacji z poniższej listy kodów błędu.

AzureSqlConnectionFailure

Ten problem może występować podczas aprowizowania nowego środowiska SSIS IR lub po uruchomieniu środowiska IR. Jeśli błąd wystąpi podczas aprowizacji środowiska IR, komunikat o błędzie może zawierać szczegółowy komunikat SqlException, wskazujący na jeden z następujących problemów:

• Problem z połączeniem sieciowym. Sprawdź, czy nazwa hosta dla usługi SQL Database lub wystąpienia zarządzanego SQL jest dostępna. Sprawdź też, czy dostęp środowiska SSIS IR do serwera nie jest blokowany przez zaporę lub sieciową grupę zabezpieczeń.
• Niepowodzenie logowania podczas uwierzytelniania SQL. Podane konto nie może zalogować się do bazy danych programu SQL Server. Upewnij się, że podano poprawne konto użytkownika.
• Logowanie nie powiodło się podczas uwierzytelniania identyfikatora entra firmy Microsoft (tożsamości zarządzanej). Dodaj tożsamość zarządzaną fabryki do grupy Firmy Microsoft Entra i upewnij się, że tożsamość zarządzana ma uprawnienia dostępu do serwera bazy danych katalogu.
• Przekroczenie limitu czasu połączenia. Ten błąd jest zawsze spowodowany przez konfigurację związaną z zabezpieczeniami. Zalecamy:
  1. Utwórz nową maszynę wirtualną.
  2. Dołącz maszynę wirtualną do tej samej sieci wirtualnej platformy Microsoft Azure środowiska IR, jeśli środowisko IR znajduje się w sieci wirtualnej.
  3. Zainstaluj program SSMS i sprawdź stan usługi SQL Database lub wystąpienia zarządzanego SQL.

W przypadku innych problemów należy rozwiązać problem wskazany w szczegółowym komunikacie o wyjątku SQL. Jeśli nadal występują problemy, skontaktuj się z zespołem pomocy technicznej usługi SQL Database lub wystąpienia zarządzanego SQL.

Jeśli wystąpi błąd podczas uruchamiania środowiska IR, sieciowa grupa zabezpieczeń lub zmiany zapory prawdopodobnie uniemożliwiają węzłowi roboczemu środowiska SSIS IR uzyskiwanie dostępu do usługi SQL Database lub wystąpienia zarządzanego SQL. Odblokuj węzeł roboczy środowiska SSIS IR, aby mógł uzyskać dostęp do usługi SQL Database lub wystąpienia zarządzanego SQL.

CatalogCapacityLimitError

Oto, jak może wyglądać ten rodzaj komunikatu o błędzie: "Baza danych "SSISDB" osiągnęła limit przydziału rozmiaru. Partycjonowanie lub usuwanie danych, usuwanie indeksów lub zapoznaj się z dokumentacją, aby uzyskać możliwe rozwiązania.

Możliwe rozwiązania są następujące:

• Zwiększ rozmiar przydziału bazy danych SSISDB.
• Zmień konfigurację bazy danych SSISDB, aby zmniejszyć rozmiar przez:
  • Zmniejszenie okresu przechowywania i liczby wersji projektu.
  • Zmniejszenie okresu przechowywania dziennika.
  • Zmiana domyślnego poziomu dziennika.

CatalogDbBelongsToAnotherIR

Ten błąd oznacza, że usługa SQL Database lub wystąpienie zarządzane SQL ma już bazę danych SSISDB i że jest używana przez inne środowisko IR. Musisz podać inną bazę danych SQL lub wystąpienie zarządzane SQL albo usunąć istniejącą bazę danych SSISDB i ponownie uruchomić nowe środowisko IR.

CatalogDbCreationFailure

Ten błąd może mieć jedną z następujących przyczyn:

• Konto użytkownika skonfigurowane na potrzeby środowiska SSIS IR nie ma uprawnień wymaganych do utworzenia bazy danych. Możesz przyznać użytkownikowi uprawnienia do tworzenia baz danych.
• Podczas tworzenia bazy danych nastąpiło przekroczenie limitu czasu, na przykład limitu czasu wykonywania lub limitu czasu operacji bazy danych. Spróbuj ponownie wykonać operację później. Jeśli ponowienie próby nie działa, skontaktuj się z zespołem pomocy technicznej usługi SQL Database lub wystąpienia zarządzanego SQL.

W przypadku innych problemów sprawdź komunikat o wyjątku SQL i rozwiąż problem wskazany w szczegółach błędu. Jeśli nadal występują problemy, skontaktuj się z zespołem pomocy technicznej usługi SQL Database lub wystąpienia zarządzanego SQL.

InvalidCatalogDb

Ten rodzaj komunikatu o błędzie wygląda następująco: "Nieprawidłowa nazwa obiektu "catalog.catalog_properties". W takiej sytuacji baza danych o nazwie SSISDB została już utworzona przez środowisko SSIS IR lub baza danych jest w nieprawidłowym stanie spowodowanym przez błędy podczas ostatniej aprowizacji środowiska SSIS IR. Możesz usunąć istniejącą bazę danych o nazwie SSISDB lub skonfigurować nową bazę danych SQL Database lub wystąpienie zarządzane SQL dla środowiska IR.

Problemy z konfiguracją niestandardową

Za pomocą interfejsu instalacji niestandardowej można dodawać własne kroki instalacji podczas aprowizowania i ponownej konfiguracji środowiska SSIS IR. Aby uzyskać więcej informacji, zobacz Dostosowywanie konfiguracji środowiska Azure-SSIS Integration Runtime.

Upewnij się, że kontener zawiera tylko niezbędne pliki instalacji niestandardowej, ponieważ wszystkie pliki z tego kontenera zostaną pobrane do węzła roboczego środowiska SSIS IR. Zalecamy przetestowanie skryptu instalacji niestandardowej na komputerze lokalnym, aby naprawić wszelkie problemy z wykonywaniem skryptu przed jego uruchomieniem w środowisku SSIS IR.

Kontener skryptu instalacji niestandardowej zostanie sprawdzony podczas działania środowiska IR, ponieważ środowisko SSIS IR jest regularnie aktualizowane. Ta aktualizacja wymaga dostępu do kontenera w celu pobrania skryptu instalacji niestandardowej i jego ponownej instalacji. Proces sprawdza także, czy kontener jest dostępny i czy plik main.cmd istnieje.

W przypadku dowolnego błędu obejmującego konfigurację niestandardową zobaczysz kod błędu CustomSetupScriptFailure z kodem podrzędnym, takim jak CustomSetupScriptBlobContainerInaccessible lub CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Ten błąd oznacza, że środowisko SSIS IR nie może uzyskać dostępu do kontenera obiektów blob platformy Azure na potrzeby instalacji niestandardowej. Upewnij się, że identyfikator URI sygnatury dostępu współdzielonego kontenera jest osiągalny i nie wygasł.

Zatrzymaj środowisko IR, jeśli jest ono uruchomione, ponownie je skonfiguruj przy użyciu nowego identyfikatora URI sygnatury dostępu współdzielonego kontenera instalacji niestandardowej, a następnie ponownie uruchom środowisko IR.

CustomSetupScriptNotFound

Ten błąd oznacza, że środowisko SSIS IR nie może znaleźć skryptu instalacji niestandardowej (main.cmd) w kontenerze obiektów blob. Upewnij się, że plik main.cmd, który jest punktem wejścia dla instalacji niestandardowej, znajduje się w kontenerze.

CustomSetupScriptExecutionFailure

Ten błąd oznacza, że wykonanie skryptu instalacji niestandardowej (main.cmd) nie powiodło się. Najpierw wypróbuj skrypt na komputerze lokalnym lub sprawdź dzienniki wykonywania instalacji niestandardowej w kontenerze obiektów blob.

CustomSetupScriptTimeout

Ten błąd wskazuje, że upłynął limit czasu wykonywania skryptu instalacji niestandardowej. Upewnij się, że skrypt może być wykonywany w trybie dyskretnym i nie potrzebuje żadnej interakcji. Upewnij się również, że kontener obiektów blob zawiera tylko niezbędne pliki instalacji niestandardowej. Zalecane jest przetestowanie skryptu najpierw na komputerze lokalnym. Należy również sprawdzić dzienniki wykonywania instalacji niestandardowej w kontenerze obiektów blob. Limit czasu instalacji niestandardowej jest przekraczany po 45 minutach, a maksymalny okres obejmuje czas pobierania wszystkich plików z kontenera i instalowania ich w środowisku SSIS IR. Jeśli potrzebujesz dłuższego okresu, zgłoś bilet pomocy technicznej.

CustomSetupScriptLogUploadFailure

Ten błąd oznacza, że próba przekazania dzienników wykonywania instalacji niestandardowej do kontenera obiektów blob nie powiodła się. Ten problem występuje, ponieważ środowisko SSIS IR nie ma uprawnień do zapisu w kontenerze obiektów blob lub wystąpiły problemy z magazynem bądź siecią. Jeśli instalacja niestandardowa zakończy się pomyślnie, ten błąd nie wpłynie na żadną funkcję środowiska SSIS. Nie będzie jedynie dzienników. Jeśli instalacja niestandardowa zakończy się niepowodzeniem z powodu innego błędu i dziennik nie zostanie przekazany, najpierw zgłaszamy ten błąd, aby można było przekazać dziennik do analizy. Ponadto po rozwiązaniu tego problemu będziemy zgłaszać bardziej specyficzne problemy. Jeśli ten problem nie zostanie rozwiązany po ponowieniu próby, skontaktuj się z zespołem pomocy technicznej usługi Azure Data Factory.

Konfiguracja sieci wirtualnej

Po dołączeniu środowiska SSIS IR do usługi Azure Virtual Network środowisko SSIS IR używa sieci wirtualnej objętej subskrypcją użytkownika. Aby uzyskać więcej informacji, zobacz Dołączanie środowiska Azure-SSIS Integration Runtime do sieci wirtualnej. Po pomyślnym uruchomieniu środowiska SSIS IR, jeśli wystąpią problemy z połączeniem sieciowym, możesz spróbować użyć narzędzia do diagnozowania łączności w celu samodzielnego zdiagnozowania problemu. Jeśli wystąpi problem związany z siecią wirtualną, zobaczysz jeden z poniższych błędów.

InvalidVnetConfiguration

Ten błąd może wystąpić z różnych powodów. Aby rozwiązać ten problem, zobacz sekcjeForbidden, InvalidPropertyValue i MisconfiguredDnsServerOrNsgSettings.

Forbidden

Ten rodzaj błędu może wyglądać następująco: "Identyfikator podsieci nie jest włączony dla bieżącego konta. Dostawca zasobów Microsoft.Batch nie jest zarejestrowany w ramach tej samej subskrypcji sieci wirtualnej.

Te szczegóły oznaczają, że usługa Azure Batch nie może uzyskać dostępu do sieci wirtualnej. Zarejestruj dostawcę zasobów Microsoft.Batch w ramach tej samej subskrypcji co sieć wirtualna.

InvalidPropertyValue

Ten rodzaj błędu może być podobny do jednego z następujących:

• "Określona sieć wirtualna nie istnieje lub usługa Batch nie ma do niej dostępu".
• "Określona podsieć xxx nie istnieje".

Te błędy oznaczają, że sieć wirtualna nie istnieje, usługa Azure Batch nie może uzyskać do niej dostępu lub podana podsieć nie istnieje. Upewnij się, że sieć wirtualna i podsieć istnieją oraz że usługa Azure Batch może uzyskać do nich dostęp.

MisconfiguredDnsServerOrNsgSettings

Ten rodzaj komunikatu o błędzie może wyglądać następująco: "Nie można zainicjować obsługi środowiska Integration Runtime w sieci wirtualnej. Jeśli skonfigurowano ustawienia serwera DNS lub sieciowej grupy zabezpieczeń, upewnij się, że serwer DNS jest dostępny, a sieciowa grupa zabezpieczeń jest prawidłowo skonfigurowana.

W tej sytuacji prawdopodobnie masz niestandardową konfigurację ustawień serwera DNS lub sieciowej grupy zabezpieczeń, co uniemożliwia rozpoznanie lub uzyskanie dostępu do nazwy serwera platformy Azure wymaganej przez środowisko SSIS IR. Aby uzyskać więcej informacji, zobacz sekcję Konfiguracja sieci wirtualnej środowiska SSIS IR. Jeśli nadal występują problemy, skontaktuj się z zespołem pomocy technicznej usługi Azure Data Factory.

VNetResourceGroupLockedDuringUpgrade

Środowisko SSIS IR będzie automatycznie aktualizowane w regularnych odstępach czasu. Podczas uaktualniania tworzona jest nowa pula usługi Azure Batch, a stara pula usługi Azure Batch jest usuwana. Ponadto usuwane są zasoby związane z siecią wirtualną dla starej puli i tworzone są nowe zasoby związane z siecią wirtualną w ramach subskrypcji. Ten błąd oznacza, że usunięcie zasobów związanych z siecią wirtualną dla starej puli nie powiodło się z powodu blokady usuwania na poziomie subskrypcji lub grupy zasobów. Ponieważ klient kontroluje i ustawia blokadę usuwania, w tej sytuacji musi usunąć blokadę usuwania.

VNetResourceGroupLockedDuringStart

Jeśli aprowizacja środowiska SSIS IR nie powiedzie się, wszystkie utworzone zasoby zostaną usunięte. Jeśli jednak istnieje blokada usuwania zasobów na poziomie subskrypcji lub grupy zasobów, zasoby sieci wirtualnej nie zostaną usunięte zgodnie z oczekiwaniami. Aby naprawić ten błąd, usuń blokadę usuwania i ponownie uruchom środowisko IR.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Po zatrzymaniu środowiska SSIS IR wszystkie zasoby związane z siecią wirtualną są usuwane. Jednak usuwanie może zakończyć się niepowodzeniem, jeśli istnieje zasób z blokadą usuwania na poziomie subskrypcji lub grupy zasobów. Również w tym miejscu klient kontroluje i ustawia blokadę usuwania. W związku z tym musi on usunąć blokadę usuwania, a następnie ponownie zatrzymać środowisko SSIS IR.

NodeUnavailable

Ten błąd występuje, gdy środowisko IR jest uruchomione, i oznacza, że kondycja środowiska IR pogorszyła się. Ten błąd jest zawsze spowodowany przez zmianę w konfiguracji serwera DNS lub sieciowej grupy zabezpieczeń, która uniemożliwia środowisku SSIS IR łączenie się z niezbędną usługą. Ponieważ konfiguracja serwera DNS i sieciowej grupy zabezpieczeń jest kontrolowana przez klienta, to klient musi rozwiązać problemy z blokowaniem. Aby uzyskać więcej informacji, zobacz sekcję Konfiguracja sieci wirtualnej środowiska SSIS IR. Jeśli nadal występują problemy, skontaktuj się z zespołem pomocy technicznej usługi Azure Data Factory.

Konfiguracja statycznych publicznych adresów IP

Po dołączeniu środowiska Azure-SSIS IR do usługi Azure Virtual Network możesz również przenieść własne statyczne publiczne adresy IP dla środowiska IR, aby środowisko IR mogło uzyskać dostęp do źródeł danych, które ograniczają dostęp do określonych adresów IP. Aby uzyskać więcej informacji, zobacz Dołączanie środowiska Azure-SSIS Integration Runtime do sieci wirtualnej.

Oprócz powyższych problemów z siecią wirtualną można również napotkać problem związany ze statycznymi publicznymi adresami IP. Sprawdź następujące błędy, aby uzyskać pomoc.

InvalidPublicIPSpecified

Ten błąd może wystąpić z różnych powodów uruchamiania środowiska Azure-SSIS IR:

Komunikat o błędzie	Rozwiązanie
Podany statyczny publiczny adres IP jest już używany. Podaj dwa nieużywane adresy dla środowiska Azure-SSIS Integration Runtime.	Należy wybrać dwa nieużywane statyczne publiczne adresy IP lub usunąć bieżące odwołania do określonego publicznego adresu IP, a następnie ponownie uruchomić środowisko Azure-SSIS IR.
Podany statyczny publiczny adres IP nie ma nazwy DNS. Podaj dwie z nich z nazwą DNS dla środowiska Azure-SSIS Integration Runtime.	Nazwę DNS publicznego adresu IP można skonfigurować w witrynie Azure Portal, jak pokazano na poniższej ilustracji. Konkretne kroki są następujące: (1) Otwórz witrynę Azure Portal i przejdź do strony zasobu tego publicznego adresu IP; (2) Wybierz sekcję Konfiguracja i skonfiguruj nazwę DNS, a następnie kliknij przycisk Zapisz ; (3) Uruchom ponownie środowisko Azure-SSIS IR.
Podana sieć wirtualna i statyczne publiczne adresy IP środowiska Azure-SSIS Integration Runtime muszą znajdować się w tej samej lokalizacji.	Zgodnie z wymaganiami usługi Azure Network statyczny publiczny adres IP i sieć wirtualna powinny znajdować się w tej samej lokalizacji i subskrypcji. Podaj dwa prawidłowe statyczne publiczne adresy IP i uruchom ponownie środowisko Azure-SSIS IR.
Podany statyczny publiczny adres IP jest podstawowy. Podaj dwa standardowe dla środowiska Azure-SSIS Integration Runtime.	Aby uzyskać pomoc, zobacz Jednostki SKU publicznego adresu IP.

PublicIPResourceGroupLockedDuringStart

Jeśli aprowizowanie środowiska Azure-SSIS IR zakończy się niepowodzeniem, wszystkie utworzone zasoby zostaną usunięte. Jeśli jednak na poziomie subskrypcji lub grupy zasobów (która zawiera statyczny publiczny adres IP), zasoby sieciowe nie zostaną usunięte zgodnie z oczekiwaniami. Aby rozwiązać ten problem, usuń blokadę usuwania i uruchom ponownie środowisko IR.

PublicIPResourceGroupLockedDuringStop

Po zatrzymaniu środowiska Azure-SSIS IR wszystkie zasoby sieciowe utworzone w grupie zasobów zawierającej publiczny adres IP zostaną usunięte. Usunięcie może jednak zakończyć się niepowodzeniem, jeśli na poziomie subskrypcji lub grupy zasobów (która zawiera statyczny publiczny adres IP) blokadę usuwania zasobów. Usuń blokadę usuwania i uruchom ponownie środowisko IR.

PublicIPResourceGroupLockedDuringUpgrade

Środowisko Azure-SSIS IR jest regularnie aktualizowane automatycznie. Nowe węzły IR są tworzone podczas uaktualniania, a stare węzły zostaną usunięte. Ponadto utworzone zasoby sieciowe (np. moduł równoważenia obciążenia i sieciowa grupa zabezpieczeń) dla starych węzłów zostaną usunięte, a nowe zasoby sieciowe zostaną utworzone w ramach subskrypcji. Ten błąd oznacza, że usunięcie zasobów sieciowych dla starych węzłów nie powiodło się z powodu blokady usuwania na poziomie subskrypcji lub grupy zasobów (która zawiera statyczny publiczny adres IP). Usuń blokadę usuwania, aby można było wyczyścić stare węzły i zwolnić statyczny publiczny adres IP dla starych węzłów. W przeciwnym razie nie można zwolnić statycznego publicznego adresu IP i nie będziemy mogli jeszcze bardziej uaktualnić środowiska IR.

PublicIPNotUsableDuringUpgrade

Jeśli chcesz przenieść własne statyczne publiczne adresy IP, należy podać dwa publiczne adresy IP. Jeden z nich zostanie użyty do natychmiastowego utworzenia węzłów IR, a drugi zostanie użyty podczas uaktualniania środowiska IR. Ten błąd może wystąpić, gdy inny publiczny adres IP jest bezużyteczny podczas uaktualniania. Zobacz InvalidPublicIPSpecified, aby uzyskać informacje o możliwych przyczynach.

Zarządzanie zasobami

Tag zasobu nie został zaktualizowany

Tagi można stosować do zasobów platformy Azure, aby logicznie organizować je w taksonomię. Gdy środowisko SSIS IR jest uruchomione, zmiany w nadrzędnych tagach fabryki danych środowiska SSIS IR nie będą obowiązywać do momentu ponownego uruchomienia środowiska SSIS IR.