Gestire i pacchetti con l'archivio pacchetti di Azure-SSIS Integration Runtime

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Per trasferire in modalità lift-& shift i carichi di lavoro di SQL Server Integration Services (SSIS) locali nel cloud, è possibile effettuare il provisioning di Azure-SSIS Integration Runtime (IR) in Azure Data Factory (ADF). Per altre informazioni, vedere Effettuare il provisioning di un runtime di integrazione Azure-SSIS. Un Azure-SSIS IR supporta:

• Esecuzione di pacchetti distribuiti nel catalogo SSIS (SSISDB) ospitato da un server di database SQL di Azure o da un'istanza gestita (modello di distribuzione del progetto)
• Esecuzione di pacchetti distribuiti nel file system, in File di Azure o in un database SQL Server (MSDB) ospitato da Istanza gestita di database SQL di Azure (modello di distribuzione del pacchetto)

Quando si utilizza il modello di distribuzione dei pacchetti, è possibile scegliere se si desidera configurare il runtime di integrazione Azure-SSIS con archivi di pacchetti. Forniscono un livello di gestione dei pacchetti sopra il file system, Azure Files, o MSDB su Azure SQL Managed Instance. L'archivio pacchetti di Azure-SSIS IR consente di importare/esportare/eliminare/eseguire pacchetti e monitorare/arrestare l'esecuzione di pacchetti tramite SQL Server Management Studio (SSMS) simile all'archivio pacchetti SSIS legacy.

Connettersi ad Azure-SSIS IR

Una volta effettuato il provisioning della tua IR di Azure-SSIS, puoi connetterti ad essa per esplorare i suoi archivi di pacchetti su SSMS.

Nella finestra Esplora oggetti di SSMS selezionare Azure-SSIS Integration Runtime nel menu a discesa Connetti. Successivamente, accedi ad Azure e seleziona la sottoscrizione pertinente, ADF ed Azure-SSIS IR che hai configurato con gli archivi dei pacchetti. Il runtime di integrazione Azure-SSIS verrà visualizzato con Pacchetti in Esecuzione e nodi Pacchetti Archiviati sotto. Espandi il nodo Pacchetti memorizzati per visualizzare i tuoi archivi di pacchetti. Espandi i negozi di pacchetti per visualizzare le cartelle e i pacchetti sotto. Potrebbe essere richiesto di immettere le credenziali di accesso per gli archivi di pacchetti, se SSMS non riesce a connettersi automaticamente. Ad esempio, se si espande un archivio pacchetti sopra MSDB, potrebbe essere richiesto di connettersi prima a un'Istanza gestita SQL di Azure.

Gestire cartelle e pacchetti

Dopo la connessione ad Azure-SSIS IR in SSMS, è possibile fare clic con il pulsante destro del mouse su qualsiasi archivio pacchetti, cartelle o pacchetti per visualizzare un menu e scegliere Nuova cartella, Importa pacchetto, Esporta pacchetto, Elimina o Aggiorna.

• Selezionare Nuova cartella per creare una nuova cartella per i pacchetti importati.

