Condividi tramite


Personalizzare l'installazione di Azure-SSIS Integration Runtime

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

È possibile personalizzare il runtime di integrazione di Azure-SQL Server Integration Services (SSIS) in Azure Data Factory (ADF) o nelle pipeline di Synapse tramite configurazioni personalizzate. Consentono di aggiungere passaggi personalizzati durante il provisioning o la riconfigurazione del runtime di integrazione Azure-SSIS.

Usando le configurazioni personalizzate, è possibile modificare la configurazione operativa predefinita o l'ambiente del runtime di integrazione Azure-SSIS. Ad esempio, per avviare servizi Windows aggiuntivi, rendere persistenti le credenziali di accesso per le condivisioni file o usare solo la crittografia avanzata/protocollo di rete più sicuro (TLS 1.2). In alternativa, è possibile installare componenti aggiuntivi, ad esempio assembly, driver o estensioni, in ogni nodo di Azure-SSIS IR. Possono essere componenti personalizzati, open source o di terze parti. Per altre informazioni sui componenti predefiniti/preinstallati, vedere Componenti predefiniti e preinstallati in Azure-SSIS Integration Runtime.

È possibile eseguire installazioni personalizzate in Azure-SSIS IR in uno dei due modi seguenti:

  • Configurazione personalizzata standard con uno script: preparare uno script e i relativi file associati e caricarli tutti insieme in un contenitore BLOB nell'account Archiviazione di Azure. Si specifica quindi un URI (Uniform Resource Identifier) di firma di accesso condiviso (SAS) per il contenitore BLOB quando si configura o si riconfigura il runtime di integrazione Azure-SSIS. Ogni nodo del runtime di integrazione Azure-SSIS scarica quindi lo script e i file associati dal contenitore BLOB ed esegue la configurazione personalizzata con autorizzazioni elevate. Al termine dell'installazione personalizzata, ogni nodo carica l'output standard di esecuzione e altri log nel contenitore BLOB.
  • Installazione personalizzata rapida senza uno script: eseguire alcune configurazioni di sistema comuni e comandi di Windows oppure installare alcuni componenti aggiuntivi più diffusi o consigliati senza usare script.

È possibile installare componenti gratuiti (senza licenza) e a pagamento (con licenza) con configurazioni personalizzate standard ed express. Se si è un fornitore di software indipendente (ISV), vedere Sviluppare componenti a pagamento o concessi in licenza per Azure-SSIS IR.

Importante

Per avere a disposizione i miglioramenti futuri, è consigliabile usare le serie di nodi v3 o successive per Azure-SSIS IR con l'installazione personalizzata.

Limitazioni correnti

Le limitazioni seguenti si applicano solo alle installazioni personalizzate standard:

  • Se si vuole usare gacutil.exe nello script per installare assembly in Global Assembly Cache (GAC), è necessario specificare gacutil.exe come parte dell'installazione personalizzata. In alternativa, è possibile usare la copia fornita nella cartella Sample del contenitore BLOB di anteprima pubblica, vedere la sezione Standard custom setup samples (Esempi di installazione personalizzata Standard).

  • Se si vuole fare riferimento a una sottocartella nello script, msiexec.exe non supporta la notazione .\ usata per i riferimenti alla cartella radice. Usare un comando, ad esempio msiexec /i "MySubfolder\MyInstallerx64.msi" ..., anziché msiexec /i ".\MySubfolder\MyInstallerx64.msi" ....

  • Le condivisioni amministrative o le condivisioni di rete nascoste create automaticamente da Windows non sono attualmente supportate in Azure-SSIS IR.

  • Il driver ODBC IBM iSeries Access non è supportato in Azure-SSIS IR. Potrebbero essere visualizzati errori di installazione durante l'installazione personalizzata. In tal caso, contattare il supporto tecnico IBM per assistenza.

Prerequisiti

Nota

È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.

Per personalizzare Azure-SSIS IR sono necessari gli elementi seguenti:

Istruzioni

È possibile effettuare il provisioning o riconfigurare il runtime di integrazione Azure-SSIS con configurazioni personalizzate nell'interfaccia utente di Azure Data Factory. Se si vuole eseguire la stessa operazione usando PowerShell, scaricare e installare Azure PowerShell.

