Dostosowywanie konfiguracji usługi Azure-SSIS Integration Runtime

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

Możesz dostosować usługę Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) w usłudze Azure Data Factory (ADF) lub potokach usługi Synapse za pomocą niestandardowych konfiguracji. Umożliwiają one dodawanie własnych kroków podczas aprowizacji lub ponownej konfiguracji Azure-SSIS IR.

Korzystając z ustawień niestandardowych, można zmienić domyślną konfigurację operacyjną lub środowisko Azure-SSIS IR. Aby na przykład uruchomić dodatkowe usługi systemu Windows, zachować poświadczenia dostępu dla udziałów plików lub użyć tylko silnej kryptografii/bezpieczniejszego protokołu sieciowego (TLS 1.2). Możesz też zainstalować dodatkowe składniki, takie jak zestawy, sterowniki lub rozszerzenia, na każdym węźle Azure-SSIS IR. Mogą być to składniki niestandardowe, open source lub innej firmy. Aby uzyskać więcej informacji na temat wbudowanych/wstępnie zainstalowanych składników, zobacz Wbudowane/wstępnie zainstalowane składniki na Azure-SSIS IR.

Konfiguracje niestandardowe można wykonać na Azure-SSIS IR na jeden z dwóch sposobów:

  • Standardowa konfiguracja niestandardowa ze skryptem: przygotowywanie skryptu i skojarzonych z nim plików oraz przekazywanie ich do kontenera obiektów blob na koncie usługi Azure Storage. Następnie należy podać identyfikator URI (Shared Access Signature) dla kontenera obiektów blob podczas konfigurowania lub ponownego konfigurowania Azure-SSIS IR. Każdy węzeł Azure-SSIS IR następnie pobiera skrypt i skojarzone z nim pliki z kontenera obiektów blob i uruchamia konfigurację niestandardową z podwyższonymi uprawnieniami. Po zakończeniu konfiguracji niestandardowej każdy węzeł przekazuje standardowe dane wyjściowe wykonywania i inne dzienniki do kontenera obiektów blob.
  • Ekspresowa konfiguracja niestandardowa bez skryptu: uruchom niektóre typowe konfiguracje systemu i polecenia systemu Windows lub zainstaluj kilka popularnych lub zalecanych dodatkowych składników bez użycia skryptów.

Możesz zainstalować zarówno bezpłatne (nielicencjonowane), jak i płatne (licencjonowane) składniki ze standardowymi i ekspresowymi konfiguracjami niestandardowymi. Jeśli jesteś niezależnym dostawcą oprogramowania (ISV), zobacz Tworzenie płatnych lub licencjonowanych składników dla Azure-SSIS IR.

Ważne

Aby skorzystać z przyszłych ulepszeń, zalecamy używanie serii węzłów w wersji 3 lub nowszej dla Azure-SSIS IR z konfiguracją niestandardową.

Bieżące ograniczenia

Następujące ograniczenia dotyczą tylko standardowych konfiguracji niestandardowych:

  • Jeśli chcesz użyć gacutil.exe w skrypcie, aby zainstalować zestawy w globalnej pamięci podręcznej zestawów (GAC), musisz podać gacutil.exe w ramach konfiguracji niestandardowej. Możesz też użyć kopii udostępnionej w folderze Przykładowym kontenera obiektów blob w publicznej wersji zapoznawczej, zobacz sekcję Przykłady konfiguracji niestandardowej w warstwie Standardowa poniżej.

  • Jeśli chcesz odwołać się do podfolderu w skryscie, msiexec.exe nie obsługuje .\ notacji odwołującej się do folderu głównego. Użyj polecenia, takiego jak msiexec /i "MySubfolder\MyInstallerx64.msi" ... zamiast msiexec /i ".\MySubfolder\MyInstallerx64.msi" ....

  • Udziały administracyjne lub ukryte udziały sieciowe, które są automatycznie tworzone przez system Windows, nie są obecnie obsługiwane w Azure-SSIS IR.

  • Sterownik IBM iSeries Access ODBC nie jest obsługiwany w Azure-SSIS IR. Podczas instalacji niestandardowej mogą pojawić się błędy instalacji. Jeśli to zrobisz, skontaktuj się z pomocą techniczną FIRMY IBM, aby uzyskać pomoc.

Wymagania wstępne

Uwaga