• Selezionare Importa pacchetto per importare pacchetti da File System, SQL Server (MSDB) o dall'archivio pacchetti SSIS legacy nel proprio archivio pacchetti.

  

  A seconda del percorso del pacchetto da cui eseguire l'importazione, selezionare il server rilevante, il /, immettere le credenziali di accesso, se necessario, selezionare il percorso del pacchetto e immettere il nuovo nome del pacchetto. Quando si importano pacchetti, il livello di protezione non può essere modificato. Per modificarla, utilizzare SQL Server Data Tools (SSDT) o l'utilità da riga di comando dtutil.

  Nota

  L'importazione di pacchetti SSIS negli archivi pacchetti di Azure-SSIS IR può essere eseguita singolarmente e semplicemente li copia nel sistema MSDB/file system/File di Azure sottostante, mantenendo la versione di SQL Server/SSIS.

  Poiché Azure-SSIS IR è attualmente basato su SQL Server 2017, l'esecuzione di pacchetti con versione precedente li aggiornerà in pacchetti SSIS 2017 in fase di esecuzione. L'esecuzione di pacchetti di versioni successive non è supportata.

  Inoltre, poiché gli archivi pacchetti SSIS legacy sono associati a una versione specifica di SQL Server e sono accessibili solo in SSMS per tale versione, i pacchetti con versione precedente negli archivi pacchetti SSIS legacy devono essere esportati in file system prima di poter essere importati negli archivi pacchetti SSIS IR di Azure-SSIS usando SSMS 2019 o versioni successive.

  In alternativa, per importare più pacchetti SSIS negli archivi pacchetti di Azure-SSIS IR durante il cambio del livello di protezione, è possibile usare l'utilità della riga di comando dtutil , vedere Distribuzione di più pacchetti con dtutil.

• Selezionare Esporta Pacchetto per esportare i pacchetti dal proprio archivio pacchetti nel file system, SQL Server (MSDB) o nell'archivio pacchetti SSIS legacy.

  

  A seconda del percorso del pacchetto in cui eseguire l'esportazione, selezionare il tipo di autenticazione server/, immettere le credenziali di accesso, se necessario, e selezionare il percorso del pacchetto. Quando si esportano pacchetti, se sono crittografati, immettere prima le password per decrittografarle e quindi modificare il livello di protezione, ad esempio per evitare di archiviare dati sensibili o crittografarli o tutti i dati con chiave utente o password.

  Nota

  L'esportazione di pacchetti SSIS dagli archivi pacchetti di Azure-SSIS IR può essere eseguita uno alla volta e, se eseguita senza cambiare il livello di protezione, li copia semplicemente mantenendo la versione di SQL Server/SSIS; altrimenti aggiornerà i pacchetti alle versioni SSIS 2019 o successive.

  Poiché Azure-SSIS IR è attualmente basato su SQL Server 2017, l'esecuzione di pacchetti con versione precedente li aggiornerà in pacchetti SSIS 2017 in fase di esecuzione. L'esecuzione di pacchetti di versioni successive non è supportata.

  In alternativa, per esportare più pacchetti SSIS dagli archivi pacchetti azure-SSIS IR durante il cambio del livello di protezione, è possibile usare l'utilità della riga di comando dtutil , vedere Distribuzione di più pacchetti con dtutil.

• Selezionare Elimina per eliminare cartelle/pacchetti esistenti dall'archivio pacchetti.

• Selezionare Aggiorna per visualizzare le cartelle o i pacchetti appena aggiunti nell'archivio pacchetti.

Eseguire pacchetti

Dopo la connessione ad Azure-SSIS IR in SSMS, è possibile fare clic con il pulsante destro del mouse su tutti i pacchetti archiviati per visualizzare un menu e scegliere Esegui pacchetto. Verrà aperta la finestra di dialogo Utilità di Esecuzione Pacchetto, in cui è possibile configurare le esecuzioni dei pacchetti su Azure-SSIS IR come attività Esegui pacchetto SSIS nelle pipeline di ADF.

Le pagine Generale, Configurazioni, Opzioni di esecuzione e Registrazione della finestra di dialogo Utilità pacchetti di esecuzione corrispondono alla scheda Impostazioni dell'attività Esegui pacchetto SSIS. In queste pagine è possibile immettere la password di crittografia per il pacchetto e le informazioni di accesso per il file di configurazione del pacchetto. È anche possibile immettere le credenziali e le proprietà di esecuzione del pacchetto, nonché le informazioni di accesso per la cartella di log. La pagina Imposta valori della finestra di dialogo Utilità esegui pacchetto corrisponde alla scheda Override proprietà dell'attività Esegui pacchetto SSIS, dove è possibile inserire le proprietà esistenti del pacchetto da sovrascrivere. Per maggiori informazioni, vedere Eseguire pacchetti SSIS come attività Esegui pacchetto SSIS nelle pipeline di Azure Data Factory.