Configurazione personalizzata standard

Per effettuare il provisioning o riconfigurare il runtime di integrazione Azure-SSIS con configurazioni personalizzate standard nell'interfaccia utente di Azure Data Factory, seguire questa procedura.

  1. Preparare lo script di installazione personalizzato e i file associati (ad esempio file con estensione bat, cmd, exe, dll, msi o ps1).

    • È necessario avere un file di script denominato main.cmd, che è il punto di ingresso dell'installazione personalizzata.
    • Per assicurarsi che lo script possa essere eseguito automaticamente, è necessario testarlo prima nel computer locale.
    • Se si desidera che altri log generati da altri strumenti (ad esempio, msiexec.exe) vengano caricati nel contenitore BLOB, specificare la variabile di ambiente predefinita, CUSTOM_SETUP_SCRIPT_LOG_DIR, come cartella di log negli script( ad esempio msiexec /i xxx.msi /quiet /lv %CUSTOM_edizione Standard TUP_SCRIPT_LOG_DIR%\install.log).
  2. Scaricare, installare e aprire Azure Storage Explorer.

    a. In Locale e Collegato fare clic con il pulsante destro del mouse su account Archiviazione e quindi scegliere Connessione per Archiviazione di Azure.

    Connettersi ad Archiviazione di Azure

    b. Selezionare Archiviazione account o servizio, selezionare Nome account e chiave e quindi selezionare Avanti.

    c. Immettere il nome dell'account di archiviazione di Azure e la chiave, selezionare Avanti, quindi selezionare Connetti.

    Specificare il nome e la chiave dell'account di archiviazione

    d. Nell'account di Archiviazione di Azure connesso fare clic con il pulsante destro del mouse su Contenitori BLOB, scegliere Crea contenitore BLOB e assegnare un nome al nuovo contenitore BLOB.

    Creare un contenitore BLOB

    e. Selezionare il nuovo contenitore BLOB e caricare lo script di installazione personalizzato e i file associati. Assicurarsi di caricare main.cmd al livello superiore del contenitore BLOB, non in alcuna cartella. Il contenitore BLOB deve contenere solo i file di installazione personalizzati necessari, quindi il download nel runtime di integrazione Azure-SSIS in un secondo momento non richiederà molto tempo. La durata massima di un'installazione personalizzata è attualmente impostata su 45 minuti prima del timeout. Ciò include il tempo necessario per scaricare tutti i file dal contenitore BLOB e installarli nel runtime di integrazione Azure-SSIS. Se l'installazione richiede più tempo, generare un ticket di supporto.

    Caricare i file nel contenitore BLOB

    f. Fare clic con il pulsante destro del mouse sul contenitore BLOB e quindi selezionare Ottieni firma di accesso condiviso.

    Ottenere la firma di accesso condiviso per il contenitore BLOB

    g. Creare l'URI di firma di accesso condiviso per il contenitore BLOB con una scadenza sufficientemente lunga e con autorizzazione di lettura/scrittura/elenco. È necessario l'URI di firma di accesso condiviso per scaricare ed eseguire lo script di installazione personalizzato e i relativi file associati. Ciò si verifica ogni volta che un nodo del runtime di integrazione Azure-SSIS viene ricreato o riavviato. È anche necessaria l'autorizzazione di scrittura per caricare i log di esecuzione dell'installazione.

    Importante

    Assicurarsi che l'URI SAS non scada e che le risorse del programma di installazione siano sempre disponibili durante l'intero ciclo di vita del runtime di integrazione Azure-SSIS, dalla creazione all'eliminazione, soprattutto se si arresta e si riavvia regolarmente il runtime di integrazione Azure-SSIS durante questo periodo.

    Generare la firma di accesso condiviso per il contenitore BLOB

    h. Copiare e salvare l'URI di firma di accesso condiviso del contenitore BLOB.

    Copiare e salvare la firma di accesso condiviso

  3. Selezionare la casella di controllo Personalizza il runtime di integrazione SSIS di Azure con configurazioni di sistema aggiuntive/installazioni di componenti nella pagina Impostazioni avanzate del riquadro Configurazione del runtime di integrazione. Immettere quindi l'URI di firma di accesso condiviso del contenitore BLOB nella casella di testo URI di firma di accesso condiviso del contenitore di installazione personalizzata.

    Impostazioni avanzate per le installazioni personalizzate

