Delen via


De installatie voor een Azure-SSIS Integration Runtime aanpassen

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

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

U kunt uw Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) aanpassen in Azure Data Factory (ADF) of Synapse Pipelines via aangepaste instellingen. Hiermee kunt u uw eigen stappen toevoegen tijdens het inrichten of opnieuw configureren van uw Azure-SSIS IR.

Met behulp van aangepaste instellingen kunt u de standaardconfiguratie of -omgeving van uw Azure-SSIS IR wijzigen. Als u bijvoorbeeld extra Windows-services wilt starten, toegangsreferenties voor bestandsshares wilt behouden of alleen sterke cryptografie/veiliger netwerkprotocol (TLS 1.2) wilt gebruiken. U kunt ook extra onderdelen, zoals assembly's, stuurprogramma's of extensies, installeren op elk knooppunt van uw Azure-SSIS IR. Ze kunnen aangepaste, opensource- of onderdelen van derden zijn. Zie Ingebouwde/vooraf geïnstalleerde onderdelen op Azure-SSIS IR voor meer informatie over ingebouwde en vooraf geïnstalleerde onderdelen.

U kunt op twee manieren aangepaste instellingen uitvoeren op uw Azure-SSIS IR:

  • Standaard aangepaste installatie met een script: bereid een script en de bijbehorende bestanden voor en upload ze allemaal samen naar een blobcontainer in uw Azure Storage-account. Vervolgens geeft u een SAS (Shared Access Signature) Uniform Resource Identifier (URI) op voor uw blobcontainer wanneer u uw Azure-SSIS IR instelt of opnieuw configureert. Elk knooppunt van uw Azure-SSIS IR downloadt vervolgens het script en de bijbehorende bestanden uit uw blobcontainer en voert uw aangepaste installatie uit met verhoogde machtigingen. Wanneer uw aangepaste installatie is voltooid, uploadt elk knooppunt de standaarduitvoer van de uitvoering en andere logboeken naar uw blobcontainer.
  • Snelle aangepaste installatie zonder script: voer enkele algemene systeemconfiguraties en Windows-opdrachten uit of installeer enkele populaire of aanbevolen extra onderdelen zonder scripts te gebruiken.

U kunt zowel gratis (niet-gelicentieerde) als betaalde (gelicentieerde) onderdelen installeren met standaard- en snelle aangepaste instellingen. Als u een onafhankelijke softwareleverancier (ISV) bent, raadpleegt u Betaalde of gelicentieerde onderdelen ontwikkelen voor Azure-SSIS IR.

Belangrijk

Als u wilt profiteren van toekomstige verbeteringen, raden we u aan v3 of nieuwere reeks knooppunten te gebruiken voor uw Azure-SSIS IR met aangepaste installatie.

Huidige beperkingen

De volgende beperkingen gelden alleen voor standaard aangepaste instellingen:

  • Als u gacutil.exe in uw script wilt gebruiken om assembly's te installeren in de algemene assemblycache (GAC), moet u gacutil.exe opgeven als onderdeel van uw aangepaste installatie. U kunt ook de kopie gebruiken die is opgegeven in de map Voorbeeld van onze openbare preview-blobcontainer. Zie de sectie Voorbeelden van aangepaste standaardinstellingen hieronder.

  • Als u naar een submap in uw script wilt verwijzen, biedt msiexec.exe geen ondersteuning voor de .\ notatie om naar de hoofdmap te verwijzen. Gebruik een opdracht, zoals msiexec /i "MySubfolder\MyInstallerx64.msi" ... in plaats van msiexec /i ".\MySubfolder\MyInstallerx64.msi" ....

  • Beheershares, of verborgen netwerkshares die automatisch door Windows worden gemaakt, worden momenteel niet ondersteund in de Azure-SSIS IR.

  • Het ODBC-stuurprogramma voor IBM iSeries Access wordt niet ondersteund in de Azure-SSIS IR. Mogelijk worden er installatiefouten weergegeven tijdens uw aangepaste installatie. Als u dit doet, neemt u contact op met ibm-ondersteuning voor hulp.

Vereisten

Notitie

Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