Zalecamy korzystanie z modułu Azure Az programu PowerShell do interakcji z platformą Azure. Zobacz Instalowanie Azure PowerShell, aby rozpocząć pracę. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Aby dostosować Azure-SSIS IR, potrzebne są następujące elementy:

  • Subskrypcja platformy Azure

  • Aprowizuj Azure-SSIS IR

  • Konto usługi Azure Storage. Nie jest wymagane w przypadku ekspresowych konfiguracji niestandardowych. W przypadku standardowych konfiguracji niestandardowych przekazujesz i przechowujesz skrypt konfiguracji niestandardowej oraz skojarzone z nią pliki w kontenerze obiektów blob. Proces instalacji niestandardowej przekazuje również dzienniki wykonywania do tego samego kontenera obiektów blob.

Instrukcje

Możesz aprowizować lub ponownie skonfigurować Azure-SSIS IR przy użyciu niestandardowych konfiguracji w interfejsie użytkownika usługi ADF. Jeśli chcesz to zrobić za pomocą programu PowerShell, pobierz i zainstaluj Azure PowerShell.

Standardowa konfiguracja niestandardowa

Aby aprowizować lub ponownie skonfigurować Azure-SSIS IR przy użyciu standardowych konfiguracji niestandardowych w interfejsie użytkownika usługi ADF, wykonaj następujące kroki.

  1. Przygotuj skrypt konfiguracji niestandardowej i skojarzone z nim pliki (na przykład pliki .bat, cmd, .exe, .dll, .msi lub pliki .ps1).

    • Musisz mieć plik skryptu o nazwie main.cmd, który jest punktem wejścia konfiguracji niestandardowej.
    • Aby upewnić się, że skrypt można wykonać w trybie dyskretnym, należy najpierw przetestować go na komputerze lokalnym.
    • Jeśli chcesz, aby dodatkowe dzienniki generowane przez inne narzędzia (na przykład msiexec.exe) zostały przekazane do kontenera obiektów blob, określ wstępnie zdefiniowaną zmienną środowiskową , CUSTOM_SETUP_SCRIPT_LOG_DIRjako folder dziennika w skryptach (na przykład msiexec /i xxx.msi /quiet /lv %CUSTOM_SETUP_SCRIPT_LOG_DIR%\install.log).
  2. Pobierz, zainstaluj i otwórz Eksplorator usługi Azure Storage.

    a. W obszarze Lokalne i Dołączone kliknij prawym przyciskiem myszy pozycję Konta magazynu, a następnie wybierz pozycję Połącz z usługą Azure Storage.

    Nawiązywanie połączenia z usługą Azure Storage

    b. Wybierz pozycję Konto magazynu lub usługa, wybierz pozycję Nazwa konta i klucz, a następnie wybierz pozycję Dalej.

    c. Wprowadź nazwę i klucz konta usługi Azure Storage, wybierz pozycję Dalej, a następnie wybierz pozycję Połącz.

    Podaj nazwę i klucz konta magazynu

    d. W obszarze połączonego konta usługi Azure Storage kliknij prawym przyciskiem myszy pozycję Kontenery obiektów blob, wybierz pozycję Utwórz kontener obiektów blob i nadaj nazwę nowemu kontenerowi obiektów blob.

    Tworzenie kontenera obiektów blob

    e. Wybierz nowy kontener obiektów blob i przekaż skrypt konfiguracji niestandardowej i skojarzone z nią pliki. Upewnij się, że przekazano plik main.cmd na najwyższym poziomie kontenera obiektów blob, a nie w żadnym folderze. Kontener obiektów blob powinien zawierać tylko niezbędne pliki konfiguracji niestandardowej, więc pobranie ich do Azure-SSIS IR później nie potrwa długo. Maksymalny czas trwania konfiguracji niestandardowej jest obecnie ustawiony na 45 minut przed upływem limitu czasu. Obejmuje to czas pobierania wszystkich plików z kontenera obiektów blob i instalowania ich na Azure-SSIS IR. Jeśli konfiguracja wymaga więcej czasu, zgłoś bilet pomocy technicznej.

    Przekazywanie plików do kontenera obiektów blob

    f. Kliknij prawym przyciskiem myszy kontener obiektów blob, a następnie wybierz polecenie Pobierz sygnaturę dostępu współdzielonego.

    Pobieranie sygnatury dostępu współdzielonego dla kontenera obiektów blob

    g. Utwórz identyfikator URI sygnatury dostępu współdzielonego dla kontenera obiektów blob z wystarczająco długim czasem wygaśnięcia i uprawnieniem do odczytu/zapisu/listy. Identyfikator URI sygnatury dostępu współdzielonego jest potrzebny do pobrania i uruchomienia niestandardowego skryptu konfiguracji oraz skojarzonych z nim plików. Dzieje się tak za każdym razem, gdy dowolny węzeł Azure-SSIS IR jest odtwarzany lub uruchamiany ponownie. Potrzebujesz również uprawnień do zapisu w celu przekazania dzienników wykonywania konfiguracji.

    Ważne

    Upewnij się, że identyfikator URI sygnatury dostępu współdzielonego nie wygaśnie, a zasoby konfiguracji niestandardowej są zawsze dostępne w całym cyklu życia Azure-SSIS IR, od utworzenia do usunięcia, zwłaszcza jeśli regularnie zatrzymujesz i uruchamiasz Azure-SSIS IR w tym okresie.

    Generowanie sygnatury dostępu współdzielonego dla kontenera obiektów blob

    h. Skopiuj i zapisz identyfikator URI sygnatury dostępu współdzielonego kontenera obiektów blob.

    Kopiowanie i zapisywanie sygnatury dostępu współdzielonego

  3. Zaznacz pole wyboru Dostosuj usługę Azure-SSIS Integration Runtime z dodatkowymi konfiguracjami systemu/instalacjami składników na stronie Ustawienia zaawansowane okienka Konfiguracji środowiska Integration Runtime. Następnie wprowadź identyfikator URI sygnatury dostępu współdzielonego kontenera obiektów blob w polu tekstowym Identyfikator URI sygnatury dostępu współdzielonego kontenera niestandardowego.

    Ustawienia zaawansowane z konfiguracjami niestandardowymi

