De installatie voor een Azure-SSIS-Integration Runtime aanpassen

Artikel
07/17/2023

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

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

U kunt uw Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) in Azure Data Factory (ADF) of Synapse Pipelines aanpassen 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, moet u toegangsreferenties voor bestandsshares behouden of alleen sterke cryptografie/veiliger netwerkprotocol (TLS 1.2) gebruiken. U kunt ook extra onderdelen, zoals assembly's, stuurprogramma's of extensies, installeren op elk knooppunt van uw Azure-SSIS IR. Ze kunnen op maat gemaakte, open source- 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 aangepaste instellingen op uw Azure-SSIS IR op twee manieren uitvoeren:

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-URI (Uniform Resource Identifier) 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 een aantal populaire of aanbevolen extra onderdelen zonder scripts te gebruiken.

U kunt zowel gratis (zonder licentie) 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 een latere reeks knooppunten te gebruiken voor uw Azure-SSIS IR met aangepaste installatie.

Huidige beperkingen

De volgende beperkingen zijn alleen van toepassing op standaard aangepaste instellingen:

Als u gacutil.exe in uw script wilt gebruiken om assembly's te installeren in de Global Assembly Cache (GAC), moet u gacutil.exe opgeven als onderdeel van uw aangepaste installatie. U kunt ook de kopie gebruiken die is opgegeven in de map Sample van onze openbare preview-blobcontainer. Zie de sectie Standaardvoorbeelden voor aangepaste installatie hieronder.
Als u wilt verwijzen naar een submap in uw script, msiexec.exe geen ondersteuning biedt 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 worden gemaakt door Windows, worden momenteel niet ondersteund op de Azure-SSIS IR.
Het ODBC-stuurprogramma IBM iSeries Access wordt niet ondersteund op de Azure-SSIS IR. Tijdens de aangepaste installatie kunnen er installatiefouten optreden. Als u dit doet, neemt u contact op met de ondersteuning van IBM 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 uw 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.

Standaard aangepaste installatie

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.

Bereid uw aangepaste installatiescript en de bijbehorende bestanden (bijvoorbeeld .bat-, .cmd-, .exe-, .dll-, .msi- of .ps1-bestanden) voor.
- U moet een scriptbestand met de naam main.cmd hebben. 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 worden gegenereerd (bijvoorbeeld msiexec.exe) moeten worden geüpload naar uw blobcontainer, geeft u de vooraf gedefinieerde omgevingsvariabele , CUSTOM_SETUP_SCRIPT_LOG_DIRop als de logboekmap in uw scripts (bijvoorbeeld msiexec /i xxx.msi /quiet /lv %CUSTOM_SETUP_SCRIPT_LOG_DIR%\install.log).
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.

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.

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

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 later duurt 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 voor het downloaden van alle bestanden van uw blobcontainer en het installeren ervan op de Azure-SSIS IR. Als het instellen meer tijd kost, dient u een ondersteuningsticket in.

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

g. Maak de SAS-URI voor uw blobcontainer met een voldoende lange verlooptijd en met lees-/schrijf-/lijstmachtiging. 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 geïnstalleerd of opnieuw wordt opgestart. U hebt ook schrijfmachtigingen nodig om uitvoeringslogboeken van de installatie te uploaden.

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 regelmatig stopt en start tijdens deze periode.

h. Kopieer de SAS-URI van uw blobcontainer en sla deze op.
Schakel het selectievakje Uw Azure-SSIS-Integration Runtime aanpassen met aanvullende systeemconfiguraties/onderdeleninstallaties in op de pagina Geavanceerde instellingen van het deelvenster Integratieruntime instellen. Voer vervolgens de SAS-URI van uw blobcontainer in het tekstvak SAS-URI van aangepaste installatiecontainer in.

Nadat uw standaard aangepaste installatie is voltooid en uw Azure-SSIS IR wordt 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.

Snelle aangepaste installatie

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

Schakel het selectievakje Uw Azure-SSIS-Integration Runtime aanpassen met aanvullende systeemconfiguraties/onderdeleninstallaties in op de pagina Geavanceerde instellingen van het deelvenster Integratieruntime instellen.
Selecteer Nieuw om het deelvenster Snelle aangepaste installatie toevoegen te openen en selecteer vervolgens een type in de vervolgkeuzelijst Aangepast installatietype express . We bieden momenteel snelle aangepaste instellingen voor het uitvoeren van de opdracht cmdkey, 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 de naam of domeinnaam van de doelcomputer, gebruikersnaam of accountnaam en wachtwoord of accountsleutel in de tekstvakken /Toevoegen, /Gebruiker en /Pass in. Hiermee kunt u toegangsreferenties voor SQL-servers, bestandsshares of Azure Files op uw Azure-SSIS IR behouden. Als u bijvoorbeeld toegang wilt krijgen tot Azure Files, kunt u , azure\YourAzureStorageAccountNameen YourAzureStorageAccountKey invoeren YourAzureStorageAccountName.file.core.windows.netvoor respectievelijk /Toevoegen, /Gebruiker en /Pass. 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 Scriptonderdelen/Taken. 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 uit een lijst met ondersteunde versies. Hiermee kunt u Azure PowerShell cmdlets/scripts in uw pakketten uitvoeren om Azure-resources te beheren, bijvoorbeeld Azure Analysis Services (AAS).