Als u uw Azure-SSIS IR wilt aanpassen, hebt u het volgende nodig:

  • Een Azure-abonnement

  • Uw Azure-SSIS IR inrichten

  • Een Azure Storage-account. Niet vereist voor snelle aangepaste instellingen. Voor standaard aangepaste instellingen uploadt en slaat u het aangepaste installatiescript en de bijbehorende bestanden op in een blobcontainer. Het aangepaste installatieproces uploadt ook de uitvoeringslogboeken naar dezelfde blobcontainer.

Instructies

U kunt uw Azure-SSIS IR inrichten of opnieuw configureren met aangepaste instellingen in de ADF-gebruikersinterface. Als u hetzelfde wilt doen met PowerShell, downloadt en installeert u Azure PowerShell.

Aangepaste standaardinstallatie

Voer de volgende stappen uit om uw Azure-SSIS IR in te richten of opnieuw te configureren met standaard aangepaste instellingen in de ADF-gebruikersinterface.

  1. Bereid uw aangepaste installatiescript en de bijbehorende bestanden voor (bijvoorbeeld .bat- .cmd-, .exe-, .dll-, .msi- of .ps1-bestanden).

    • U moet een scriptbestand hebben met de naam main.cmd. Dit is het toegangspunt van uw aangepaste installatie.
    • Om ervoor te zorgen dat het script op de achtergrond kan worden uitgevoerd, moet u het eerst testen op uw lokale computer.
    • Als u wilt dat extra logboeken die door andere hulpprogramma's (bijvoorbeeld msiexec.exe) worden geüpload naar uw blobcontainer, geeft u de vooraf gedefinieerde omgevingsvariabele op, CUSTOM_SETUP_SCRIPT_LOG_DIRals de logboekmap in uw scripts (bijvoorbeeld msiexec /i xxx.msi /quiet /lv %CUSTOM_SETUP_SCRIPT_LOG_DIR%\install.log).
  2. Download, installeer en open Azure Storage Explorer.

    a. Klik onder Lokaal en gekoppeld met de rechtermuisknop op Opslagaccounts en selecteer Vervolgens Verbinding maken met Azure Storage.

    Verbinding maken met Azure Storage

    b. Selecteer Opslagaccount of -service, selecteer Accountnaam en -sleutel en selecteer vervolgens Volgende.

    c. Voer de naam en sleutel van uw Azure Storage-account in, selecteer Volgende en selecteer vervolgens Verbinding maken.

    Geef de naam en sleutel van het opslagaccount op

    d. Klik onder uw verbonden Azure Storage-account met de rechtermuisknop op BlobContainers, selecteer Blobcontainer maken en geef de nieuwe blobcontainer een naam.

    Een blobcontainer maken

    e. Selecteer de nieuwe blobcontainer en upload uw aangepaste installatiescript en de bijbehorende bestanden. Zorg ervoor dat u main.cmd uploadt op het hoogste niveau van uw blobcontainer, niet in een map. Uw blobcontainer mag alleen de benodigde aangepaste installatiebestanden bevatten, dus het downloaden ervan naar uw Azure-SSIS IR duurt later niet lang. De maximale duur van een aangepaste installatie is momenteel ingesteld op 45 minuten voordat er een time-out optreedt. Dit omvat de tijd om alle bestanden te downloaden uit uw blobcontainer en deze te installeren op de Azure-SSIS IR. Als de installatie meer tijd nodig heeft, dient u een ondersteuningsticket in.

    Bestanden uploaden naar de blobcontainer

    f. Klik met de rechtermuisknop op de blobcontainer en selecteer Shared Access Signature ophalen.

    De Shared Access Signature voor de blobcontainer ophalen

    g. Maak de SAS-URI voor uw blobcontainer met een voldoende lange verlooptijd en met lees-/schrijf-/lijstmachtigingen. U hebt de SAS-URI nodig om uw aangepaste installatiescript en de bijbehorende bestanden te downloaden en uit te voeren. Dit gebeurt wanneer een knooppunt van uw Azure-SSIS IR opnieuw wordt hersteld of opnieuw wordt opgestart. U hebt ook schrijfmachtigingen nodig voor het uploaden van uitvoeringslogboeken van de installatie.

    Belangrijk

    Zorg ervoor dat de SAS-URI niet verloopt en dat de aangepaste installatieresources altijd beschikbaar zijn gedurende de hele levenscyclus van uw Azure-SSIS IR, van het maken tot het verwijderen, met name als u uw Azure-SSIS IR gedurende deze periode regelmatig stopt en start.

    De Shared Access Signature voor de blobcontainer genereren

    h. Kopieer en sla de SAS-URI van uw blobcontainer op.

    De Shared Access Signature kopiëren en opslaan

  3. Schakel het selectievakje Uw Azure-SSIS Integration Runtime aanpassen met aanvullende systeemconfiguraties/onderdeleninstallaties in op de pagina Geavanceerde instellingen van het installatievenster van Integration Runtime. Voer vervolgens de SAS-URI van uw blobcontainer in het tekstvak SAS-URI voor aangepaste installatiecontainer in.

    Geavanceerde instellingen met aangepaste instellingen