Po zakończeniu standardowej konfiguracji niestandardowej i uruchomieniu Azure-SSIS IR można znaleźć wszystkie dzienniki konfiguracji niestandardowej w folderze main.cmd.log kontenera obiektów blob. Obejmują one standardowe dane wyjściowe pliku main.cmd i inne dzienniki wykonywania.

Konfiguracja niestandardowa ekspresowa

Aby aprowizować lub ponownie skonfigurować Azure-SSIS IR za pomocą ekspresowych niestandardowych konfiguracji w interfejsie użytkownika usługi ADF, wykonaj następujące kroki.

  1. Zaznacz pole wyboru Dostosuj usługę Azure-SSIS Integration Runtime z dodatkowymi konfiguracjami systemu/instalacjami składników na stronie Ustawienia zaawansowane okienka Konfiguracji środowiska Integration Runtime.

  2. Wybierz pozycję Nowy , aby otworzyć okienko Dodawanie ekspresowej konfiguracji niestandardowej , a następnie wybierz typ z listy rozwijanej Typ konfiguracji niestandardowej platformy Express . Obecnie oferujemy ekspresowe konfiguracje niestandardowe do uruchamiania polecenia cmdkey, dodawania zmiennych środowiskowych, instalowania Azure PowerShell i instalowania licencjonowanych składników.

Uruchamianie polecenia cmdkey

Jeśli wybierzesz typ polecenia Uruchom cmdkey dla konfiguracji niestandardowej ekspresowej, możesz uruchomić polecenie cmdkey systemu Windows w Azure-SSIS IR. W tym celu wprowadź docelową nazwę komputera lub nazwę domeny, nazwę użytkownika lub nazwę konta oraz hasło lub klucz konta w polach tekstowych /Add, /User i /Pass . Umożliwi to utrwalanie poświadczeń dostępu dla serwerów SQL, udziałów plików lub Azure Files w Azure-SSIS IR. Aby na przykład uzyskać dostęp do Azure Files, możesz wprowadzić YourAzureStorageAccountName.file.core.windows.netwartości , azure\YourAzureStorageAccountNamei YourAzureStorageAccountKey dla /Add, /User i /Pass, odpowiednio. Jest to podobne do uruchamiania polecenia cmdkey systemu Windows na komputerze lokalnym.

Dodawanie zmiennych środowiskowych

W przypadku wybrania opcji Dodaj typ zmiennej środowiskowej dla ekspresowej konfiguracji niestandardowej możesz dodać zmienną środowiskową systemu Windows na Azure-SSIS IR. W tym celu wprowadź odpowiednio nazwę zmiennej środowiskowej i wartość w polach tekstowych Nazwa zmiennej i Wartość zmiennej. Pozwoli to na użycie zmiennej środowiskowej w pakietach uruchamianych na Azure-SSIS IR, na przykład w temacie Składniki skryptu/zadania. Jest to podobne do uruchamiania polecenia Zestawu systemu Windows na komputerze lokalnym.

Instalowanie Azure PowerShell