Gelicentieerde onderdelen installeren

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

Als u het onderdeel Taakfactory van SentryOne selecteert, kunt u de Task Factory-suite met onderdelen van SentryOne installeren op uw Azure-SSIS IR door de productlicentiecode die u bij hen hebt gekocht in het vak Licentiesleutel in te voeren. De huidige geïntegreerde versie is 2020.21.2.
Als u de oh22's HEDDA selecteert. IO-onderdeel: u kunt de HEDDA installeren. Io-gegevenskwaliteit/-opschoningsonderdeel van oh22 op uw Azure-SSIS IR. Hiervoor moet u hun service van tevoren aanschaffen. De huidige geïntegreerde versie is 1.0.14.
Als u het SQLPhonetics.NET-onderdeel van oh22 selecteert, kunt u het onderdeel SQLPhonetics.NET gegevenskwaliteit/-matching van oh22 installeren op uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u van tevoren bij hen hebt gekocht in het tekstvak Licentiecode . 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/samenwerkings-apps installeren, zoals Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud, enzovoort. van KingswaySoft op uw Azure-SSIS IR door de productlicentiecode die u bij hen hebt gekocht in het vak Licentiecode in te voeren. De huidige geïntegreerde versie is 21.2.
Als u het onderdeel SSIS Productivity Pack van KingswaySoft selecteert, kunt u de SSIS Productivity Pack-suite met onderdelen van KingswaySoft op uw Azure-SSIS IR installeren door de productlicentiecode die u bij hen hebt gekocht in het vak Licentiecode in te voeren. De huidige geïntegreerde versie is 21.2.
Als u het onderdeel Xtract IS van Theobald Software selecteert, kunt u de Xtract IS-suite met connectors voor HET SAP-systeem (ERP, S/4HANA, BW) van Theobald Software op uw Azure-SSIS IR installeren door het productlicentiebestand dat u bij hen hebt gekocht, te slepen & naar het vak Licentiebestand. De huidige geïntegreerde versie is 6.5.13.18.
Als u het onderdeel Integratieservice van AecorSoft selecteert, kunt u de Integration Service-suite met connectors voor SAP- en Salesforce-systemen van AecorSoft installeren op uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u van tevoren bij hen hebt gekocht in het tekstvak Licentiecode . De huidige geïntegreerde versie is 3.0.00.
Als u het onderdeel SSIS Standard Package van CData selecteert, kunt u de SSIS Standard Package-suite met de populairste onderdelen van CData, zoals Microsoft SharePoint-connectors, installeren op uw Azure-SSIS IR. Voer hiervoor de productlicentiecode in die u van tevoren bij hen hebt gekocht in het tekstvak Licentiecode . De huidige geïntegreerde versie is 21.7867.
Als u het onderdeel SSIS Extended Package van CData selecteert, kunt u het SSIS Extended Package-pakket 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 van tevoren bij hen hebt gekocht in het tekstvak Licentiecode . 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 time-outs voor de installatie 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.

Als uw Azure-SSIS IR al is gestart/wordt uitgevoerd, stopt u deze eerst.

Vervolgens kunt u aangepaste instellingen toevoegen of verwijderen door de Set-AzDataFactoryV2IntegrationRuntime cmdlet uit te voeren voordat u uw 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

Voorbeelden van aangepaste standaardinstellingen

Voer de volgende stappen uit om enkele voorbeelden van aangepaste standaardinstellingen weer te geven en opnieuw te gebruiken.

Maak verbinding met onze openbare preview-blobcontainer met behulp van Azure Storage Explorer.

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

b. Selecteer Blob-container, selecteer Shared Access Signature URL (SAS) en selecteer vervolgens Volgende.