Quando si seleziona il pulsante Esegui , verrà generata e attivata automaticamente una nuova pipeline di Azure Data Factory con l'attività Esegui pacchetto SSIS. Se esiste già una pipeline di Azure Data Factory con le stesse impostazioni, verrà rieseguita e non verrà generata una nuova pipeline. La pipeline di Azure Data Factory e l'attività Esegui pacchetto SSIS verranno denominate Pipeline_SSMS_YourPackageName_HashString e Activity_SSMS_YourPackageName rispettivamente.

Monitorare e interrompere i pacchetti in esecuzione

Dopo la connessione ad Azure-SSIS IR in SSMS, è possibile espandere il nodo Pacchetti in esecuzione per visualizzare i pacchetti in esecuzione attualmente. Fare clic con il pulsante destro del mouse su uno di essi per visualizzare un menu e scegliere Arresta o Aggiorna.

• Selezionare Arresta per annullare la pipeline ADF attualmente in esecuzione che esegue il pacchetto come attività Esegui pacchetto SSIS.

• Seleziona Aggiorna per visualizzare i pacchetti recentemente avviati dai tuoi archivi pacchetti.

Monitorare Azure-SSIS IR e modificare gli archivi dei pacchetti

Dopo la connessione ad Azure-SSIS IR in SSMS, è possibile fare clic con il pulsante destro del mouse su di esso per visualizzare un menu e scegliere Vai al portale di Azure Data Factory o Aggiorna.

• Selezionare Vai al portale di Azure Data Factory per aprire la pagina dei runtime di integrazione dell'hub di monitoraggio di Azure Data Factory, in cui è possibile monitorare l'Azure-SSIS IR. Nel riquadro ARCHIVI PACCHETTI è possibile visualizzare il numero di archivi pacchetti collegati al runtime di integrazione Azure-SSIS. Selezionando tale numero verrà visualizzata una finestra in cui è possibile modificare i servizi collegati di Azure Data Factory che archivia le informazioni di accesso per gli archivi pacchetti.

  

• Selezionare Aggiorna per visualizzare le cartelle o i pacchetti appena aggiunti negli archivi pacchetti ed eseguire pacchetti dagli archivi pacchetti.

Distribuzione di più pacchetti con dtutil

Per trasferire i carichi di lavoro SSIS locali su SSIS in Azure Data Factory mantenendo il modello di distribuzione dei pacchetti legacy, è necessario distribuire i pacchetti da file system, MSDB ospitato da SQL Server o archivi di pacchetti SSIS legacy in Azure Files, MSDB ospitato da Istanza Gestita di SQL di Azure o archivi pacchetti di Azure-SSIS IR. Allo stesso tempo, è anche necessario passare dal livello di protezione dalla crittografia tramite chiave utente alla crittografia non crittografata o alla crittografia tramite password, se non è già stato fatto.

È possibile usare l'utilità della riga di comando dtutil fornita con l'installazione di SQL Server/SSIS per distribuire più pacchetti in batch. È associato a una versione SSIS specifica, quindi se viene usata per distribuire pacchetti con versione inferiore senza cambiare il livello di protezione, le copieranno semplicemente mantenendo la versione SSIS. Se lo si usa per distribuirli e cambiare il livello di protezione contemporaneamente, li aggiornerà nella versione SSIS.

Poiché Azure-SSIS IR è attualmente basato su SQL Server 2017, l'esecuzione di pacchetti con versione precedente li aggiornerà in pacchetti SSIS 2017 in fase di esecuzione. L'esecuzione di pacchetti di versioni successive non è supportata.