Al termine dell'installazione personalizzata standard e all'avvio del runtime di integrazione Azure-SSIS, è possibile trovare tutti i log di installazione personalizzati nella cartella main.cmd.log del contenitore BLOB. Includono l'output standard di main.cmd e altri log di esecuzione.

Configurazione personalizzata rapida

Per effettuare il provisioning o riconfigurare il runtime di integrazione Azure-SSIS con configurazioni personalizzate rapide nell'interfaccia utente di Azure Data Factory, seguire questa procedura.

  1. Selezionare la casella di controllo Personalizza il runtime di integrazione SSIS di Azure con configurazioni di sistema aggiuntive/installazioni di componenti nella pagina Impostazioni avanzate del riquadro Configurazione del runtime di integrazione.

  2. Selezionare Nuovo per aprire il riquadro Aggiungi configurazione personalizzata rapida e quindi selezionare un tipo nell'elenco a discesa Tipo di installazione personalizzata rapida. Attualmente sono disponibili configurazioni personalizzate rapide per l'esecuzione del comando cmdkey, l'aggiunta di variabili di ambiente, l'installazione di Azure PowerShell e l'installazione di componenti con licenza.

Esecuzione del comando cmdkey

Se si seleziona il tipo di comando Esegui cmdkey per l'installazione personalizzata rapida, è possibile eseguire il comando cmdkey di Windows nel runtime di integrazione Azure-SSIS. A tale scopo, immettere rispettivamente il nome del computer o il nome di dominio, il nome utente o l'account e la password o la chiave dell'account nelle caselle di testo /Add, /User e /Pass . In questo modo è possibile rendere persistenti le credenziali di accesso per SQL Server, condivisioni file o File di Azure nel runtime di integrazione Azure-SSIS. Ad esempio, per accedere alle File di Azure, è possibile immettere YourAzureStorageAccountName.file.core.windows.netrispettivamente , azure\YourAzureStorageAccountNamee YourAzureStorageAccountKey per /Add, /User e /Pass. Questa operazione è simile all'esecuzione del comando di Windows cmdkey nel computer locale.

Aggiunta di variabili di ambiente

Se si seleziona Aggiungi tipo di variabile di ambiente per la configurazione personalizzata rapida, è possibile aggiungere una variabile di ambiente Windows nel runtime di integrazione Azure-SSIS. A tale scopo, immettere rispettivamente il nome e il valore della variabile di ambiente nelle caselle di testo Nome variabile e Valore variabile. In questo modo sarà possibile usare la variabile di ambiente nei pacchetti eseguiti in Azure-SSIS IR, ad esempio in Componenti script/attività. Questa operazione è simile all'esecuzione del comando di Windows set nel computer locale.

Installazione di Azure PowerShell

Se si seleziona il tipo installa Azure PowerShell per l'installazione personalizzata rapida, è possibile installare il modulo Az di PowerShell nel runtime di integrazione Azure-SSIS. A tale scopo, immettere il numero di versione del modulo Az (x.y.z) desiderato da un elenco di quelli supportati. In questo modo è possibile eseguire cmdlet/script di Azure PowerShell nei pacchetti per gestire le risorse di Azure, ad esempio Azure Analysis Services (AAS).

Installazione di componenti con licenza

