Rozwiązywanie problemów z zarządzaniem usługą SSIS Integration Runtime

DOTYCZY: Azure Data Factory Azure Synapse Analytics (wersja zapoznawcza)

Ten artykuł zawiera wskazówki dotyczące rozwiązywania problemów z zarządzaniem w usłudze Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR), znanej również jako środowisko SSIS IR.

Omówienie

Jeśli napotkasz 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 zwrócony błąd z polecenia cmdlet programu PowerShell. Błąd zawsze pojawia się 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 ponów próbę wykonania operacji później. Jeśli ponawianie próby nie pomoże, skontaktuj się z zespołem pomocy technicznej Azure Data Factory.

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

problemy z SQL Database lub SQL Managed Instance

SQL Database lub SQL Managed Instance jest wymagane w przypadku aprowizowania środowiska SSIS IR z bazą danych wykazu usług SSIS. Środowisko SSIS IR musi mieć dostęp do SQL Database lub SQL Managed Instance. Ponadto konto logowania dla SQL Database lub SQL Managed Instance 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 SQL Database lub SQL Managed Instance 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.
  • Niepowodzenie logowania podczas uwierzytelniania usługi Microsoft Azure Active Directory (Azure AD) — tożsamość zarządzana. Dodaj tożsamość zarządzaną swojej fabryki do grupy usługi AAD i upewnij się, że ta 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 wykonanie następujących czynności:
    1. Utwórz nową maszynę wirtualną.
    2. Dołącz maszynę wirtualną do tej samej Microsoft Azure Virtual Network środowiska IR, jeśli środowisko IR znajduje się w sieci wirtualnej.
    3. Zainstaluj program SSMS i sprawdź stan SQL Database lub SQL Managed Instance.

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 SQL Database lub SQL Managed Instance.

Jeśli podczas uruchamiania środowiska IR zostanie wyświetlony błąd, prawdopodobnie zmiana sieciowej grupy zabezpieczeń lub zapory uniemożliwia węzłowi roboczemu środowiska SSIS IR uzyskiwanie dostępu do SQL Database lub SQL Managed Instance. Odblokuj węzeł roboczy środowiska SSIS IR, aby mógł uzyskać dostęp do SQL Database lub SQL Managed Instance.

CatalogCapacityLimitError

Oto, jak może wyglądać ten rodzaj komunikatu o błędzie: "Baza danych SSISDB osiągnęła swój limit przydziału rozmiaru. Podziel lub usuń dane, upuść indeksy 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 SQL Database lub SQL Managed Instance ma już bazę danych SSISDB i że jest używany przez inne środowisko IR. Musisz podać inną SQL Database lub SQL Managed Instance lub 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 ponawianie próby nie zadziała, skontaktuj się z zespołem pomocy technicznej SQL Database lub SQL Managed Instance.

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 SQL Database lub SQL Managed Instance.

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 już istnieje, ale nie została utworzona przez środowisko SSIS IR lub baza danych jest w nieprawidłowym stanie, który jest spowodowany błędami w ostatniej aprowizacji środowiska SSIS IR. Możesz usunąć istniejącą bazę danych o nazwie SSISDB lub skonfigurować nową SQL Database lub SQL Managed Instance 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, który obejmuje 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ć podobnie do następującego: "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 aprowizować 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 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 uzyskiwać 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 podczas uruchamiania Azure-SSIS IR:

Komunikat o błędzie Rozwiązanie
Podany statyczny publiczny adres IP jest już używany. Podaj dwa nieużywane dla usługi 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ć Azure-SSIS IR.
Podany statyczny publiczny adres IP nie ma nazwy DNS. Podaj dwie z nich nazwę DNS dla usługi Azure-SSIS Integration Runtime. Nazwę DNS publicznego adresu IP można skonfigurować w Azure Portal, jak pokazano na poniższym obrazie. Konkretne kroki są następujące: (1) Otwórz 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 Azure-SSIS IR.
Podana sieć wirtualna i statyczne publiczne adresy IP dla usługi 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 Azure-SSIS IR.
Podany statyczny publiczny adres IP jest podstawowy. Podaj dwa standardowe dla usługi Azure-SSIS Integration Runtime. Aby uzyskać pomoc, zapoznaj się z jednostkami SKU publicznego adresu IP .

Azure-SSIS IR

PublicIPResourceGroupLockedDuringStart

Jeśli Azure-SSIS IR aprowizacji 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 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

Azure-SSIS IR jest regularnie aktualizowana 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 są usuwane, a nowe zasoby sieciowe są tworzone 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 dalej 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. Aby uzyskać możliwe przyczyny, zapoznaj się z tematem InvalidPublicIPSpecified .

Zarządzanie zasobami

Tag zasobu nie został zaktualizowany

Tagi można stosować do zasobów platformy Azure w celu logicznego zorganizowania ich 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.