Di conseguenza, per evitare gli aggiornamenti in fase di esecuzione, la distribuzione di pacchetti da eseguire in Azure-SSIS IR nel modello di distribuzione pacchetti deve usare dtutil 2017 fornito con l'installazione di SQL Server/SSIS 2017. A questo scopo, è possibile scaricare e installare gratuitamente SQL Server/SSIS 2017 Developer Edition . Dopo l'installazione, è possibile trovare dtutil 2017 in questa cartella: YourLocalDrive:\Program Files\Microsoft SQL Server\140\DTS\Binn.

Distribuzione di più pacchetti dal file system locale in File di Azure con dtutil

Per distribuire più pacchetti dal file system in File di Azure e cambiare il livello di protezione contemporaneamente, è possibile eseguire i comandi seguenti al prompt dei comandi. Sostituire tutte le stringhe specifiche per il vostro caso.

REM Persist the access credentials for Azure Files on your local machine
cmdkey /ADD:YourStorageAccountName.file.core.windows.net /USER:azure\YourStorageAccountName /PASS:YourStorageAccountKey

REM Connect Azure Files to a drive on your local machine
net use Z: \\YourStorageAccountName.file.core.windows.net\YourFileShare /PERSISTENT:Yes

REM Go to a local folder where you store your packages
cd YourLocalDrive:\...\YourPackageFolder

REM Run dtutil in a loop to deploy your packages from the local folder into Azure Files while switching their protection level
for %f in (*.dtsx) do dtutil.exe /FILE %f /ENCRYPT FILE;Z:\%f;2;YourEncryptionPassword

Per eseguire i comandi precedenti in un file batch, sostituire %f con %%f.

Per distribuire più pacchetti da archivi di pacchetti SSIS legacy sopra il file system in File di Azure e cambiare il livello di protezione contemporaneamente, è possibile usare gli stessi comandi, ma sostituire YourLocalDrive:\...\YourPackageFolder con una cartella locale usata dagli archivi pacchetti SSIS legacy: YourLocalDrive:\Program Files\Microsoft SQL Server\YourSQLServerDefaultCompatibilityLevel\DTS\Packages\YourPackageFolder. Ad esempio, se l'archivio pacchetti SSIS legacy è associato a SQL Server 2016, vai a YourLocalDrive:\Program Files\Microsoft SQL Server\130\DTS\Packages\YourPackageFolder. È possibile trovare il valore per YourSQLServerDefaultCompatibilityLevel da un elenco di livelli di compatibilità predefiniti di SQL Server.

Se hai configurato gli archivi pacchetti Azure-SSIS IR su Azure Files, i tuoi pacchetti distribuiti appariranno in questi archivi quando ti connetti al runtime di integrazione di Azure-SSIS in SSMS 2019 o versioni successive.

Distribuzione di più pacchetti da MSDB in locale in MSDB in Azure con dtutil

Per distribuire più pacchetti da MSDB ospitati da SQL Server o archivi di pacchetti SSIS legacy su MSDB in MSDB ospitato da Istanza gestita di SQL di Azure e cambiare il livello di protezione contemporaneamente, è possibile connettersi a SQL Server in SSMS, fare clic con il pulsante destro del mouse sul Databases->System Databases->msdb nodo sul Esplora oggetti di SSMS per aprire una nuova query finestra ed eseguire lo script T-SQL seguente. Sostituire tutte le stringhe specifiche al tuo caso:

BEGIN
  SELECT 'dtutil /SQL '+f.foldername+'\'+NAME+' /ENCRYPT SQL;'+f.foldername+'\'+NAME+';2;YourEncryptionPassword /DestServer YourSQLManagedInstanceEndpoint /DestUser YourSQLAuthUsername /DestPassword YourSQLAuthPassword'
  FROM msdb.dbo.sysssispackages p
  inner join msdb.dbo.sysssispackagefolders f
  ON p.folderid = f.folderid
END

Per usare l'endpoint privato/pubblico dell'Istanza gestita di SQL di Azure, sostituire YourSQLManagedInstanceEndpoint rispettivamente con YourSQLMIName.YourDNSPrefix.database.windows.net/YourSQLMIName.public.YourDNSPrefix.database.windows.net,3342.

