Dostosowywanie konfiguracji dla Azure-SSIS Integration Runtime

DOTYCZY: Azure Data Factory Azure Synapse Analytics

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

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

Konfiguracje niestandardowe na komputerze Azure-SSIS IR na jeden z dwóch sposobów:

  • Standardowa konfiguracja niestandardowa ze skryptem:przygotuj skrypt i skojarzone z nim pliki, a następnie przekaż je wszystkie razem do kontenera obiektów blob na koncie usługi Azure Storage konta. Następnie należy podać sygnaturę dostępu współdzielonego (SAS) Uniform Resource Identifier (URI) dla kontenera obiektów blob podczas konfigurowania lub ponownego konfigurowania Azure-SSIS IR. Każdy węzeł aplikacji Azure-SSIS IR następnie pobiera skrypt i skojarzone z nim pliki z kontenera obiektów blob i uruchamia konfigurację niestandardową z podwyższonym poziomem uprawnień. Po zakończeniu instalacji niestandardowej każdy węzeł przekaże standardowe dane wyjściowe wykonywania i inne dzienniki do kontenera obiektów blob.
  • Ekspresowa konfiguracja niestandardowabez skryptu: uruchom niektóre typowe konfiguracje systemu i polecenia Windows lub zainstaluj kilka popularnych lub zalecanych dodatkowych składników bez używania jakichkolwiek skryptów.