Jeśli wybierzesz typ Zainstaluj Azure PowerShell dla ekspresowej konfiguracji niestandardowej, możesz zainstalować moduł Az programu PowerShell na Azure-SSIS IR. W tym celu wprowadź numer wersji modułu Az (x.y.z) z listy obsługiwanych. Umożliwi to uruchamianie Azure PowerShell poleceń cmdlet/skryptów w pakietach w celu zarządzania zasobami platformy Azure, na przykład Azure Analysis Services (AAS).

Instalowanie licencjonowanych składników

Jeśli wybierzesz typ składnika Zainstaluj licencjonowany dla ekspresowej konfiguracji niestandardowej, możesz wybrać zintegrowany składnik z naszych partnerów niezależnych dostawców oprogramowania na liście rozwijanej Nazwa składnika :

  • Jeśli wybierzesz składnik Usługi Task Factory usługi SentryOne, możesz zainstalować zestaw składników usługi Task Factory z usługi SentryOne na Azure-SSIS IR, wprowadzając klucz licencji produktu zakupiony na ich podstawie w polu Klucz licencji. Bieżąca zintegrowana wersja to 2020.21.2.

  • Jeśli wybierzesz heDDA oh22. Składnik we/wy, można zainstalować HEDDA. Jakość/czyszczenie danych we/wy od oh22 na Azure-SSIS IR. W tym celu należy wcześniej zakupić swoją usługę. Bieżąca zintegrowana wersja to 1.0.14.

  • Jeśli wybierzesz składnik SQLPhonetics.NET oh22, możesz zainstalować SQLPhonetics.NET składnik jakości/dopasowania danych z oh22 na Azure-SSIS IR. W tym celu wprowadź wcześniej zakupiony od nich klucz licencji produktu w polu tekstowym Klucz licencji . Bieżąca zintegrowana wersja to 1.0.45.

  • Jeśli wybierzesz składnik SSIS Integration Toolkit firmy KingswaySoft, możesz zainstalować zestaw narzędzi SSIS Integration Toolkit dla aplikacji CRM/ERP/marketing/współpracy, takich jak Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud itp., wprowadzając klucz licencji produktu zakupiony na nich w kluczu licencji Azure-SSIS IR. Pole. Bieżąca zintegrowana wersja to 21.2.

  • Jeśli wybierzesz składnik SSIS Productivity Pack firmy KingswaySoft, możesz zainstalować pakiet SSIS Productivity Pack składników firmy KingswaySoft na Azure-SSIS IR, wprowadzając klucz licencji produktu zakupiony na nich w polu Klucz licencji. Bieżąca zintegrowana wersja to 21.2.

  • Jeśli wybierzesz składnik Xtract IS oprogramowania Theobald Software, możesz zainstalować pakiet łączników Xtract IS dla systemu SAP (ERP, S/4HANA, BW) z Oprogramowania Theobald na Azure-SSIS IR przeciągając&/przekazując plik licencji produktu zakupiony z nich w polu Plik licencji. Bieżąca zintegrowana wersja to 6.5.13.18.

  • Jeśli wybierzesz składnik Usługi integracji firmy AecorSoft, możesz zainstalować pakiet łączników usługi Integration Service dla systemów SAP i Salesforce firmy AecorSoft na Azure-SSIS IR. W tym celu wprowadź wcześniej zakupiony od nich klucz licencji produktu w polu tekstowym Klucz licencji . Bieżąca zintegrowana wersja to 3.0.00.

  • Jeśli wybierzesz składnik SSIS Standard Package CData, możesz zainstalować pakiet SSIS Standard Package najpopularniejszych składników z CData, takich jak łączniki programu SharePoint Microsoft, na Azure-SSIS IR. W tym celu wprowadź wcześniej zakupiony od nich klucz licencji produktu w polu tekstowym Klucz licencji . Bieżąca zintegrowana wersja to 21.7867.

  • W przypadku wybrania składnika rozszerzonego pakietu SSIS usługi CData można zainstalować pakiet rozszerzony SSIS wszystkich składników z CData, takich jak Microsoft łączniki usługi Dynamics 365 Business Central i inne składniki w pakiecie SSIS Standard Package, na Azure-SSIS IR. W tym celu wprowadź wcześniej zakupiony od nich klucz licencji produktu w polu tekstowym Klucz licencji . Bieżąca zintegrowana wersja to 21.7867. Ze względu na duży rozmiar, aby uniknąć przekroczenia limitu czasu instalacji, upewnij się, że Azure-SSIS IR ma co najmniej 4 rdzenie procesora CPU na węzeł.

Dodane ekspresowe konfiguracje niestandardowe będą wyświetlane na stronie Ustawienia zaawansowane . Aby je usunąć, zaznacz pola wyboru, a następnie wybierz pozycję Usuń.