c. Voer in het tekstvak SAS-URL van blobcontainer de SAS-URI voor de openbare preview-blobcontainer hieronder in, selecteer Volgende en selecteer vervolgens Verbinding maken.

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. Selecteer in het linkerdeelvenster de verbonden publicpreview-blobcontainer en dubbelklik vervolgens op de map CustomSetupScript . 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 alleen maar een paar seconden in de slaapstand. De map bevat ook een gacutil-map , waarvan de volledige inhoud (gacutil.exe, gacutil.exe.configen 1033\gacutlrc.dll) als zodanig kan worden gekopieerd naar uw blobcontainer.
- Een map UserScenarios , die verschillende aangepaste installatievoorbeelden van echte gebruikersscenario's bevat. Als u meerdere voorbeelden op uw Azure-SSIS IR wilt installeren, kunt u hun aangepaste installatiescriptbestanden (main.cmd) combineren tot één bestand en deze met alle bijbehorende bestanden uploaden naar uw blobcontainer.
e. Dubbelklik op de map UserScenarios om de volgende items te zoeken:
- Een .NET FRAMEWORK 3.5-map, die een aangepast installatiescript (main.cmd) bevat om een eerdere versie van de .NET Framework te installeren op elk knooppunt van uw Azure-SSIS IR. Deze versie is mogelijk vereist voor sommige aangepaste onderdelen.
- Een BCP-map, die een aangepast installatiescript (main.cmd) bevat om SQL Server opdrachtregelprogramma's (MsSqlCmdLnUtils.msi) te installeren op elk knooppunt van uw Azure-SSIS IR. Een van deze hulpprogramma's is het programma voor bulksgewijs kopiëren (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 gebruikt in DNS-query's van uw Azure-SSIS IR.
- 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.dllen upload ze vervolgens samen met main.cmd naar uw blobcontainer. Als u alleen de standaard Excel-connectors (Verbindingsbeheer, Bron en Bestemming) wilt gebruiken, is de Access Redistributable die ze 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 voor het installeren van de MySQL ODBC-stuurprogramma's op elk knooppunt van uw Azure-SSIS IR. 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-stuurprogramma-installatieprogramma's (bijvoorbeeld mysql-connector-odbc-8.0.13-winx64.msi en mysql-connector-odbc-8.0.13-win32.msi), en upload ze vervolgens samen met main.cmd naar uw blobcontainer.
  
  Als DSN (Data Source Name) wordt gebruikt in de verbinding, is 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 het tijdens de installatie naar de Oracle-installatiemap worden gekopieerd.
- Een oracle standard ADO.NET map, die een aangepast installatiescript (main.cmd) bevat om het Oracle ODP.NET-stuurprogramma te installeren op elk knooppunt van uw Azure-SSIS IR. 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 dit samen met main.cmd naar uw blobcontainer.
- Een ORACLE STANDARD ODBC-map, die een aangepast installatiescript (main.cmd) bevat om het Oracle ODBC-stuurprogramma te installeren op elk knooppunt van uw Azure-SSIS IR. 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 met het ODBC-gegevensbrontype gebruiken om verbinding te maken met de Oracle-server.
  
  Download eerst de meest recente Oracle Instant Client (Basic Package of Basic Lite Package) en het ODBC-pakket en upload ze 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 te installeren op elk knooppunt van uw Azure-SSIS IR. Met deze installatie kunt u de OLEDB-Verbindingsbeheer, bron en bestemming gebruiken om verbinding te maken met de Oracle-server.
  
  Download eerst het meest recente 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 te installeren op elk knooppunt van uw Azure-SSIS IR. 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-stuurprogramma-installatieprogramma's (bijvoorbeeld psqlodbc_x64.msi en psqlodbc_x86.msi), en upload ze vervolgens samen met main.cmd naar uw blobcontainer.
- Een SAP BW-map, die een aangepast installatiescript (main.cmd) bevat voor het installeren van de SAP .NET-connectorassembly (librfc32.dll) 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 de 32-bits versie van librfc32.dll vanuit de SAP-installatiemap samen met main.cmd naar uw blobcontainer. Het script kopieert vervolgens de SAP-assembly tijdens de installatie naar de map %windir%\SysWow64 of %windir%\System32 .
- 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 die Azure PowerShell cmdlets/scripts uitvoeren 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) wordt gedownload, en een procestaak Uitvoeren, 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 geïnstalleerd op elk knooppunt van uw Azure-SSIS IR Enterprise Edition. 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 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/veiligere netwerkprotocol (TLS 1.2) te gebruiken op elk knooppunt van uw Azure-SSIS IR. Het script schakelt ook oudere SSL/TLS-versies (SSL 3.0, TLS 1.0, TLS 1.1) tegelijkertijd uit.
- Een ZULU OPENJDK-map, die een aangepast installatiescript (main.cmd) en een PowerShell-bestand (install_openjdk.ps1) bevat om 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 meest recente Zulu OpenJDK (bijvoorbeeld zulu8.33.0.1-jdk8.0.192-win_x64.zip) en upload deze samen met main.cmd en install_openjdk.ps1 naar uw blobcontainer.
f. Als u deze standaardvoorbeelden voor aangepaste installatie opnieuw wilt gebruiken, kopieert u de inhoud van de geselecteerde map naar uw blobcontainer.
Wanneer u uw Azure-SSIS IR in de ADF-gebruikersinterface 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 deelvenster Integratieruntime-installatie. Voer vervolgens de SAS-URI van uw blobcontainer in het tekstvak SAS-URI van aangepaste installatiecontainer in.
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 parameter en start u vervolgens uw Azure-SSIS IR.
Nadat uw standaard aangepaste installatie is voltooid en uw Azure-SSIS IR wordt 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.