Nadat de standaard aangepaste installatie is voltooid en uw Azure-SSIS IR is gestart, vindt u alle aangepaste installatielogboeken in de map main.cmd.log van uw blobcontainer. Ze bevatten de standaarduitvoer van main.cmd en andere uitvoeringslogboeken.

Express aangepaste installatie

Voer de volgende stappen uit om uw Azure-SSIS IR in te richten of opnieuw te configureren met snelle aangepaste installatie in de ADF-gebruikersinterface.

  1. Schakel het selectievakje Uw Azure-SSIS Integration Runtime aanpassen met aanvullende systeemconfiguraties/onderdeleninstallaties in op de pagina Geavanceerde instellingen van het installatievenster van Integration Runtime.

  2. Selecteer Nieuw om het deelvenster Snelle aangepaste installatie toevoegen te openen en selecteer vervolgens een type in de vervolgkeuzelijst Aangepast installatietype express. Momenteel bieden we express aangepaste instellingen voor het uitvoeren van cmdkey-opdrachten, het toevoegen van omgevingsvariabelen, het installeren van Azure PowerShell en het installeren van gelicentieerde onderdelen.

Opdracht cmdkey uitvoeren

Als u het opdrachttype Cmdkey uitvoeren selecteert voor uw snelle aangepaste installatie, kunt u de Opdracht Windows cmdkey uitvoeren op uw Azure-SSIS IR. Voer hiervoor uw doelcomputernaam of domeinnaam, gebruikersnaam of accountnaam en wachtwoord of accountsleutel in respectievelijk de vakken /Add, /User en /Pass text in. Hiermee kunt u toegangsreferenties behouden voor SQL-servers, bestandsshares of Azure Files in uw Azure-SSIS IR. Als u bijvoorbeeld toegang wilt krijgen tot Azure Files, kunt u respectievelijk /Add, /User en /Pass invoeren YourAzureStorageAccountKey azure\YourAzureStorageAccountNameYourAzureStorageAccountName.file.core.windows.net. Dit is vergelijkbaar met het uitvoeren van de Windows cmdkey-opdracht op uw lokale computer.

Omgevingsvariabelen toevoegen

Als u het type Omgevingsvariabele toevoegen selecteert voor uw snelle aangepaste installatie, kunt u een Windows-omgevingsvariabele toevoegen aan uw Azure-SSIS IR. Voer hiervoor de naam en waarde van de omgevingsvariabele in de tekstvakken Variabelenaam en Variabelewaarde in. Hiermee kunt u de omgevingsvariabele gebruiken in uw pakketten die worden uitgevoerd op Azure-SSIS IR, bijvoorbeeld in Script Components/Tasks. Dit is vergelijkbaar met het uitvoeren van de Windows-setopdracht op uw lokale computer.

Azure PowerShell installeren

Als u het Azure PowerShell-type installeren selecteert voor uw snelle aangepaste installatie, kunt u de Az-module van PowerShell installeren op uw Azure-SSIS IR. Voer hiervoor het versienummer van de Az-module (x.y.z) in dat u wilt gebruiken in een lijst met ondersteunde versies. Hiermee kunt u Azure PowerShell-cmdlets/scripts uitvoeren in uw pakketten om Azure-resources te beheren, bijvoorbeeld Azure Analysis Services (AAS).

Gelicentieerde onderdelen installeren