Azure PowerShell

Aby aprowizować lub ponownie skonfigurować Azure-SSIS IR przy użyciu konfiguracji niestandardowych przy użyciu Azure PowerShell, wykonaj następujące kroki.

  1. Jeśli Azure-SSIS IR jest już uruchomiona/uruchomiona, najpierw ją zatrzymaj.

  2. Następnie można dodać lub usunąć konfiguracje niestandardowe, uruchamiając Set-AzDataFactoryV2IntegrationRuntime polecenie cmdlet przed rozpoczęciem Azure-SSIS IR.

    $ResourceGroupName = "[your Azure resource group name]"
    $DataFactoryName = "[your data factory name]"
    $AzureSSISName = "[your Azure-SSIS IR name]"
    # Custom setup info: Standard/express custom setups
    $SetupScriptContainerSasUri = "" # OPTIONAL to provide a SAS URI of blob container for standard custom setup where your script and its associated files are stored
    $ExpressCustomSetup = "[RunCmdkey|SetEnvironmentVariable|InstallAzurePowerShell|SentryOne.TaskFactory|oh22is.SQLPhonetics.NET|oh22is.HEDDA.IO|KingswaySoft.IntegrationToolkit|KingswaySoft.ProductivityPack|Theobald.XtractIS|AecorSoft.IntegrationService|CData.Standard|CData.Extended or leave it empty]" # OPTIONAL to configure an express custom setup without script
    
    # Add custom setup parameters if you use standard/express custom setups
    if(![string]::IsNullOrEmpty($SetupScriptContainerSasUri))
    {
        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
            -DataFactoryName $DataFactoryName `
            -Name $AzureSSISName `
            -SetupScriptContainerSasUri $SetupScriptContainerSasUri
    }
    if(![string]::IsNullOrEmpty($ExpressCustomSetup))
    {
        if($ExpressCustomSetup -eq "RunCmdkey")
        {
            $addCmdkeyArgument = "YourFileShareServerName or YourAzureStorageAccountName.file.core.windows.net"
            $userCmdkeyArgument = "YourDomainName\YourUsername or azure\YourAzureStorageAccountName"
            $passCmdkeyArgument = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourPassword or YourAccessKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.CmdkeySetup($addCmdkeyArgument, $userCmdkeyArgument, $passCmdkeyArgument)
        }
        if($ExpressCustomSetup -eq "SetEnvironmentVariable")
        {
            $variableName = "YourVariableName"
            $variableValue = "YourVariableValue"
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.EnvironmentVariableSetup($variableName, $variableValue)
        }
        if($ExpressCustomSetup -eq "InstallAzurePowerShell")
        {
            $moduleVersion = "YourAzModuleVersion"
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.AzPowerShellSetup($moduleVersion)
        }
        if($ExpressCustomSetup -eq "SentryOne.TaskFactory")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "oh22is.SQLPhonetics.NET")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "oh22is.HEDDA.IO")
        {
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup)
        }
        if($ExpressCustomSetup -eq "KingswaySoft.IntegrationToolkit")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "KingswaySoft.ProductivityPack")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }    
        if($ExpressCustomSetup -eq "Theobald.XtractIS")
        {
            $jsonData = Get-Content -Raw -Path YourLicenseFile.json
            $jsonData = $jsonData -replace '\s',''
            $jsonData = $jsonData.replace('"','\"')
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString($jsonData)
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "AecorSoft.IntegrationService")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "CData.Standard")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "CData.Extended")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }    
        # Create an array of one or more express custom setups
        $setups = New-Object System.Collections.ArrayList
        $setups.Add($setup)
    
        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
            -DataFactoryName $DataFactoryName `
            -Name $AzureSSISName `
            -ExpressCustomSetup $setups
    }
    Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
        -DataFactoryName $DataFactoryName `
        -Name $AzureSSISName `
        -Force
    

Standardowe przykłady konfiguracji niestandardowej