Se si seleziona il tipo di componente con licenza Installa per l'installazione personalizzata rapida, è possibile selezionare un componente integrato dai partner ISV nell'elenco a discesa Nome componente:

  • Se si seleziona il componente SentryOne's Task Factory, è possibile installare il gruppo di componenti Task Factory di SentryOne in Azure-SSIS IR immettendo il codice di licenza del prodotto acquistato nella casella License key (Codice di licenza). La versione integrata corrente è 2020.21.2.

  • Se si seleziona l'HEDDA di oh22. Componente I/O , è possibile installare HEDDA . Componente I/ O data quality/cleansing da oh22 nel runtime di integrazione Azure-SSIS. A tale scopo, è necessario acquistare il servizio in anticipo. La versione integrata corrente è 1.0.14.

  • Se si seleziona il componente SQL Telefono tics.NET di oh22, è possibile installare il componente SQL Telefono tics.NET data quality/matching da oh22 nel runtime di integrazione Azure-SSIS. A tale scopo, immettere il codice di licenza del prodotto acquistato in anticipo nella casella di testo Codice licenza. La versione integrata corrente è 1.0.45.

  • Se si seleziona il componente KingswaySoft's SSIS Integration Toolkit, è possibile installare il gruppo di connettori SSIS Integration Toolkit per le app CRM, ERP, di marketing e di collaborazione, ad esempio Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud, di KingswaySoft in Azure-SSIS IR immettendo il codice di licenza del prodotto acquistato nella casella License key (Codice di licenza). La versione integrata corrente è 21.2.

  • Se si seleziona il componente KingswaySoft's SSIS Productivity Pack, è possibile installare il gruppo di componenti SSIS Productivity Pack di KingswaySoft in Azure-SSIS IR immettendo il codice di licenza del prodotto acquistato nella casella License key (Codice di licenza). La versione integrata corrente è 21.2.

  • Se si seleziona il componente Theobald Software's Xtract IS, è possibile installare il gruppo di connettori Xtract IS per il sistema SAP (ERP, S/4HANA, BW) di Theobald Software in Azure-SSIS IR trascinando/caricando il file di licenza del prodotto acquistato nella casella License file (File licenza). La versione integrata corrente è 6.5.13.18.

  • Se si seleziona il componente Integration Service di AecorSoft, è possibile installare la suite di connettori integration service per i sistemi SAP e Salesforce da AecorSoft nel runtime di integrazione Azure-SSIS. A tale scopo, immettere il codice di licenza del prodotto acquistato in anticipo nella casella di testo Codice licenza. La versione integrata corrente è 3.0.00.

  • Se si seleziona il componente pacchetto standard SSIS di CData, è possibile installare la suite di pacchetti standard SSIS dei componenti più diffusi da CData, ad esempio i connettori Microsoft SharePoint, nel runtime di integrazione Azure-SSIS. A tale scopo, immettere il codice di licenza del prodotto acquistato in anticipo nella casella di testo Codice licenza. La versione integrata corrente è 21.7867.

  • Se si seleziona il componente pacchetto esteso SSIS di CData, è possibile installare la suite di pacchetti estesi SSIS di tutti i componenti da CData, ad esempio i connettori Microsoft Dynamics 365 Business Central e altri componenti nel pacchetto SSIS Standard, nel runtime di integrazione SSIS di Azure. A tale scopo, immettere il codice di licenza del prodotto acquistato in anticipo nella casella di testo Codice licenza. La versione integrata corrente è 21.7867. A causa delle dimensioni elevate, per evitare il timeout dell'installazione, assicurarsi che il runtime di integrazione Azure-SSIS abbia almeno 4 core CPU per nodo.

Le configurazioni personalizzate rapide aggiunte verranno visualizzate nella pagina Impostazioni avanzate. Per rimuoverle, selezionare le caselle di controllo corrispondenti e quindi selezionare Delete (Elimina).

Azure PowerShell

Per effettuare il provisioning o riconfigurare azure-SSIS IR con configurazioni personalizzate usando Azure PowerShell, seguire questa procedura.

  1. Se il runtime di integrazione Azure-SSIS è già avviato/in esecuzione, arrestarlo per primo.

  2. È quindi possibile aggiungere o rimuovere configurazioni personalizzate eseguendo il cmdlet prima di avviare il Set-AzDataFactoryV2IntegrationRuntime runtime di integrazione Azure-SSIS.

    $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
    