Składniki bezpłatne (nielicencjonowane) i płatne (licencjonowane) można instalować w standardowych i ekspresowych konfiguracjach niestandardowych. Jeśli jesteś niezależnym dostawcą oprogramowania, zobacz Develop paid or licensed components for Azure-SSIS IR(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 na Azure-SSIS IR z konfiguracją niestandardową.

Bieżące ograniczenia

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

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

  • Jeśli chcesz odwołać się do podfolderu w skrypcie,msiexec.exenie 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 Windows, nie są obecnie obsługiwane na Azure-SSIS IR.

  • Sterownik IBM iSeries Access ODBC nie jest obsługiwany na Azure-SSIS IR. Podczas instalacji niestandardowej mogą wystąpić błędy instalacji. Jeśli tak, skontaktuj się z pomocą techniczną firmy IBM w celu uzyskania pomocy.

Wymagania wstępne

Uwaga

W tym artykule jest używany moduł Azure Az programu PowerShell, który jest zalecanym modułem programu PowerShell do interakcji z platformą Azure. Aby rozpocząć pracę z modułem Azure PowerShell, zobacz Instalowanie programu Azure PowerShell. 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

  • Aprowizować Azure-SSIS IR

  • Konto usługi Azure Storage . Nie jest wymagane w przypadku ekspresowych konfiguracji niestandardowych. W przypadku standardowych konfiguracji niestandardowych skrypt konfiguracji niestandardowej i skojarzone z nim pliki są przechowywane w kontenerze obiektów blob. Proces instalacji niestandardowej przesyła 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 program 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 instalacji niestandardowej i skojarzone z nim pliki (na przykład .bat, cmd, .exe, .dll, .msi lub .ps1 plików).

    • Musisz mieć plik skryptu o nazwie main.cmd,który jest punktem wejścia konfiguracji niestandardowej.
    • Aby upewnić się, że skrypt może być wykonywany 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ą , jako 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 plik Eksplorator usługi Azure Storage.

    a. W obszarze Lokalne i dołączonekliknij prawym przyciskiem myszy pozycję Storage,a następnie wybierz Połączenie do usługi Azure Storage.

    Połączenie do usługi Azure Storage

    b. Wybierz Storage lub usługę, wybierz pozycję Nazwa konta i klucz,a następnie wybierz pozycję Dalej.

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

    Podaj nazwę i klucz konta magazynu

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

    Tworzenie kontenera obiektów blob

    e. Wybierz nowy kontener obiektów blob i przekaż skrypt konfiguracji niestandardowej oraz skojarzone z nim pliki. Upewnij się, że plik main.cmd został załadowany 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 aplikacji Azure-SSIS IR później nie będzie trwać długo. Maksymalny czas trwania konfiguracji niestandardowej jest obecnie ustawiany na 45 minut, zanim ukreśli limit czasu. Obejmuje to czas pobierania wszystkich plików z kontenera obiektów blob i instalowania ich na Azure-SSIS IR. Jeśli instalacja wymaga więcej czasu, zdaj bilet pomocy technicznej.

    Upload 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ółdzielonych.

    Uzyskiwanie sygnatury dostępu współdzielonych dla kontenera obiektów blob

    przykład Utwórz adres URI sygnatury dostępu współdzielonego dla kontenera obiektów blob z wystarczająco długim czasem wygaśnięcia i uprawnieniami do odczytu/zapisu/listy. Aby pobrać i uruchomić skrypt konfiguracji niestandardowej i skojarzone z nim pliki, potrzebny jest ten URI sygnatury dostępu współdzielonego. Dzieje się tak za każdym razem, gdy dowolny węzeł Azure-SSIS IR zostanie odtąd uruchomiony ponownie. Musisz również mieć uprawnienia do zapisu, aby przekazywać dzienniki wykonywania konfiguracji.

    Ważne

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

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

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

    Kopiowanie i zapisywanie sygnatury dostępu współdzielonych

  3. Zaznacz pole wyboru Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations (Dostosuj konfigurację systemu przy użyciu dodatkowych konfiguracji systemu/instalacji składników) na stronie Ustawienia zaawansowane okienka konfiguracji środowiska Integration Runtime. Następnie wprowadź adres URI sygnatury dostępu współdzielonego kontenera obiektów blob w polu tekstowym Custom setup container SAS URI (Niestandardowy kontener konfiguracji sygnatury dostępu współdzielonego URI).

    Ustawienia zaawansowane z konfiguracjami niestandardowymi

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

Ekspresowa konfiguracja niestandardowa

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

  1. Zaznacz pole wyboru Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations (Dostosuj konfigurację systemu przy użyciu dodatkowych konfiguracji systemu/instalacji składników) na stronie Ustawienia zaawansowane okienka konfiguracji środowiska Integration Runtime.

  2. Wybierz pozycję Nowy, aby otworzyć okienko Dodaj ekspresową konfigurację niestandardową, a następnie wybierz typ z listy rozwijanej Typ instalacji niestandardowej ekspresowej. Obecnie oferujemy ekspresowe konfiguracje niestandardowe 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 ekspresowej instalacji niestandardowej, możesz uruchomić polecenie cmdkey Windows na swoim Azure-SSIS IR. W tym celu wprowadź nazwę komputera docelowego lub nazwę domeny, nazwę użytkownika lub nazwę konta oraz hasło lub klucz konta w polach tekstowych /Add, /Useri /Pass. Umożliwi to utrwalanie poświadczeń dostępu dla serwerów SQL, udziałów plików lub Azure Files na Azure-SSIS IR. Aby na przykład uzyskać dostęp do Azure Files, możesz wprowadzić , i odpowiednio dla YourAzureStorageAccountName.file.core.windows.netazure\YourAzureStorageAccountNameYourAzureStorageAccountKeyYourAzureStorageAccountName.file.core.windows.net, azure\YourAzureStorageAccountNamei YourAzureStorageAccountKey Jest to podobne do uruchamiania polecenia cmdkey Windows na komputerze lokalnym.

Dodawanie zmiennych środowiskowych

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

Instalowanie Azure PowerShell

Jeśli wybierzesz typ instalacji Azure PowerShell instalacji niestandardowej, możesz zainstalować moduł Az programu PowerShell na swoim Azure-SSIS IR. W tym celu wprowadź numer wersji modułu Az (x.y.z) z listy obsługiwanych. Pozwoli to na uruchamianie Azure PowerShell 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 licencjonowane dla ekspresowej konfiguracji niestandardowej, możesz wybrać zintegrowany składnik od naszych partnerów isv z listy rozwijanej Nazwa składnika:

  • Jeśli wybierzesz składnik Fabryka zadań usługi SentryOne, możesz zainstalować pakiet składników fabryki zadań z usługi SentryOne na komputerze Azure-SSIS IR, wprowadzając klucz licencji produktu zakupiony u nich w polu Klucz licencji. Bieżąca zintegrowana wersja to 2020.21.2.

  • W przypadku wybrania hedda hedda 22. Składnik We/Wy, można zainstalować system HEDDA. Składnik jakości/czyszczenia danych we/wy od firmy oh22 na Azure-SSIS IR. Aby to zrobić, musisz wcześniej zakupić ich usługę. Bieżąca zintegrowana wersja to 1.0.14.

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

  • Jeśli wybierzesz składnik zestawu narzędzi SSIS Integration Toolkit firmy KingswaySoft, możesz zainstalować pakiet łączników zestawu narzędzi SSIS Integration Toolkit dla aplikacji CRM/ERP/marketing/collaboration, takich jak Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud itp. z usługi KingswaySoft na serwerze Azure-SSIS IR, wprowadzając klucz licencji produktu zakupiony u nich w polu Klucz licencji. Bieżąca zintegrowana wersja to 20.2.

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

  • Jeśli wybierzesz składnik Xtract IS firmy Theobald Software, możesz zainstalować pakiet łączników Xtract IS dla systemu SAP (ERP, S/4HANA, BW) z usługi Theobald Software na komputerze Azure-SSIS IR przeciągając plik licencji produktu zakupiony upuszczania/przekazywania do pola 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 integracji dla systemów SAP i Salesforce z firmy AecorSoft na Azure-SSIS IR. W tym celu wprowadź wcześniej zakupiony klucz licencji produktu w polu tekstowym Klucz licencji. Bieżąca zintegrowana wersja to 3.0.00.

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

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

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

Azure PowerShell

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

  1. Jeśli twoja Azure-SSIS IR została już uruchomiona/uruchomiona, zatrzymaj ją najpierw.

  2. Następnie możesz 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
    

Przykłady standardowej konfiguracji niestandardowej

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

  1. Połączenie do kontenera obiektów blob w publicznej wersji zapoznawczej przy użyciu Eksplorator usługi Azure Storage.

    a. W obszarze Lokalne i dołączonekliknij prawym przyciskiem myszy pozycję Storage,a następnie wybierz Połączenie do usługi Azure Storage.

    Połączenie do usługi 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 Blob container SAS URL (Adres URL sygnatury dostępu współdzielonego kontenera obiektów blob) wprowadź poniższy adres URI sygnatury dostępu współdzielonego dla kontenera obiektów blob w publicznej wersji zapoznawczej, wybierz pozycję Dalej,a następnie wybierz pozycję Połączenie.

    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:

    • Folder Przykład, który zawiera niestandardową konfigurację w celu zainstalowania podstawowego zadania w każdym węźle Azure-SSIS IR. Zadanie nie działa tylko w trybie uśpienia przez kilka sekund. Folder zawiera również folder gacutil, którego cała zawartość (gacutil.exe, gacutil.exe.configi 1033\gacutlrc.dll) może zostać skopiowana do kontenera obiektów blob w stanie, w jaki jest.

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

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

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

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

    • Folder BCP zawierający skrypt instalacji niestandardowej(main.cmd)do instalowania narzędzi wiersza polecenia programu SQL Server (MsSqlCmdLnUtils.msi) na każdym węźle Azure-SSIS IR. Jednym z tych narzędzi jest program do kopiowania zbiorczego(bcp).

    • Folder sufiksu DNS zawierający skrypt konfiguracji niestandardowej(main.cmd)do dołączania własnego sufiksu DNS (na przykład test.com) do dowolnej niekwalifikowanej nazwy domeny o pojedynczej etykiecie 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 skrypt instalacji niestandardowej(main.cmd)do instalowania niektórych zestawów i bibliotek języka C# w każdym węźle Azure-SSIS IR. Można ich używać w zadaniach skryptu, aby dynamicznie odczytywać i zapisywać Excel skryptów.

      Najpierw pobierz pliki ExcelDataReader.dll iDocumentFormat.OpenXml.dll, a następnie przekaż je wszystkie razem z plikiem main.cmd do kontenera obiektów blob. Alternatywnie, jeśli chcesz użyć standardowych łączników Excel (Menedżer połączeń, źródłowych i docelowych), pakietu redystrybucyjnego dostępu, który je zawiera, jest już wstępnie zainstalowany na twoim serwerze Azure-SSIS IR, więc nie potrzebujesz żadnej konfiguracji niestandardowej.

    • Folder MYSQL ODBC zawierający skrypt konfiguracji niestandardowej(main.cmd)do instalowania sterowników MySQL ODBC na każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia nawiązywanie połączeń 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 instalatorów 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 wszystkie razem z plikiem main.cmd do kontenera obiektów blob.

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

    • Folder ORACLE ENTERPRISE zawierający skrypt instalacji niestandardowej(main.cmd)i plik konfiguracji instalacji dyskretnej(client.rsp)w celu zainstalowania łączników Oracle i sterownika OCI w każdym węźle Azure-SSIS IR Enterprise Edition. Ta konfiguracja umożliwia nawiązywanie połączenia z serwerem Oracle przy Menedżer połączeń Oracle, źródła i miejsca docelowego.

      Najpierw pobierz program Microsoft Connectors 5.0 for Oracle (AttunitySSISOraAdaptersSetup.msi i AttunitySSISOraAdaptersSetup64.msi) z Centrum pobierania Microsoft i najnowszego klienta Oracle (na przykład winx64_12102_client.zip) z witryny Oracle. Następnie przekaż je wszystkie razem z plikami main.cmd i client.rsp 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 je skopiować do folderu instalacyjnego Oracle podczas instalacji.

    • Folder oracle STANDARD ADO.NET zawierający skrypt konfiguracji niestandardowej(main.cmd)do instalowania sterownika Oracle ODP.NET na każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia nawiązywanie 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ładODP.NET_Managed_ODAC122cR1.zip), a następnie przekaż go razem z plikiem main.cmd do kontenera obiektów blob.

    • Folder ORACLE STANDARD ODBC, który zawiera skrypt konfiguracji niestandardowej(main.cmd)do instalowania 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 nawiązywanie połączenia z serwerem Oracle przy użyciu typów źródeł danych ODBC Menedżer połączeń, Source i Destination lub Power Query Menedżer połączeń i Source z typem źródła danych ODBC.

      Najpierw pobierz najnowszą wersję programu Oracle Instant Client (pakiet podstawowy lub podstawowy pakiet Package Package) i pakiet ODBC, a następnie przekaż je wszystkie 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 Package Package: instantclient-basiclite-windows.x64-18.3.0.0.0dbru.zip; Pakiet ODBC: instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip)
      • Pobieranie pakietów 32-bitowych (pakiet podstawowy: instantclient-basic-nt-18.3.0.0.0dbru.zip; Podstawowy pakiet Package Package: instantclient-basiclite-nt-18.3.0.0.0dbru.zip; Pakiet ODBC: instantclient-odbc-nt-18.3.0.0.0dbru.zip)
    • Folder ORACLE STANDARD OLEDB, który zawiera skrypt konfiguracji niestandardowej(main.cmd)do instalowania sterownika Oracle OLEDB w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia nawiązywanie połączenia z serwerem Oracle przy użyciu Menedżer połączeń, źródła i miejsca docelowego OLEDB.

      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 zawierający skrypt konfiguracji niestandardowej(main.cmd)do instalowania sterowników ODBC postgreSQL w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia nawiązywanie połączenia z serwerem PostgreSQL przy użyciu Menedżer połączeń, źródła i miejsca docelowego ODBC.

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

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

      Najpierw przekaż 64-bitową lub 32-bitową wersję programulibrfc32.dllz 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, który zawiera skrypt instalacji niestandardowej(main.cmd),który 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ą Azure PowerShell cmdlet/skryptydo zarządzania usługą Azure Storage.

      Skopiuj main.cmd, przykładową AzurePowerShell.msi (lub użyj najnowszej wersji) istorage.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 Execute Process Task, 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 Teradata Parallel Transporter (TPT) i sterownik ODBC w każdym węźle Azure-SSIS IR Enterprise Edition. Ta konfiguracja umożliwia nawiązywanie połączenia z serwerem Teradata przy użyciu Menedżer połączeń, źródła i miejsca docelowego Teradata.

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

    • Folder TLS 1.2 zawierający skrypt konfiguracji 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 konfiguracji niestandardowej(main.cmd)i plik programu PowerShell (install_openjdk.ps1) w celu zainstalowania zestawu Zulu OpenJDK w każdym węźle Azure-SSIS IR. Ta konfiguracja umożliwia przetwarzanie plików ORC i Parquet przy użyciu łączników azure Data Lake Store i flexible file. Aby uzyskać więcej informacji, zobacz Azure Feature Pack for Integration Services (Pakiet funkcji platformy Azure dla usług Integration Services).

      Najpierw pobierz najnowszy plik Zulu OpenJDK (na przykładzulu8.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 instalacji niestandardowej, skopiuj zawartość wybranego folderu do kontenera obiektów blob.

  2. Podczas aprowizowania lub ponownego konfigurowania środowiska Azure-SSIS IR w interfejsie użytkownika usługi ADF zaznacz pole wyboru Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations (Dostosuj środowisko Azure-SSIS Integration Runtime przy użyciu dodatkowych konfiguracji systemu/instalacji składników) na stronie Ustawienia zaawansowane okienka konfiguracji środowiska Integration Runtime. Następnie wprowadź adres URI sygnatury dostępu współdzielonego kontenera obiektów blob w polu tekstowym Custom setup container SAS URI (Niestandardowy kontener konfiguracji sygnatury dostępu współdzielonego URI).

  3. Podczas aprowizacji lub ponownego konfigurowania usługi Azure-SSIS IR przy użyciu usługi Azure PowerShell zatrzymaj ją, jeśli jest już uruchomiona, uruchom polecenie cmdlet z URI sygnatury dostępu współdzielonego kontenera obiektów blob jako wartością parametru, a następnie uruchom Set-AzDataFactoryV2IntegrationRuntimeSetupScriptContainerSasUri Azure-SSIS IR.

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

Następne kroki