Als u het type gelicentieerde onderdeel installeren selecteert voor uw snelle aangepaste installatie, kunt u vervolgens een geïntegreerd onderdeel van onze ISV-partners selecteren in de vervolgkeuzelijst Componentnaam :

  • Als u het Taakfactory-onderdeel van SentryOne selecteert, kunt u de Task Factory-suite met onderdelen van SentryOne installeren op uw Azure-SSIS IR door de productlicentiecode in te voeren die u bij hen hebt gekocht in het vak Licentiesleutel. De huidige geïntegreerde versie is 2021.18.1.

  • Als u de HEDDA van oh22 selecteert. IO-onderdeel , kunt u de HEDDA installeren. Io-gegevenskwaliteit /opschoningsonderdeel van oh22 op uw Azure-SSIS IR. Hiervoor moet u vooraf hun service aanschaffen. De huidige geïntegreerde versie is 1.0.14.

  • Als u het SQLPhonetics.NET-onderdeel van de oh22 selecteert, kunt u het SQLPhonetics.NET gegevenskwaliteit/overeenkomende onderdeel van oh22 installeren op uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u vooraf hebt gekocht in het tekstvak Licentiesleutel . De huidige geïntegreerde versie is 1.0.45.

  • Als u het onderdeel SSIS Integration Toolkit van KingswaySoft selecteert, kunt u de SSIS Integration Toolkit-suite met connectors voor CRM/ERP/marketing/samenwerking-apps, zoals Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud, enzovoort, installeren vanuit KingswaySoft op uw Azure-SSIS IR door de productlicentiecode in te voeren die u bij hen hebt gekocht in het vak Licentiesleutel . De huidige geïntegreerde versie is 23.1.

  • Als u het onderdeel SSIS Productivity Pack van KingswaySoft selecteert, kunt u de SSIS Productivity Pack-suite met onderdelen van KingswaySoft installeren op uw Azure-SSIS IR door de productlicentiecode in te voeren die u bij hen hebt gekocht in het vak Licentiesleutel . De huidige geïntegreerde versie is 23.1.

  • Als u het Xtract IS-onderdeel van Theobald Software selecteert, kunt u de Xtract IS-suite met connectors voor SAP-systeem (ERP, S/4HANA, BW) installeren vanuit Theobald Software op uw Azure-SSIS IR door het productlicentiebestand dat u ervan hebt gekocht, naar het vak Licentiebestand te slepen en te uploaden. De huidige geïntegreerde versie is 6.9.3.26.

  • Als u het integratieserviceonderdeel van AecorSoft selecteert, kunt u de Integration Service-suite met connectors voor SAP- en Salesforce-systemen installeren vanuit AecorSoft op uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u vooraf hebt gekocht in het tekstvak Licentiesleutel . De huidige geïntegreerde versie is 3.0.00.

  • Als u het SSIS Standard Package-onderdeel van CData selecteert, kunt u de SSIS Standard Package-suite van de populairste onderdelen van CData, zoals Microsoft SharePoint-connectors, installeren in uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u vooraf hebt gekocht in het tekstvak Licentiesleutel . De huidige geïntegreerde versie is 21.7867.

  • Als u het SSIS Extended Package-onderdeel van CData selecteert, kunt u de SSIS Extended Package-suite van alle onderdelen van CData installeren, zoals Microsoft Dynamics 365 Business Central-connectors en andere onderdelen in hun SSIS Standard-pakket, op uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u vooraf hebt gekocht in het tekstvak Licentiesleutel . De huidige geïntegreerde versie is 21.7867. Vanwege de grote grootte moet u ervoor zorgen dat uw Azure-SSIS IR ten minste 4 CPU-kernen per knooppunt heeft om de installatietime-out te voorkomen.

Uw toegevoegde snelle aangepaste instellingen worden weergegeven op de pagina Geavanceerde instellingen . Als u deze wilt verwijderen, schakelt u de selectie vakjes in en selecteert u Verwijderen.

Azure PowerShell

Voer de volgende stappen uit om uw Azure-SSIS IR met aangepaste instellingen in te richten of opnieuw te configureren met behulp van Azure PowerShell.

  1. Als uw Azure-SSIS IR al is gestart/uitgevoerd, moet u deze eerst stoppen.

  2. U kunt vervolgens aangepaste instellingen toevoegen of verwijderen door de Set-AzDataFactoryV2IntegrationRuntime cmdlet uit te voeren voordat u uw Azure-SSIS IR start.

    $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
    