Lo script genererà le righe di comando dtutil per tutti i pacchetti in MSDB che è possibile selezionare, copiare e incollare ed eseguire al prompt dei comandi.

dtutil /SQL YourFolder\YourPackage1 /ENCRYPT SQL;YourFolder\YourPackage1;2;YourEncryptionPassword /DestServer YourSQLManagedInstanceEndpoint /DestUser YourUserName /DestPassword YourPassword
dtutil /SQL YourFolder\YourPackage2 /ENCRYPT SQL;YourFolder\YourPackage2;2;YourEncryptionPassword /DestServer YourSQLManagedInstanceEndpoint /DestUser YourUserName /DestPassword YourPassword
dtutil /SQL YourFolder\YourPackage3 /ENCRYPT SQL;YourFolder\YourPackage3;2;YourEncryptionPassword /DestServer YourSQLManagedInstanceEndpoint /DestUser YourUserName /DestPassword YourPassword

Se sono stati configurati archivi pacchetti Azure-SSIS IR in cima a MSDB, i pacchetti distribuiti verranno visualizzati quando ci si connette ad Azure-SSIS IR in SSMS 2019 o versioni successive.

Distribuzione di più pacchetti da MSDB in locale in File di Azure con dtutil

Per distribuire più pacchetti da MSDB ospitati da SQL Server o archivi di pacchetti SSIS legacy su MSDB in File di Azure e cambiare il livello di protezione contemporaneamente, è possibile connettersi a SQL Server in SSMS, fare clic con il pulsante destro del mouse sul Databases->System Databases->msdb nodo nella Esplora oggetti di SSMS per aprire una finestra Nuova query ed eseguire lo script T-SQL seguente. Si prega di sostituire tutte le stringhe specifiche del tuo caso:

BEGIN
  SELECT 'dtutil /SQL '+f.foldername+'\'+NAME+' /ENCRYPT FILE;Z:\'+f.foldername+'\'+NAME+'.dtsx;2;YourEncryptionPassword' 
  FROM msdb.dbo.sysssispackages p
  inner join msdb.dbo.sysssispackagefolders f
  ON p.folderid = f.folderid
END

Lo script genererà le righe di comando dtutil per tutti i pacchetti in MSDB che è possibile selezionare, copiare e incollare ed eseguire al prompt dei comandi.

REM Persist the access credentials for Azure Files on your local machine
cmdkey /ADD:YourStorageAccountName.file.core.windows.net /USER:azure\YourStorageAccountName /PASS:YourStorageAccountKey

REM Connect Azure Files to a drive on your local machine
net use Z: \\YourStorageAccountName.file.core.windows.net\YourFileShare /PERSISTENT:Yes

REM Multiselect, copy & paste, and run the T-SQL-generated dtutil command lines to deploy your packages from MSDB on premises into Azure Files while switching their protection level
dtutil /SQL YourFolder\YourPackage1 /ENCRYPT FILE;Z:\YourFolder\YourPackage1.dtsx;2;YourEncryptionPassword
dtutil /SQL YourFolder\YourPackage2 /ENCRYPT FILE;Z:\YourFolder\YourPackage2.dtsx;2;YourEncryptionPassword
dtutil /SQL YourFolder\YourPackage3 /ENCRYPT FILE;Z:\YourFolder\YourPackage3.dtsx;2;YourEncryptionPassword

Se hai configurato archivi di pacchetti Azure-SSIS IR su Azure Files, i pacchetti distribuiti verranno visualizzati quando ti connetti al tuo Azure-SSIS IR su SSMS 2019 o versioni successive.

Contenuto correlato

È possibile rieseguire/modificare le pipeline di Azure Data Factory generate automaticamente con le attività Esegui pacchetto SSIS o crearne di nuove nel portale di Azure Data Factory. Per maggiori informazioni, vedere Eseguire pacchetti SSIS come attività Esegui pacchetto SSIS nelle pipeline di Azure Data Factory.