Esempi di configurazione personalizzata standard

  1. È possibile visualizzare e riutilizzare alcuni esempi di configurazioni personalizzate standard:

    a. Questa cartella contiene gli elementi seguenti:

    • Una cartella Sample che contiene un'installazione personalizzata per installare un'attività di base in ogni nodo di Azure-SSIS IR. L'attività non esegue alcuna operazione se non andare in sospensione per pochi secondi. La cartella contiene anche una cartella gacutil , il cui intero contenuto (gacutil.exe, gacutil.exe.config e 1033\gacutlrc.dll) può essere copiato così come è nel contenitore BLOB.

    • Una cartella UserScenarios che contiene diversi esempi di installazioni personalizzate di scenari utente reali. Se si vogliono installare più esempi nel runtime di integrazione Azure-SSIS, è possibile combinare i file di script di installazione personalizzati (main.cmd) in un unico file e caricarlo con tutti i file associati nel contenitore BLOB.

      Contenuto del contenitore BLOB di anteprima pubblica

    b. Fare doppio clic sulla cartella UserScenarios per trovare gli elementi seguenti:

    • Cartella .NET FRAMEWORK 3.5 che contiene uno script di installazione personalizzato (main.cmd) per installare una versione precedente di .NET Framework in ogni nodo del runtime di integrazione Azure-SSIS. Questa versione potrebbe essere richiesta da alcuni componenti personalizzati.

    • Cartella BCP che contiene uno script di installazione personalizzato (main.cmd) per installare le utilità della riga di comando di SQL Server (MsSqlCmdLnUtils.msi) in ogni nodo del runtime di integrazione Azure-SSIS. Una di queste utilità è il programma di copia bulk (bcp).

    • Cartella SUFFIX DNS, che contiene uno script di installazione personalizzato (main.cmd) per aggiungere il proprio suffisso DNS (ad esempio test.com) a qualsiasi nome di dominio di etichetta singola non qualificato e trasformarlo in un nome di dominio completo (FQDN) prima di usarlo nelle query DNS dal runtime di integrazione Azure-SSIS.

    • Cartella EXCEL, che contiene uno script di installazione personalizzato (main.cmd) per installare alcuni assembly e librerie C# in ogni nodo del runtime di integrazione Azure-SSIS. È possibile usarli in Attività script per leggere e scrivere in modo dinamico i file di Excel.

      Prima di tutto, scaricare ExcelDataReader.dll e DocumentFormat.OpenXml.dll e quindi caricarli tutti insieme con main.cmd nel contenitore BLOB. In alternativa, se si vogliono usare solo i connettori excel standard (Gestione connessioni, origine e destinazione), Access Redistributable che li contiene è già preinstallato nel runtime di integrazione Azure-SSIS, quindi non è necessaria alcuna configurazione personalizzata.

    • Una cartella MYSQL ODBC che contiene uno script di installazione personalizzato (main.cmd) per installare i driver ODBC di MySQL in ogni nodo di Azure-SSIS IR. Questa configurazione consente di usare i connettori ODBC (Gestione connessioni, origine e destinazione) per connettersi al server MySQL.

      Prima di tutto, scaricare le versioni più recenti a 64 bit e a 32 bit dei programmi di installazione del driver ODBC MySQL (ad esempio, mysql-connector-odbc-8.0.13-winx64.msi e mysql-connector-odbc-8.0.13-win32.msi) e quindi caricarle tutte insieme con main.cmd nel contenitore BLOB.

      Se il nome dell'origine dati (DSN) viene usato nella connessione, è necessaria la configurazione DSN nello script di installazione. Ad esempio: C:\Windows\SysWOW64\odbcconf.exe /A {CONFIGSYSDSN "Driver Unicode MySQL 8.0 Unicode" "DSN=<dsnname>|PORT=3306|edizione Standard RVER=<nomeserver>"}

    • Cartella ORACLE ENTERPRI edizione Standard che contiene uno script di installazione personalizzato (main.cmd) per installare i connettori Oracle e il driver OCI in ogni nodo del runtime di integrazione Azure-SSIS edizione Enterprise. Questa configurazione consente di usare oracle Gestione connessioni, origine e destinazione per connettersi al server Oracle.

      Prima di tutto, scaricare Microsoft Connessione ors v5.0 per Oracle (AttunitySSISOraAdaptersSetup.msi e AttunitySSISOraAdaptersSetup64.msi) dall'Area download Microsoft e dalla versione più recente di Oracle Instant Client (ad esempio, instantclient-basic-windows.x64-21.3.0.0.0.zip) da Oracle. Successivamente, caricarli tutti insieme con main.cmd nel contenitore BLOB. Se si usa TNS per connettersi a Oracle, è anche necessario scaricare tnsnames.ora, modificarlo e caricarlo nel contenitore BLOB. In questo modo, può essere copiato nella cartella di installazione di Oracle durante l'installazione.

    • Una cartella ORACLE STANDARD ADO.NET che contiene uno script di installazione personalizzato (main.cmd) per installare il driver ODP.NET di Oracle in ogni nodo di Azure-SSIS IR. Questa configurazione consente di usare il ADO.NET Gestione connessioni, l'origine e la destinazione per connettersi al server Oracle.

      Prima di tutto, scaricare il driver oracle ODP.NET più recente (ad esempio, ODP.NET_Managed_ODAC122cR1.zip) e quindi caricarlo insieme a main.cmd nel contenitore BLOB.

    • Cartella ODBC ORACLE STANDARD che contiene uno script di installazione personalizzato (main.cmd) per installare il driver ODBC Oracle in ogni nodo del runtime di integrazione Azure-SSIS. Lo script configura anche il nome dell'origine dati (DSN). Questa configurazione consente di usare il Gestione connessioni ODBC, l'origine e la destinazione o la Gestione connessioni di Power Query e l'origine con il tipo di origine dati ODBC per connettersi al server Oracle.

      Prima di tutto, scaricare la versione più recente di Oracle Instant Client (Basic Package o Basic Lite Package) e ODBC Package e quindi caricarli tutti insieme con main.cmd nel contenitore BLOB:

      • Scaricare i pacchetti a 64 bit (Basic Package: instantclient-basic-windows.x64-18.3.0.0.0dbru.zip; Basic Lite Package: instantclient-basiclite-windows.x64-18.3.0.0.0dbru.zip; Pacchetto ODBC: instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip)
      • Scaricare i pacchetti a 32 bit (Basic Package: instantclient-basic-nt-18.3.0.0.0dbru.zip; Basic Lite Package: instantclient-basiclite-nt-18.3.0.0.0dbru.zip; Pacchetto ODBC: instantclient-odbc-nt-18.3.0.0.0dbru.zip)
    • Una cartella ORACLE STANDARD OLEDB che contiene uno script di installazione personalizzato (main.cmd) per installare il driver OLEDB di Oracle in ogni nodo di Azure-SSIS IR. Questa configurazione consente di usare il Gestione connessioni OLEDB, l'origine e la destinazione per connettersi al server Oracle.

      Prima di tutto, scaricare il driver OLEDB Oracle più recente (ad esempio, ODAC122010Xcopy_x64.zip) e quindi caricarlo insieme a main.cmd nel contenitore BLOB.

    • Una cartella POSTGRESQL ODBC che contiene uno script di installazione personalizzato (main.cmd) per installare i driver ODBC di PostgreSQL in ogni nodo di Azure-SSIS IR. Questa configurazione consente di usare il Gestione connessioni ODBC, l'origine e la destinazione per connettersi al server PostgreSQL.

      Prima di tutto, scaricare le versioni più recenti a 64 bit e a 32 bit dei programmi di installazione del driver ODBC postgreSQL (ad esempio, psqlodbc_x64.msi e psqlodbc_x86.msi) e quindi caricarle tutte insieme con main.cmd nel contenitore BLOB.

    • Una cartella SAP BW che contiene uno script di installazione personalizzato (main.cmd) per installare l'assembly SAP .NET Connector (librfc32.dll) in ogni nodo di Azure-SSIS IR Enterprise Edition. Questa configurazione consente di usare sap BW Gestione connessioni, origine e destinazione per connettersi al server SAP BW.

      Prima di tutto, caricare la versione a 64 bit o a 32 bit di librfc32.dll dalla cartella di installazione SAP insieme a main.cmd nel contenitore BLOB. Lo script copia quindi l'assembly SAP nella cartella %windir%\SysWow64 o %windir%\System32 durante l'installazione.

    • Una cartella STORAGE che contiene uno script di installazione personalizzato (main.cmd) per installare Azure PowerShell in ogni nodo di Azure-SSIS IR. Questa configurazione consente di distribuire ed eseguire pacchetti SSIS che eseguono cmdlet/script di Azure PowerShell per gestire le Archiviazione di Azure.

      Copiare main.cmd, un AzurePowerShell.msi di esempio (o usare la versione più recente) e storage.ps1 nel contenitore BLOB. Usare PowerShell.dtsx come modello per i pacchetti. Il modello di pacchetto combina un'attività di download BLOB di Azure, che scarica uno script di PowerShell modificabile (storage.ps1) e un'attività Esegui processo, che esegue lo script in ogni nodo.

    • Una cartella TERADATA che contiene uno script di installazione personalizzato (main.cmd), il file associato (install.cmd) e i pacchetti di installazione (.msi). Questi file installano i connettori Teradata, l'API TPT (Teradata Parallel Transporter) e il driver ODBC in ogni nodo di Azure-SSIS IR Enterprise Edition. Questa configurazione consente di usare il Gestione connessioni Teradata, l'origine e la destinazione per connettersi al server Teradata.

      Prima di tutto, scaricare il file ZIP 15.x Tools and Utilities 15.x (ad esempio, TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip) e quindi caricarlo insieme ai file .cmd e .msi menzionati in precedenza nel contenitore BLOB.

    • Cartella TLS 1.2, che contiene uno script di installazione personalizzato (main.cmd) per usare solo crittografia avanzata/protocollo di rete più sicuro (TLS 1.2) in ogni nodo del runtime di integrazione Azure-SSIS. Lo script disabilita anche le versioni SSL/TLS precedenti (SSL 3.0, TLS 1.0, TLS 1.1) contemporaneamente.

    • Una cartella ZULU OPENJDK che contiene uno script di installazione personalizzato (main.cmd) e un file di PowerShell (install_openjdk.ps1) per installare Zulu OpenJDK in ogni nodo di Azure-SSIS IR. Questa installazione consente di usare Azure Data Lake Store e connettori File flessibili per elaborare i file ORC e Parquet. Per altre informazioni, vedere Feature Pack di Azure per Integration Services.

      Prima di tutto, scaricare la versione più recente di Zulu OpenJDK (ad esempio, zulu8.33.0.1-jdk8.0.192-win_x64.zip) e quindi caricarla insieme a main.cmd e install_openjdk.ps1 nel contenitore BLOB.

      Cartelle nella cartella degli scenari utente

    c. Per riutilizzare questi esempi di installazione personalizzati standard, copiare il contenuto della cartella selezionata nel contenitore BLOB.

  2. Quando si effettua il provisioning o si riconfigura il runtime di integrazione Azure-SSIS nell'interfaccia utente di Azure Data Factory, selezionare la casella di controllo Personalizza il runtime di integrazione SSIS di Azure con configurazioni di sistema/installazioni componenti aggiuntive nella pagina Impostazioni avanzate del riquadro Configurazione del runtime di integrazione. Immettere quindi l'URI di firma di accesso condiviso del contenitore BLOB nella casella di testo URI di firma di accesso condiviso del contenitore di installazione personalizzata.

  3. Quando si effettua il provisioning o si riconfigura il runtime di integrazione Azure-SSIS usando Azure PowerShell, arrestarlo se è già stato avviato/in esecuzione, eseguire il Set-AzDataFactoryV2IntegrationRuntime cmdlet con l'URI di firma di accesso condiviso del contenitore BLOB come valore per SetupScriptContainerSasUri il parametro e quindi avviare il runtime di integrazione Azure-SSIS.

  4. Al termine dell'installazione personalizzata standard e all'avvio del runtime di integrazione Azure-SSIS, è possibile trovare tutti i log di installazione personalizzati nella cartella main.cmd.log del contenitore BLOB. Includono l'output standard di main.cmd e altri log di esecuzione.