Standaardvoorbeelden voor aangepaste installatie

  1. U kunt enkele voorbeelden van standaard aangepaste instellingen bekijken en opnieuw gebruiken:

    a. In deze map bevinden zich de volgende items:

    • Een voorbeeldmap , die een aangepaste installatie bevat voor het installeren van een basistaak op elk knooppunt van uw Azure-SSIS IR. De taak doet niets anders dan een paar seconden in de slaapstand. De map bevat ook een gacutil-map , waarvan de volledige inhoud (gacutil.exe, gacutil.exe.config en 1033\gacutlrc.dll) naar uw blobcontainer kan worden gekopieerd.

    • Een map UserScenarios, die verschillende aangepaste installatievoorbeelden van echte gebruikersscenario's bevat. Als u meerdere voorbeelden wilt installeren in uw Azure-SSIS IR, kunt u hun aangepaste installatiescriptbestanden (main.cmd) combineren tot één en deze uploaden met alle bijbehorende bestanden in uw blobcontainer.

      Inhoud van de openbare preview-blobcontainer

    b. Dubbelklik op de map UserScenarios om de volgende items te vinden:

    • Een .NET FRAMEWORK 3.5-map , die een aangepast installatiescript (main.cmd) bevat om een eerdere versie van .NET Framework te installeren op elk knooppunt van uw Azure-SSIS IR. Deze versie is mogelijk vereist voor bepaalde aangepaste onderdelen.

    • Een BCP-map , die een aangepast installatiescript (main.cmd) bevat voor het installeren van SQL Server-opdrachtregelprogramma's (MsSqlCmdLnUtils.msi) op elk knooppunt van uw Azure-SSIS IR. Een van deze hulpprogramma's is het programma voor bulkkopiekopie (bcp).

    • Een dns-achtervoegselmap , die een aangepast installatiescript (main.cmd) bevat om uw eigen DNS-achtervoegsel (bijvoorbeeld test.com) toe te voegen aan een niet-gekwalificeerde domeinnaam met één label en deze om te zetten in een FQDN (Fully Qualified Domain Name) voordat u het in DNS-query's van uw Azure-SSIS IR gebruikt.

    • Een EXCEL-map met een aangepast installatiescript (main.cmd) voor het installeren van enkele C#-assembly's en bibliotheken op elk knooppunt van uw Azure-SSIS IR. U kunt deze gebruiken in Scripttaken om Excel-bestanden dynamisch te lezen en te schrijven.

      Download eerst ExcelDataReader.dll en DocumentFormat.OpenXml.dll en upload ze allemaal samen met main.cmd naar uw blobcontainer. Als u alleen de standaard Excel-connectors (Verbindingsbeheer, bron en bestemming) wilt gebruiken, is access redistributable die deze bevat, al vooraf geïnstalleerd op uw Azure-SSIS IR, zodat u geen aangepaste installatie nodig hebt.

    • Een MYSQL ODBC-map , die een aangepast installatiescript (main.cmd) bevat om de MySQL ODBC-stuurprogramma's op elk knooppunt van uw Azure-SSIS IR te installeren. Met deze installatie kunt u de ODBC-connectors (Verbindingsbeheer, bron en doel) gebruiken om verbinding te maken met de MySQL-server.

      Download eerst de nieuwste 64-bits en 32-bits versies van de mySQL ODBC-stuurprogrammainstallatieprogramma's (bijvoorbeeld mysql-connector-odbc-8.0.13-winx64.msi en mysql-connector-odbc-8.0.13-win32.msi) en upload ze allemaal samen met main.cmd naar uw blobcontainer.

      Als DSN (Data Source Name) in verbinding wordt gebruikt, is de DSN-configuratie nodig in het installatiescript. Bijvoorbeeld: C:\Windows\SysWOW64\odbcconf.exe /A {CONFIGSYSDSN "MySQL ODBC 8.0 Unicode-stuurprogramma" "DSN=<dsnname>|PORT=3306 |SERVER=<servernaam>"}

    • Een ORACLE ENTERPRISE-map , die een aangepast installatiescript (main.cmd) bevat om de Oracle-connectors en het OCI-stuurprogramma te installeren op elk knooppunt van uw Azure-SSIS IR Enterprise Edition. Met deze installatie kunt u de Oracle-Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de Oracle-server.

      Download eerst Microsoft Connectors v5.0 voor Oracle (AttunitySSISOraAdaptersSetup.msi en AttunitySSISOraAdaptersSetup64.msi) vanuit het Microsoft Downloadcentrum en de nieuwste Oracle Instant Client (bijvoorbeeld instantclient-basic-windows.x64-21.3.0.0.0.zip) van Oracle. Upload ze vervolgens allemaal samen met main.cmd naar uw blobcontainer. Als u TNS gebruikt om verbinding te maken met Oracle, moet u ook tnsnames.ora downloaden, bewerken en uploaden naar uw blobcontainer. Op deze manier kan deze tijdens de installatie worden gekopieerd naar de Oracle-installatiemap.

    • Een ORACLE STANDARD-ADO.NET map, die een aangepast installatiescript (main.cmd) bevat om het Oracle ODP.NET-stuurprogramma op elk knooppunt van uw Azure-SSIS IR te installeren. Met deze installatie kunt u de ADO.NET Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de Oracle-server.

      Download eerst het meest recente Oracle ODP.NET-stuurprogramma (bijvoorbeeld ODP.NET_Managed_ODAC122cR1.zip) en upload het vervolgens samen met main.cmd naar uw blobcontainer.

    • Een ORACLE STANDARD ODBC-map , die een aangepast installatiescript (main.cmd) bevat om het Oracle ODBC-stuurprogramma op elk knooppunt van uw Azure-SSIS IR te installeren. Het script configureert ook de naam van de gegevensbron (DSN). Met deze installatie kunt u de ODBC-Verbindingsbeheer, bron en bestemming of Power Query Verbindingsbeheer en bron gebruiken met het gegevensbrontype ODBC om verbinding te maken met de Oracle-server.

      Download eerst de nieuwste Oracle Instant Client (Basic Package of Basic Lite Package) en ODBC Package en upload ze vervolgens allemaal samen met main.cmd naar uw blobcontainer:

      • 64-bits pakketten downloaden (Basispakket: instantclient-basic-windows.x64-18.3.0.0.0dbru.zip; Basic Lite-pakket: instantclient-basiclite-windows.x64-18.3.0.0.0dbru.zip; ODBC-pakket: instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip)
      • 32-bits pakketten downloaden (basispakket: instantclient-basic-nt-18.3.0.0.0dbru.zip; Basic Lite-pakket: instantclient-basiclite-nt-18.3.0.0.0dbru.zip; ODBC-pakket: instantclient-odbc-nt-18.3.0.0.0dbru.zip)
    • Een ORACLE STANDARD OLEDB-map , die een aangepast installatiescript (main.cmd) bevat om het Oracle OLEDB-stuurprogramma op elk knooppunt van uw Azure-SSIS IR te installeren. Met deze installatie kunt u de OLEDB-Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de Oracle-server.

      Download eerst het nieuwste Oracle OLEDB-stuurprogramma (bijvoorbeeld ODAC122010Xcopy_x64.zip) en upload het vervolgens samen met main.cmd naar uw blobcontainer.

    • Een POSTGRESQL ODBC-map , die een aangepast installatiescript (main.cmd) bevat om de PostgreSQL ODBC-stuurprogramma's op elk knooppunt van uw Azure-SSIS IR te installeren. Met deze installatie kunt u de ODBC-Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de PostgreSQL-server.

      Download eerst de nieuwste 64-bits en 32-bits versies van postgreSQL ODBC-stuurprogrammainstallatieprogramma's (bijvoorbeeld psqlodbc_x64.msi en psqlodbc_x86.msi) en upload ze allemaal samen met main.cmd naar uw blobcontainer.

    • Een SAP BW-map , die een aangepast installatiescript (main.cmd) bevat om de ASSEMBLY van de SAP .NET-connector (librfc32.dll) te installeren op elk knooppunt van uw Azure-SSIS IR Enterprise Edition. Met deze installatie kunt u de SAP BW-Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de SAP BW-server.

      Upload eerst de 64-bits of 32-bits versie van librfc32.dll uit de SAP-installatiemap, samen met main.cmd naar uw blobcontainer. Het script kopieert vervolgens de SAP-assembly naar de map %windir%\SysWow64 of %windir%\System32 tijdens de installatie.

    • Een STORAGE-map , die een aangepast installatiescript (main.cmd) bevat om Azure PowerShell te installeren op elk knooppunt van uw Azure-SSIS IR. Met deze installatie kunt u SSIS-pakketten implementeren en uitvoeren waarop Azure PowerShell-cmdlets/-scripts worden uitgevoerd om uw Azure Storage te beheren.

      Kopieer main.cmd, een voorbeeld AzurePowerShell.msi (of gebruik de nieuwste versie) en storage.ps1 naar uw blobcontainer. Gebruik PowerShell.dtsx als sjabloon voor uw pakketten. De pakketsjabloon combineert een Azure Blob-downloadtaak, waarmee een wijzigbaar PowerShell-script (storage.ps1) en een execute process task wordt gedownload, waarmee het script op elk knooppunt wordt uitgevoerd.

    • Een TERADATA-map , die een aangepast installatiescript (main.cmd), het bijbehorende bestand (install.cmd) en installatiepakketten (.msi) bevat. Met deze bestanden worden de Teradata-connectors, de TPT-API (Teradata Parallel Transporter) en het ODBC-stuurprogramma op elk knooppunt van uw Azure-SSIS IR Enterprise Edition geïnstalleerd. Met deze installatie kunt u de Teradata-Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de Teradata-server.

      Download eerst het ZIP-bestand van Teradata Tools and Utilities 15.x (bijvoorbeeld TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip) en upload het vervolgens samen met de eerder genoemde .cmd- en .msi-bestanden naar uw blobcontainer.

    • Een TLS 1.2-map , die een aangepast installatiescript (main.cmd) bevat om alleen sterke cryptografie/veiliger netwerkprotocol (TLS 1.2) te gebruiken op elk knooppunt van uw Azure-SSIS IR. Met het script worden ook oudere SSL/TLS-versies (SSL 3.0, TLS 1.0, TLS 1.1) tegelijkertijd uitgeschakeld.

    • Een ZULU OPENJDK-map , die een aangepast installatiescript (main.cmd) en Een PowerShell-bestand (install_openjdk.ps1) bevat om de Zulu OpenJDK te installeren op elk knooppunt van uw Azure-SSIS IR. Met deze installatie kunt u Azure Data Lake Store- en Flexible File-connectors gebruiken om ORC- en Parquet-bestanden te verwerken. Zie Azure Feature Pack voor Integration Services voor meer informatie.

      Download eerst de nieuwste Zulu OpenJDK (bijvoorbeeld zulu8.33.0.1-jdk8.0.192-win_x64.zip) en upload deze vervolgens samen met main.cmd en install_openjdk.ps1 naar uw blobcontainer.

      Mappen in de map gebruikersscenario's

    c. Als u deze standaard aangepaste installatievoorbeelden opnieuw wilt gebruiken, kopieert u de inhoud van de geselecteerde map naar uw blobcontainer.

  2. Wanneer u uw Azure-SSIS IR in ADF UI inricht of opnieuw configureert, schakelt u het selectievakje Uw Azure-SSIS Integration Runtime aanpassen met aanvullende systeemconfiguraties/onderdeleninstallaties in op de pagina Geavanceerde instellingen van het installatievenster van Integration Runtime. Voer vervolgens de SAS-URI van uw blobcontainer in het tekstvak SAS-URI voor aangepaste installatiecontainer in.

  3. Wanneer u uw Azure-SSIS IR inricht of opnieuw configureert met behulp van Azure PowerShell, stopt u deze als deze al is gestart/wordt uitgevoerd, voert u de Set-AzDataFactoryV2IntegrationRuntime cmdlet uit met de SAS-URI van uw blobcontainer als de waarde voor SetupScriptContainerSasUri de parameter en start u vervolgens uw Azure-SSIS IR.

  4. Nadat de standaard aangepaste installatie is voltooid en uw Azure-SSIS IR is gestart, vindt u alle aangepaste installatielogboeken in de map main.cmd.log van uw blobcontainer. Ze bevatten de standaarduitvoer van main.cmd en andere uitvoeringslogboeken.