Aby wyświetlić i ponownie użyć niektórych przykładów standardowych konfiguracji niestandardowych, wykonaj następujące kroki.

  1. Połącz się z kontenerem obiektów blob w publicznej wersji zapoznawczej przy użyciu Eksplorator usługi Azure Storage.

    a. W obszarze Lokalne i Dołączone kliknij prawym przyciskiem myszy pozycję Konta magazynu, a następnie wybierz pozycję Połącz z usługą Azure Storage.

    Nawiązywanie połączenia z usługą Azure Storage

    b. Wybierz pozycję Kontener obiektów blob, wybierz pozycję Adres URL sygnatury dostępu współdzielonego (SAS), a następnie wybierz pozycję Dalej.

    c. W polu tekstowym Adres URL sygnatury dostępu współdzielonego kontenera obiektów blob obiektu blob dla kontenera sygnatury dostępu współdzielonego w kontenerze usługi Blob w publicznej wersji zapoznawczej wprowadź poniższy identyfikator URI sygnatury dostępu współdzielonego, wybierz pozycję Dalej, a następnie wybierz pozycję Połącz.

    https://ssisazurefileshare.blob.core.windows.net/publicpreview?sp=rl&st=2020-03-25T04:00:00Z&se=2025-03-25T04:00:00Z&sv=2019-02-02&sr=c&sig=WAD3DATezJjhBCO3ezrQ7TUZ8syEUxZZtGIhhP6Pt4I%3D

    d. W okienku po lewej stronie wybierz połączony kontener obiektów blob publicpreview , a następnie kliknij dwukrotnie folder CustomSetupScript . W tym folderze znajdują się następujące elementy:

    • Przykładowy folder zawierający niestandardową konfigurację do zainstalowania podstawowego zadania w każdym węźle Azure-SSIS IR. Zadanie nie wykonuje nic, ale śpi przez kilka sekund. Folder zawiera również folder gacutil , którego cała zawartość (gacutil.exe, gacutil.exe.configi 1033\gacutlrc.dll) można skopiować tak, jak to ma być do kontenera obiektów blob.

    • Folder UserScenarios , który zawiera kilka niestandardowych przykładów konfiguracji z rzeczywistych scenariuszy użytkownika. Jeśli chcesz zainstalować wiele przykładów na Azure-SSIS IR, możesz połączyć pliki niestandardowego skryptu instalacji (main.cmd) w jeden i przekazać je ze wszystkimi skojarzonymi plikami do kontenera obiektów blob.

      Zawartość publicznego kontenera obiektów blob w wersji zapoznawczej

    e. Kliknij dwukrotnie folder UserScenarios , aby znaleźć następujące elementy:

    • Folder .NET FRAMEWORK 3.5, który zawiera skrypt instalacji niestandardowej (main.cmd), aby zainstalować starszą wersję .NET Framework w każdym węźle Azure-SSIS IR. Ta wersja może być wymagana przez niektóre składniki niestandardowe.

    • Folder BCP, który zawiera niestandardowy skrypt konfiguracji (main.cmd) do instalowania SQL Server narzędzi wiersza polecenia (MsSqlCmdLnUtils.msi) w każdym węźle Azure-SSIS IR. Jednym z tych narzędzi jest program kopiowania zbiorczego (bcp).

    • Folder SUFIKS DNS, który zawiera niestandardowy skrypt konfiguracji (main.cmd), aby dołączyć własny sufiks DNS (na przykład test.com) do dowolnej niekwalifikowanej nazwy domeny z pojedynczą etykietą i przekształcić go w w pełni kwalifikowaną nazwę domeny (FQDN) przed użyciem go w zapytaniach DNS z Azure-SSIS IR.

    • Folder PROGRAMU EXCEL zawierający niestandardowy skrypt instalacji (main.cmd), który umożliwia zainstalowanie niektórych zestawów i bibliotek języka C# w każdym węźle Azure-SSIS IR. Można ich używać w zadaniach skryptów do dynamicznego odczytywania i zapisywania plików programu Excel.

      Najpierw pobierz ExcelDataReader.dll i DocumentFormat.OpenXml.dll, a następnie przekaż je razem z plikiem main.cmd do kontenera obiektów blob. Alternatywnie, jeśli chcesz użyć standardowych łączników programu Excel (Menedżer połączeń, źródłowych i docelowych), pakiet redystrybucyjny programu Access zawierający je jest już wstępnie zainstalowany na Azure-SSIS IR, więc nie potrzebujesz żadnej konfiguracji niestandardowej.

    • Folder ODBC MYSQL zawierający niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania sterowników ODBC MySQL w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia łączenie się z serwerem MySQL przy użyciu łączników ODBC (Menedżer połączeń, źródłowych i docelowych).

      Najpierw pobierz najnowsze 64-bitowe i 32-bitowe wersje instalatora sterowników MySQL ODBC (na przykład mysql-connector-odbc-8.0.13-winx64.msi i mysql-connector-odbc-8.0.13-win32.msi), a następnie przekaż je razem z main.cmd do kontenera obiektów blob.

      Jeśli nazwa źródła danych (DSN) jest używana w połączeniu, konfiguracja dsN jest wymagana w skryscie konfiguracji. Na przykład: C:\Windows\SysWOW64\odbcconf.exe /A {CONFIGSYSDSN "MySQL ODBC 8.0 Unicode Driver" "DSN=<dsnname>| PORT=3306| SERVER=<nazwa>_serwera"}

    • Folder ORACLE ENTERPRISE, który zawiera niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania łączników Oracle i sterownika OCI w każdym węźle Azure-SSIS IR Enterprise Edition. Ta konfiguracja umożliwia nawiązanie połączenia z serwerem Oracle za pomocą Menedżer połączeń Oracle, źródła i miejsca docelowego.

      Najpierw pobierz łączniki Microsoft w wersji 5.0 for Oracle (AttunitySSISOraAdaptersSetup.msi i AttunitySSISOraAdaptersSetup64.msi) z centrum pobierania Microsoft i najnowszego klienta Oracle Instant Client (na przykład instantclient-basic-windows.x64-21.3.0.0.0.zip) z bazy danych Oracle. Następnie przekaż je razem z plikiem main.cmd do kontenera obiektów blob. Jeśli używasz usługi TNS do nawiązywania połączenia z bazą danych Oracle, musisz również pobrać plik tnsnames.ora, edytować go i przekazać do kontenera obiektów blob. W ten sposób można go skopiować do folderu instalacyjnego Oracle podczas instalacji.

    • Folder ADO.NET ORACLE STANDARD, który zawiera niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania sterownika Oracle ODP.NET w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia nawiązanie połączenia z serwerem Oracle przy użyciu ADO.NET Menedżer połączeń, źródła i miejsca docelowego.

      Najpierw pobierz najnowszy sterownik oracle ODP.NET (na przykład ODP.NET_Managed_ODAC122cR1.zip), a następnie przekaż go razem z plikiem main.cmd do kontenera obiektów blob.

    • Folder ODBC ORACLE STANDARD, który zawiera niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania sterownika Oracle ODBC w każdym węźle Azure-SSIS IR. Skrypt konfiguruje również nazwę źródła danych (DSN). Ta konfiguracja umożliwia użycie Menedżer połączeń ODBC, źródła i miejsca docelowego lub Power Query Menedżer połączeń i źródła z typem źródła danych ODBC w celu nawiązania połączenia z serwerem Oracle.

      Najpierw pobierz najnowszy pakiet Oracle Instant Client (pakiet podstawowy lub pakiet Basic Lite) i pakiet ODBC, a następnie przekaż je razem z plikiem main.cmd do kontenera obiektów blob:

      • Pobierz pakiety 64-bitowe (pakiet podstawowy: instantclient-basic-windows.x64-18.3.0.0.0dbru.zip; Podstawowy pakiet Lite: instantclient-basiclite-windows.x64-18.3.0.0.0dbru.zip; Pakiet ODBC: instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip)
      • Pobierz pakiety 32-bitowe (pakiet podstawowy: instantclient-basic-nt-18.3.0.0.0dbru.zip; Podstawowy pakiet Lite: instantclient-basiclite-nt-18.3.0.0.0dbru.zip; Pakiet ODBC: instantclient-odbc-nt-18.3.0.0.0dbru.zip)
    • Folder ORACLE STANDARD OLEDB zawierający niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania sterownika Oracle OLEDB w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia łączenie się z serwerem Oracle przy użyciu Menedżer połączeń OLEDB, źródła i miejsca docelowego.

      Najpierw pobierz najnowszy sterownik Oracle OLEDB (na przykład ODAC122010Xcopy_x64.zip), a następnie przekaż go razem z plikiem main.cmd do kontenera obiektów blob.

    • Folder ODBC POSTGRESQL, który zawiera niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania sterowników ODBC PostgreSQL w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia łączenie się z serwerem PostgreSQL przy użyciu Menedżer połączeń ODBC, źródła i miejsca docelowego.

      Najpierw pobierz najnowsze 64-bitowe i 32-bitowe wersje instalatorów sterowników PostgreSQL ODBC (na przykład psqlodbc_x64.msi i psqlodbc_x86.msi), a następnie przekaż je razem z main.cmd do kontenera obiektów blob.

    • Folder SAP BW, który zawiera niestandardowy skrypt konfiguracji (main.cmd) do zainstalowania zestawu łącznika SAP .NET (librfc32.dll) na każdym węźle Azure-SSIS IR Enterprise Edition. Ta konfiguracja umożliwia nawiązanie połączenia z serwerem SAP BW Menedżer połączeń, źródłowym i docelowym.

      Najpierw przekaż 64-bitową lub 32-bitową wersję librfc32.dll z folderu instalacyjnego SAP wraz z plikiem main.cmd do kontenera obiektów blob. Następnie skrypt kopiuje zestaw SAP do folderu %windir%\SysWow64 lub %windir%\System32 podczas instalacji.

    • Folder STORAGE zawierający skrypt instalacji niestandardowej (main.cmd) do zainstalowania Azure PowerShell w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia wdrażanie i uruchamianie pakietów usług SSIS, które uruchamiają polecenia cmdlet/skrypty Azure PowerShell w celu zarządzania usługą Azure Storage.

      Skopiuj plik main.cmd, przykładową AzurePowerShell.msi (lub użyj najnowszej wersji) i storage.ps1 do kontenera obiektów blob. Użyj pliku PowerShell.dtsx jako szablonu dla pakietów. Szablon pakietu łączy zadanie pobierania obiektu blob platformy Azure, które pobiera modyfikowalny skrypt programu PowerShell (storage.ps1) i zadanie wykonywania procesu, które wykonuje skrypt w każdym węźle.

    • Folder TERADATA , który zawiera skrypt instalacji niestandardowej (main.cmd), skojarzony plik (install.cmd) i pakiety instalatora (.msi). Te pliki instalują łączniki Teradata, interfejs API TPT (Teradata Parallel Transporter) i sterownik ODBC w każdym węźle Azure-SSIS IR Enterprise Edition. Ta konfiguracja umożliwia użycie Menedżer połączeń Teradata, źródła i miejsca docelowego w celu nawiązania połączenia z serwerem Teradata.

      Najpierw pobierz plik zip narzędzi Teradata Tools and Utilities 15.x (na przykład TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip), a następnie przekaż go wraz z wcześniej wymienionymi plikami cmd i .msi do kontenera obiektów blob.

    • Folder tls 1.2, który zawiera skrypt instalacji niestandardowej (main.cmd) do używania tylko silnej kryptografii/bezpieczniejszego protokołu sieciowego (TLS 1.2) w każdym węźle Azure-SSIS IR. Skrypt wyłącza również starsze wersje protokołu SSL/TLS (SSL 3.0, TLS 1.0, TLS 1.1) w tym samym czasie.

    • Folder ZULU OPENJDK zawierający skrypt instalacji niestandardowej (main.cmd) i plik programu PowerShell (install_openjdk.ps1) do zainstalowania zestawu Zulu OpenJDK na każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia przetwarzanie plików ORC i Parquet przy użyciu usług Azure Data Lake Store i Elastycznych łączników plików. Aby uzyskać więcej informacji, zobacz Azure Feature Pack for Integration Services.

      Najpierw pobierz najnowszy zestaw Zulu OpenJDK (na przykład zulu8.33.0.1-jdk8.0.192-win_x64.zip), a następnie przekaż go razem z plikiem main.cmd i install_openjdk.ps1 do kontenera obiektów blob.

      Foldery w folderze scenariuszy użytkownika

    f. Aby ponownie użyć tych standardowych przykładów konfiguracji niestandardowych, skopiuj zawartość wybranego folderu do kontenera obiektów blob.

  2. Podczas aprowizowania lub ponownego konfigurowania Azure-SSIS IR w interfejsie użytkownika usługi ADF zaznacz pole wyboru Dostosuj Integration Runtime Azure-SSIS z dodatkowymi konfiguracjami systemu/instalacjami składników na stronie Ustawienia zaawansowane okienka konfiguracji środowiska Integration Runtime. Następnie wprowadź identyfikator URI sygnatury dostępu współdzielonego kontenera obiektów blob w polu tekstowym Identyfikator URI sygnatury dostępu współdzielonego kontenera konfiguracji niestandardowej .

  3. Jeśli aprowizujesz lub ponownie skonfigurujesz Azure-SSIS IR przy użyciu Azure PowerShell, zatrzymaj ją, jeśli jest już uruchomiona/uruchomiona, uruchom Set-AzDataFactoryV2IntegrationRuntime polecenie cmdlet z identyfikatorem URI sygnatury dostępu współdzielonego kontenera obiektów blob jako wartością parametruSetupScriptContainerSasUri, a następnie uruchom Azure-SSIS IR.

  4. Po zakończeniu standardowej konfiguracji niestandardowej i uruchomieniu Azure-SSIS IR można znaleźć wszystkie dzienniki instalacji niestandardowej w folderze main.cmd.log kontenera obiektów blob. Obejmują one standardowe dane wyjściowe pliku main.cmd i inne dzienniki wykonywania.

Następne kroki