Distribuzione dei pacchetti legacy (SSIS)

Si applica a: SQL Server SSIS Integration Runtime in Azure Data Factory

SQL Server Integration Services include strumenti e procedure guidate per semplificare la distribuzione di pacchetti dal computer di sviluppo al server di produzione o ad altri computer.

La procedura per la distribuzione di pacchetti prevede quattro passaggi.

1. Il primo passaggio è facoltativo e riguarda la creazione delle configurazioni dei pacchetti che aggiornano le proprietà degli elementi dei pacchetti in fase di esecuzione. Le configurazioni vengono incluse automaticamente durante la distribuzione dei pacchetti.

2. Il secondo passaggio consiste nel compilare il progetto di Integration Services per creare un'utilità di distribuzione di pacchetti. L'utilità di distribuzione per il progetto contiene i pacchetti che si desidera distribuire.

3. Il terzo passaggio consiste nel copiare nel computer di destinazione la cartella di distribuzione creata in fase di compilazione del progetto Integration Services.

4. Il quarto passaggio consiste nell'eseguire nel computer di destinazione l'Installazione guidata dei pacchetti per installare i pacchetti nel file system o in un'istanza di SQL Server.

SSIS

SQL Server Integration Services offre configurazioni di pacchetto che è possibile usare per aggiornare i valori delle proprietà in fase di esecuzione.

Una configurazione è una coppia proprietà/valore che viene aggiunta a un pacchetto completo. In genere, si crea un pacchetto, si impostano le proprietà per gli oggetti di pacchetto durante lo sviluppo del pacchetto e quindi si aggiunge la configurazione al pacchetto. Quando il pacchetto viene eseguito, ottiene i nuovi valori della proprietà dalla configurazione. Utilizzando ad esempio una configurazione, è possibile modificare la stringa di connessione di una gestione connessione o aggiornare il valore di una variabile.

Le configurazioni di pacchetto offrono i vantaggi seguenti:

• Le configurazioni semplificano lo spostamento di pacchetti dall'ambiente di sviluppo all'ambiente di produzione. Tramite una configurazione è ad esempio possibile aggiornare il percorso di un file di origine o modificare il nome di un database o di un server.

• Le configurazioni risultano utili per la distribuzione di pacchetti in più server diversi. La configurazione di ogni pacchetto distribuito può ad esempio includere una variabile che specifica un diverso valore di spazio su disco. Se lo spazio su disco disponibile non soddisfa tale valore, il pacchetto non viene eseguito.

• Le configurazioni rendono i pacchetti più flessibili. Una configurazione, ad esempio, può aggiornare il valore di una variabile utilizzata in un'espressione di proprietà.

Integration Services supporta diversi metodi di archiviazione delle configurazioni di pacchetto, ad esempio file XML, tabelle di un database di SQL Server e variabili di ambiente e di pacchetto.

Ogni configurazione corrisponde a una coppia proprietà/valore. Il file di configurazione XML e i tipi di configurazione di SQL Server possono includere più configurazioni.

Le configurazioni vengono incluse quando si crea un'utilità di distribuzione per l'installazione di pacchetti. Quando si installano i pacchetti, le configurazioni possono venire aggiornate in un passaggio dell'installazione.

Informazioni sull'applicazione delle configurazioni dei pacchetti in fase di esecuzione

Quando si usa l'utilità del prompt dei comandi dtexec (dtexec.exe) per eseguire un pacchetto distribuito, le configurazioni di pacchetto vengono applicate due volte, ovvero prima e dopo l'applicazione delle opzioni specificate nella riga di comando.

Durante il caricamento e l'esecuzione del pacchetto da parte dell'utilità, gli eventi si verificano nel seguente ordine:

1. Il pacchetto viene caricato con l'utilità dtexec .

2. L'utilità consente di applicare le configurazioni specificate nel pacchetto in fase di progettazione, nell'ordine indicato nel pacchetto. L'unica eccezione è rappresentata dalle configurazioni delle variabili del pacchetto padre. L'utilità applica queste configurazioni una sola volta e successivamente nel processo.

3. L'utilità applica quindi le opzioni specificate nella riga di comando.

4. A questo punto l'utilità ricarica le configurazioni specificate nel pacchetto in fase di progettazione, nell'ordine indicato nel pacchetto. L'unica eccezione a questa regola è di nuovo rappresentata dalle configurazioni Variabile pacchetto padre. L'utilità utilizza quindi le opzioni della riga di comando specificate per ricaricare le configurazioni. È pertanto possibile che vengano ricaricati valori diversi da posizioni differenti.

5. L'utilità consente di applicare le configurazioni Variabile pacchetto padre.

6. L'utilità consente l'esecuzione del pacchetto.

Il modo in cui l'utilità dtexec applica le configurazioni influisce sulle seguenti opzioni della riga di comando:

• È possibile usare l'opzione /Connection o /Set in fase di esecuzione per caricare le configurazioni di pacchetto da una posizione diversa da quella specificata in fase di progettazione.

• È possibile usare l'opzione /ConfigFile per caricare configurazioni aggiuntive non specificate in fase di progettazione.

Tali opzioni della riga di comando presentano tuttavia alcune restrizioni.

• Non è possibile usare l'opzione /Set o /Connection per eseguire l'override di valori singoli impostati anch'essi durante una configurazione.

• Non è possibile usare l'opzione /ConfigFile per caricare configurazioni che sostituiscono quelle specificate in fase di progettazione.

Per altre informazioni su queste opzioni e sulla differenza di comportamento di tali opzioni tra SQL Server 2019 Integration Services e le versioni precedenti, vedere Modifiche funzionali delle funzionalità di Integration Services in SQL Server 2016.

Tipi di configurazioni di pacchetto

Nella tabella seguente vengono descritti i tipi di configurazione di pacchetto.

Tipo	Descrizione
File di configurazione XML	Le configurazioni sono incluse in un file XML. Il file può includere più configurazioni.
Variabile di ambiente	La configurazione è contenuta in una variabile di ambiente.
Voce del Registro di sistema	La configurazione è inclusa in una voce del Registro di sistema.
Variabile pacchetto padre	La configurazione è contenuta in una variabile del pacchetto. Questo tipo di configurazione viene in genere utilizzato per l'aggiornamento di proprietà in pacchetti figlio.
Tabella di SQL Server	La configurazione è inclusa in una tabella di un database di SQL Server. La tabella può includere più configurazioni.

File di configurazione XML

Se si seleziona il tipo di configurazione File di configurazione XML è possibile creare un nuovo file di configurazione, riusare un file esistente e aggiungere nuove configurazioni oppure riusare un file esistente sovrascrivendone il contenuto.

Un file di configurazione XML è suddiviso in due sezioni:

• Un'intestazione contenente informazioni sul file. Questa sezione include attributi quali la data di creazione del file e il nome dell'utente che ha generato il file.

• Elementi di configurazione contenenti informazioni su ogni configurazione. Questa sezione include attributi quali il percorso e il valore configurato di una proprietà.

Nel codice XML seguente viene illustrata la sintassi di un file di configurazione XML. Nell'esempio viene illustrata una configurazione per la proprietà Value di una variabile di tipo Integer denominata MyVar.

\<?xml version="1.0"?>  
<DTSConfiguration>  
   <DTSConfigurationHeading>  
      <DTSConfigurationFileInfo  
          GeneratedBy="DomainName\UserName"  
          GeneratedFromPackageName="Package"  
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"  
          GeneratedDate="2/01/2005 5:58:09 PM"/>  
   </DTSConfigurationHeading>  
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">  
      <ConfiguredValue>0</ConfiguredValue>  
   </Configuration>  
</DTSConfiguration>  
  

Voce del Registro di sistema

Se si desidera usare una voce del Registro di sistema per archiviare la configurazione, è possibile usare una chiave esistente oppure crearne una nuova in HKEY_CURRENT_USER. Nella chiave del Registro di sistema usata deve essere disponibile un valore denominato Value. Il valore può essere un DWORD o una stringa.

Se si seleziona il tipo di configurazione Voce del Registro di sistema, è necessario digitare il nome della chiave del Registro di sistema nella casella Voce del Registro di sistema. Il formato è <chiave del Registro di sistema>. Se si vuole usare una chiave del Registro di sistema che non si trova nella radice di HKEY_CURRENT_USER, per identificare la chiave usare il formato <Chiave del Registro di sistema\chiave del Registro di sistema...>. Per usare la chiave MyPackage in SSISPackages, ad esempio, digitare SSISPackages\MyPackage.

SQL Server

Se si seleziona il tipo di configurazione SQL Server, è necessario specificare la connessione al database di SQL Server in cui si desidera archiviare le configurazioni. È possibile salvare le configurazioni in una tabella esistente oppure creare una nuova tabella nel database specificato.

L'istruzione SQL seguente illustra l'istruzione CREATE TABLE predefinita della Configurazione guidata pacchetto.

CREATE TABLE [dbo].[SSIS Configurations]  
(  
ConfigurationFilter NVARCHAR(255) NOT NULL,  
ConfiguredValue NVARCHAR(255) NULL,  
PackagePath NVARCHAR(255) NOT NULL,  
ConfiguredValueType NVARCHAR(20) NOT NULL  
)  
  

Il nome specificato per la configurazione corrisponde al valore archiviato nella colonna ConfigurationFilter .

Configurazioni dirette e indirette

Integration Services offre configurazioni dirette e indirette. Se le configurazioni vengono specificate in modo diretto, Integration Services crea un collegamento diretto tra l'elemento di configurazione e la proprietà dell'oggetto di pacchetto. È consigliabile usare le configurazioni dirette quando la posizione dell'origine non cambia. Ad esempio, se per tutte le distribuzioni di pacchetto viene utilizzato sempre lo stesso percorso di file, è possibile specificare un file di configurazione XML.

Nelle configurazioni indirette vengono utilizzate variabili di ambiente. Anziché specificare l'impostazione di configurazione in modo diretto, la configurazione punta a una variabile di ambiente, la quale contiene il valore di configurazione. È consigliabile utilizzare le configurazioni indirette quando la posizione della configurazione può essere diversa nelle varie distribuzioni di un pacchetto.

Creazione di configurazioni dei pacchetti

Le configurazioni di pacchetto vengono create nella finestra di dialogo Libreria configurazioni pacchetto e con la Configurazione guidata pacchetto. Per accedere a questi strumenti, selezionare Configurazioni pacchetto nel menu SSIS in SQL Server Data Tools (SSDT).

Nella finestra di dialogo Libreria configurazioni pacchetto è possibile avviare la Configurazione guidata pacchetto tramite cui è possibile eseguire i vari passaggi necessari per la creazione di una configurazione. Per eseguire la Configurazione guidata pacchetto, aggiungere una nuova configurazione o modificarne una esistente nella finestra di dialogo Libreria configurazioni pacchetto . Nei passaggi della procedura guidata viene specificato il tipo di configurazione, viene impostato l'accesso alla configurazione in modo diretto o tramite variabili di ambiente e vengono selezionate le proprietà da salvare nella configurazione.

Nell'esempio seguente vengono illustrate le proprietà di destinazione di una variabile e di un pacchetto nel modo in cui vengono visualizzate nella pagina di completamento della procedura guidata della Configurazione guidata pacchetto:

\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName].Properties[Value]

In questo esempio, tramite la configurazione vengono aggiornate le proprietà seguenti:

• Proprietà RaiseChangedEvent della variabile definita dall'utente TodaysDate.

• Proprietà MaximumErrorCount, LoggingMode e LocaleID del pacchetto.

• Proprietà Value della variabile definita dall'utente varTableNamenell'ambito dell'attività My SQL Task.

"\Package" rappresenta la radice, mentre gli oggetti che definiscono il percorso della proprietà aggiornata dalla configurazione sono separati da punti (.). I nomi di variabili e proprietà sono racchiusi tra parentesi quadre. Il termine Package è sempre utilizzato nella configurazione, indipendentemente dal nome del pacchetto. Per tutti gli altri oggetti inclusi nel percorso vengono tuttavia utilizzati i relativi nomi definiti dall'utente.

Al completamento della procedura guidata la nuova configurazione viene aggiunta all'elenco delle configurazioni nella finestra di dialogo Libreria configurazioni pacchetto .

Nella tabella seguente vengono descritte le colonne dell'elenco delle configurazioni visualizzato nella finestra di dialogo Libreria configurazioni pacchetto .

Colonna	Descrizione
Nome configurazione	Nome della configurazione.
Tipo configurazione	Tipo di configurazione.
Stringa di configurazione	Posizione della configurazione. La posizione può corrispondere a un percorso, a una variabile di ambiente, a una chiave del Registro di sistema, a un nome di variabile del pacchetto padre oppure a una tabella in un database di SQL Server.
Oggetto di destinazione	Nome dell'oggetto a cui è associata una proprietà con configurazione. Se la configurazione è un file di configurazione XML, la colonna è vuota in quanto questo tipo di configurazione può aggiornare più oggetti.
Proprietà di destinazione	Nome della proprietà. Se tramite la configurazione si scrive in un file di configurazione XML o in una tabella di SQL Server, la colonna risulta vuota perché la configurazione può aggiornare più oggetti.

Per creare una configurazione di pacchetto

1. In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.

2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.

3. In Progettazione SSIS selezionare la scheda Flusso di controllo, Flusso di dati, Gestore eventi o Esplora pacchetti.

4. Selezionare Configurazioni di pacchetto dal menu SSIS.

5. Nella finestra di dialogo Package Configuration Organizer selezionare Abilita configurazioni pacchetto e quindi selezionare Aggiungi.

6. Nella pagina iniziale della Configurazione guidata pacchetto selezionare Avanti.

7. Nel passaggio Selezione tipo di configurazione specificare il tipo di configurazione e impostare quindi le proprietà rilevanti per il tipo di configurazione specificato. Per altre informazioni, vedere Riferimento all'interfaccia utente della Configurazione guidata pacchetti.

8. Nel passaggio Selezione proprietà da esportare selezionare le proprietà degli oggetti di pacchetto da includere nella configurazione. Se il tipo di configurazione selezionato supporta una sola proprietà, il titolo di questo passaggio della procedura guidata sarà Selezione proprietà di destinazione. Per altre informazioni, vedere Riferimento all'interfaccia utente della Configurazione guidata pacchetti.

   Nota

   Gli unici tipi di configurazione che supportano l'inserimento di più proprietà sono File di configurazione XML e SQL Server.

9. Nella pagina di completamento della procedura guidata digitare il nome della configurazione, quindi selezionare Fine.

10. La configurazione sarà visibile nella finestra di dialogo Libreria configurazioni pacchetto .

11. Selezionare Chiudi.

Libreria configurazioni pacchetto

Usare la finestra di dialogo Libreria configurazioni pacchetto per abilitare le configurazioni dei pacchetti, visualizzarne un elenco per il pacchetto corrente e specificare l'ordine desiderato in base a cui devono essere caricate.

Se più configurazioni aggiornano la stessa proprietà, i valori delle configurazioni che si trovano nella parte inferiore dell'elenco sostituiscono quelli delle configurazioni nelle posizioni superiori nell'elenco. L'ultimo valore caricato nella proprietà è quello utilizzato all'esecuzione del pacchetto. Se il pacchetto utilizza una combinazione di configurazione diretta, ad esempio un file di configurazione XML, e indiretta, ad esempio una variabile di ambiente, la configurazione indiretta che punta al percorso della configurazione diretta deve trovarsi in una posizione superiore nell'elenco.

Le configurazioni di pacchetto aggiornano i valori delle proprietà degli oggetti pacchetto in fase di esecuzione. Quando viene caricato un pacchetto, i valori delle configurazioni sostituiscono quelli impostati durante lo sviluppo del pacchetto. Integration Services supporta diversi tipi di configurazione. È possibile, ad esempio, utilizzare un file XML che contiene più configurazioni o una variabile di ambiente che ne contiene una sola. Per altre informazioni, vedere Configurazioni di pacchetto.

Opzioni

Abilita configurazioni pacchetto
Selezionare questa opzione per utilizzare le configurazioni con il pacchetto.

Nome configurazione
Consente di visualizzare il nome della configurazione.

Tipo configurazione
Consente di visualizzare il tipo di percorso in cui sono archiviate le configurazioni.

Stringa di configurazione
Consente di visualizzare il percorso in cui sono archiviati i valori della configurazione, che può essere il percorso di un file, il nome di una variabile di ambiente, il nome di una variabile del pacchetto padre, una chiave del Registro di sistema o il nome di una tabella di SQL Server.

Oggetto di destinazione
Consente di visualizzare il nome dell'oggetto aggiornato dalla configurazione. Se la configurazione è un file di configurazione XML o una tabella di SQL Server, la colonna sarà vuota perché questo tipo di configurazione può includere più oggetti.

Proprietà di destinazione
Consente di visualizzare il nome della proprietà modificata dalla configurazione. Se il tipo di configurazione supporta più configurazioni, questa colonna sarà vuota.

Aggiunta
Consente di aggiungere una configurazione tramite la Configurazione guidata pacchetto.

Modifica
Consente di modificare una configurazione esistente rieseguendo la Configurazione guidata pacchetto.

Rimuovi
Selezionare una configurazione e quindi Rimuovi.

Frecce
Selezionare una configurazione e utilizzare le frecce in su o in giù per spostarla verso l'alto o il basso nell'elenco. Le configurazioni vengono caricate nella sequenza in base a cui sono ordinate nell'elenco.

Riferimento all'interfaccia utente della Configurazione guidata pacchetti

Usare la Configurazione guidata pacchetto per creare configurazioni tramite cui è possibile aggiornare le proprietà di un pacchetto di Integration Services e i relativi oggetti in fase di esecuzione. Questa procedura guidata viene eseguita quando si aggiunge una nuova configurazione o se ne modifica una esistente nella finestra di dialogo Libreria configurazioni pacchetto . Per aprire la finestra di dialogo Libreria configurazioni pacchetto, selezionare Configurazioni pacchetto nel menu SSIS in SQL Server Data Tools (SSDT). Per altre informazioni, vedere Creazione di configurazioni dei pacchetti.

Nelle sezioni seguenti vengono descritte le pagine della procedura guidata.

Pagina della Configurazione guidata pacchetto

Usare la Configurazione guidata SSIS per creare configurazioni in grado di aggiornare le proprietà di un pacchetto e i relativi oggetti in fase di esecuzione.

Opzioni

Non visualizzare più questa pagina
Consente di evitare la visualizzazione della pagina di benvenuto alla successiva apertura della procedura guidata.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Pagina Selezione tipo di configurazione

Usare la pagina Selezione tipo di configurazione per specificare il tipo di configurazione da creare.

Per altre informazioni sulla selezione del tipo di configurazione da usare, vedere Configurazioni di pacchetto.

Opzioni statiche

Tipo configurazione
Selezionare una delle opzioni seguenti per impostare il tipo di origine in cui archiviare la configurazione:

Valore	Descrizione
File di configurazione XML	Consente di archiviare la configurazione come file in formato XML. Tramite la selezione di questo valore le opzioni dinamiche vengono visualizzate nella sezione Tipo configurazione.
Variabile di ambiente	Consente di archiviare la configurazione in una delle variabili di ambiente. Tramite la selezione di questo valore le opzioni dinamiche vengono visualizzate nella sezione Tipo configurazione.
Voce del Registro di sistema	Consente di archiviare la configurazione nel Registro di sistema. Tramite la selezione di questo valore le opzioni dinamiche vengono visualizzate nella sezione Tipo configurazione.
Variabile pacchetto padre	Consente di archiviare la configurazione come variabile nel pacchetto contenente l'attività. Tramite la selezione di questo valore le opzioni dinamiche vengono visualizzate nella sezione Tipo configurazione.
SQL Server	Consente di archiviare la configurazione in una tabella in SQL Server. Tramite la selezione di questo valore le opzioni dinamiche vengono visualizzate nella sezione Tipo configurazione.

Avanti
Consente di visualizzare la pagina successiva della procedura guidata.

Opzioni dinamiche

Opzione tipo di configurazione = File di configurazione XML

Usa le impostazioni di configurazione specificate di seguito
Consente di specificare le impostazioni da utilizzare.

Valore	Descrizione
Nome file di configurazione	Consente di digitare il percorso del file di configurazione generato dalla procedura guidata.
Sfoglia	Usare la finestra di dialogo Selezionare il percorso del file di configurazione per impostare il percorso del file di configurazione generato dalla procedura guidata. Se il file non esiste, viene creato durante la procedura guidata.

Percorso della configurazione memorizzato in una variabile di ambiente
Consente di specificare la variabile di ambiente in cui memorizzare la configurazione.

Valore	Descrizione
Variabile di ambiente	Consente di selezionare una variabile di ambiente nell'elenco.

Opzione tipo di configurazione = Variabile di ambiente

Variabile di ambiente
Consente di selezionare la variabile di ambiente contenente le informazioni di configurazione.

Opzione tipo di configurazione = Voce del Registro di sistema

Usa le impostazioni di configurazione specificate di seguito
Consente di specificare le impostazioni da utilizzare.

Valore

Descrizione

Voce del Registro di sistema

Digitare la chiave del Registro di sistema contenente le informazioni di configurazione Il formato è <chiave del Registro di sistema>. È necessario che la chiave del Registro di sistema esista già in HKEY_CURRENT_USER e che il suo valore sia Value. Il valore può essere un DWORD o una stringa. Se si vuole usare una chiave del Registro di sistema che non si trova nella radice di HKEY_CURRENT_USER, per identificare la chiave usare il formato <Chiave del Registro di sistema\chiave del Registro di sistema...>.

Percorso della configurazione memorizzato in una variabile di ambiente
Consente di specificare la variabile di ambiente in cui memorizzare la configurazione.

Valore	Descrizione
Variabile di ambiente	Consente di selezionare una variabile di ambiente nell'elenco.

Opzione tipo di configurazione = Variabile pacchetto padre

Usa le impostazioni di configurazione specificate di seguito
Consente di specificare le impostazioni da utilizzare.

Valore	Descrizione
Variabile padre	Consente di specificare la variabile inclusa nel pacchetto padre contenente le informazioni di configurazione.

Percorso della configurazione memorizzato in una variabile di ambiente
Consente di specificare la variabile di ambiente in cui viene memorizzata la configurazione.

Valore	Descrizione
Variabile di ambiente	Consente di selezionare una variabile di ambiente nell'elenco.

Opzione tipo di configurazione = SQL Server

Usa le impostazioni di configurazione specificate di seguito
Consente di specificare le impostazioni da utilizzare.

Valore	Descrizione
Connessione	Consente di selezionare una connessione nell'elenco o di crearne una nuova selezionando Nuova.
Tabella configurazione	Consente di selezionare una tabella esistente o di crearne una nuova selezionando Nuova per scrivere un'istruzione di SQL.
Filtro configurazione	Consente di selezionare un nome esistente o di digitarne uno nuovo per la configurazione. È possibile memorizzare nella stessa tabella molteplici configurazioni di SQL Server, ciascuna delle quali può includere più elementi di configurazione. Questo valore definito dall'utente è memorizzato nella tabella per identificare gli elementi della configurazione appartenenti a una configurazione specifica.

Percorso della configurazione memorizzato in una variabile di ambiente
Consente di specificare la variabile di ambiente in cui è memorizzata la configurazione.

Valore	Descrizione
Variabile di ambiente	Consente di selezionare una variabile di ambiente nell'elenco.

Pagina Selezione oggetti da esportare

Usare la pagina Selezione proprietà di destinazione o Selezione proprietà da esportare per specificare le proprietà degli oggetti incluse nella configurazione. La possibilità di selezionare più impostazioni è disponibile solo se si seleziona il tipo di configurazione XML.

Opzioni

Oggetti
Consente di espandere la gerarchia del pacchetto e di selezionare le proprietà da esportare.

Attributi proprietà
Consente di visualizzare gli attributi di una proprietà.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Pagina Completamento procedura guidata

La pagina Completamento procedura guidata consente di assegnare un nome per le impostazioni di configurazione e visualizzazione usate dalla procedura guidata per creare la configurazione. Dopo il completamento della procedura guidata, verrà visualizzato Libreria configurazioni pacchetto in cui sono elencate tutte le configurazioni per il pacchetto.

Opzioni

Nome configurazione
Consente di digitare il nome della configurazione.

Anteprima
Consente di visualizzare le impostazioni utilizzate dalla procedura guidata per creare la configurazione.

Fine
Consente di creare la configurazione e uscire dalla Configurazione guidata pacchetto.

Usare i valori di variabili e parametri in un pacchetto figlio

In questa procedura viene descritto come creare una configurazione di pacchetto in cui viene utilizzato il tipo di configurazione variabile padre. Questo tipo di configurazione consente a un pacchetto figlio eseguito da un pacchetto padre di accedere a una variabile del pacchetto padre.

Non è necessario creare la variabile nel pacchetto padre prima di creare la configurazione di pacchetto nel pacchetto figlio. La variabile può essere aggiunta al pacchetto padre in qualsiasi momento, ma nella configurazione di pacchetto è necessario utilizzare il nome esatto della variabile padre. Affinché sia possibile creare una configurazione che utilizza la variabile padre, tuttavia, nel pacchetto figlio deve essere presente una variabile che possa essere aggiornata dalla configurazione. Per altre informazioni sull'aggiunta e la configurazione di variabili, vedere Aggiungere, eliminare o modificare l'ambito di una variabile definita dall'utente in un pacchetto.

Come ambito per la variabile del pacchetto padre utilizzata nella configurazione di tipo Variabile pacchetto padre è possibile impostare l'attività Esegui pacchetto, il contenitore che include l'attività o il pacchetto. Se in uno stesso pacchetto sono definite più variabili con lo stesso nome, verrà utilizzata quella con ambito più vicino all'attività Esegui pacchetto. L'ambito più vicino all'attività Esegui pacchetto è l'attività stessa.

Per aggiungere una variabile a un pacchetto padre

1. In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services contenente il pacchetto a cui si desidera aggiungere una variabile da passare a un pacchetto figlio.

2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.

3. In Progettazione SSIS eseguire una delle operazioni seguenti per definire l'ambito della variabile:

   • Per impostare il pacchetto come ambito, selezionare in un punto qualsiasi dell'area di progettazione della scheda Flusso di controllo.

   • Per impostare come ambito un contenitore padre dell'attività Esegui pacchetto, selezionare il contenitore.

   • Per impostare l'attività Esegui pacchetto come ambito, selezionare l'attività.

4. Aggiungere e configurare una variabile.

   Nota

   Selezionare un tipo di dati compatibile con i dati che verranno memorizzati nella variabile.

5. Per salvare il pacchetto aggiornato, selezionare Salva elementi selezionati nel menu File.

Per aggiungere una variabile a un pacchetto figlio

1. In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services contenente il pacchetto a cui si desidera aggiungere una configurazione della variabile padre.

2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.

3. In Progettazione SSIS per impostare il pacchetto come ambito, selezionare in un punto qualsiasi dell'area di progettazione della scheda Flusso di controllo.

4. Aggiungere e configurare una variabile.

   Nota

   Selezionare un tipo di dati compatibile con i dati che verranno memorizzati nella variabile.

5. Per salvare il pacchetto aggiornato, selezionare Salva elementi selezionati nel menu File.

Creazione di un'utilità di distribuzione

Il primo passaggio della distribuzione di pacchetti consiste nel creare un'utilità di distribuzione per un progetto di Integration Services. L'utilità di distribuzione è una cartella contenente i file necessari per la distribuzione dei pacchetti di un progetto di Integration Services in un altro server. L'utilità di distribuzione viene creata nel computer in cui è archiviato il progetto di Integration Services.

Per creare l'utilità di distribuzione di pacchetti per un progetto di Integration Services, è innanzitutto necessario configurare il processo di compilazione dell'utilità e quindi compilare il progetto. Quando si compila il progetto, tutti i pacchetti e le configurazioni di pacchetto del progetto vengono inclusi automaticamente. Per distribuire file aggiuntivi, ad esempio un file leggimi per il progetto, inserirli nella cartella Varie del progetto di Integration Services. Quando si compila il progetto, vengono inclusi automaticamente anche questi file.

È possibile configurare ogni utilità di distribuzione di progetto in modo diverso. Prima di compilare il progetto e creare l'utilità di distribuzione dei pacchetti, è possibile impostare le proprietà dell'utilità in modo da personalizzare la modalità di distribuzione dei pacchetti. È possibile, ad esempio, specificare se le configurazioni di pacchetto possono essere aggiornate in fase di distribuzione del progetto. Per accedere alle proprietà di un progetto di Integration Services, fare clic con il pulsante destro del mouse sul progetto e selezionare Proprietà.

Nella tabella seguente vengono descritte le proprietà dell'utilità di distribuzione.

Proprietà	Descrizione
AllowConfigurationChange	Valore che specifica se le configurazioni possono essere aggiornate durante la distribuzione.
CreateDeploymentUtility	Valore che specifica se in fase di compilazione del progetto viene creata un'utilità di distribuzione di pacchetti. Per creare un'utilità di distribuzione, la proprietà deve essere impostata su True .
DeploymentOutputPath	Posizione relativa al progetto di Integration Services dell'utilità di distribuzione.

Quando si compila un progetto di Integration Services, viene creato un file manifesto, <nome progetto>.SSISDeploymentManifest.xml, il quale viene aggiunto insieme a copie dei pacchetti di progetto e delle dipendenze di pacchetto nella cartella bin\Deployment del progetto o nel percorso specificato nella proprietà DeploymentOutputPath. Nel file manifesto sono elencati i pacchetti, le configurazioni di pacchetto ed eventuali altri file del progetto.

Il contenuto della cartella di distribuzione viene aggiornato ogni volta che si compila il progetto. Ciò significa che tutti i file salvati in tale cartella che non vengono nuovamente copiati nella cartella dal processo di compilazione verranno eliminati. Ad esempio, i file di configurazione del pacchetto salvati nelle cartelle di distribuzione verranno eliminati.

Per creare un'utilità di distribuzione di pacchetti

1. In SQL Server Data Tools (SSDT) aprire la soluzione contenente il progetto di Integration Services per il quale si desidera creare un'utilità di distribuzione pacchetti.

2. Fare clic con il pulsante destro del mouse sul progetto e selezionare Proprietà.

3. Nella finestra di dialogo Pagine delle proprietà di <nome progetto> selezionare Utilità di distribuzione.

4. Per aggiornare le configurazioni di pacchetto in fase di distribuzione del pacchetto, impostare AllowConfigurationChanges su True.

5. Impostare CreateDeploymentUtility su True.

6. Facoltativamente, aggiornare la posizione dell'utilità di distribuzione modificando la proprietà DeploymentOutputPath .

7. Seleziona OK.

8. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, quindi selezionare Crea.

9. Nella finestra Output vengono visualizzati lo stato del processo di compilazione e gli eventuali errori di compilazione.

Distribuzione di pacchetti con l'utilità di distribuzione

Se è stata compilata un'utilità di distribuzione per l'installazione di pacchetti di un progetto di Integration Services in un computer diverso da quello in cui l'utilità è stata compilata, è prima necessario copiare la cartella di distribuzione nel computer di destinazione.

Il percorso di tale cartella è specificato nella proprietà DeploymentOutputPath del progetto di Integration Services per il quale è stata creata l'utilità di distribuzione. Il percorso predefinito è bin\Deployment, relativo al progetto di Integration Services. Per altre informazioni, vedere Creazione di un'utilità di distribuzione.

Per installare i pacchetti è possibile utilizzare Installazione guidata pacchetti, che può essere avviata facendo doppio clic sul file dell'utilità di distribuzione, dopo aver copiato la cartella di distribuzione sul server. Il file si chiama <nome progetto>.SSISDeploymentManifest e si trova nella cartella di distribuzione del computer di destinazione.

L'Installazione guidata pacchetti consente di eseguire in modo semplificato i passaggi necessari per l'installazione di pacchetti nel file system o in SQL Server. È possibile configurare l'installazione nei modi seguenti:

• Specificando il tipo di posizione e la posizione per l'installazione dei pacchetti.

• Specificando la posizione per l'installazione delle dipendenze dei pacchetti.

• Convalidando i pacchetti dopo averli installati nel server di destinazione.

Le dipendenze basate su file per i pacchetti vengono sempre installate nel file system. Se si installa un pacchetto nel file system, le dipendenze vengono installate nella stessa cartella specificata per il pacchetto. Se si installa un pacchetto in SQL Server, è possibile specificare la cartella in cui archiviare le dipendenze basate su file.

Se il pacchetto include configurazioni che si desidera modificare per l'utilizzo nel computer di destinazione, è possibile aggiornare i valori delle proprietà tramite la procedura guidata.

Oltre a installare pacchetti eseguendo l'Installazione guidata pacchetti, è possibile copiare e spostare pacchetti tramite l'utilità del prompt dei comandi dtutil . Per altre informazioni, vedere dtutil Utility.

Per distribuire pacchetti in un'istanza di SQL Server

1. Aprire la cartella di distribuzione del computer di destinazione.

2. Fare doppio clic sul file manifesto <nome progetto>.SSISDeploymentManifest per avviare l'Installazione guidata pacchetti.

3. Nella pagina Distribuzione pacchetti SSIS selezionare l'opzione Distribuzione di SQL Server .

4. Facoltativamente, selezionare Convalida pacchetti dopo l'installazione per convalidare i pacchetti dopo che sono stati installati nel server di destinazione.

5. Nella pagina Impostazione istanza di SQL Server di destinazione specificare l'istanza di SQL Server in cui installare i pacchetti e selezionare una modalità di autenticazione. Se si seleziona l'autenticazione di SQL Server, è necessario specificare un nome utente e una password.

6. Nella pagina Selezione cartella di installazione specificare la cartella del file system in cui installare i pacchetti e le relative dipendenze.

7. Se il pacchetto include configurazioni, è possibile modificarle aggiornando i valori dell'elenco Valore nella pagina Configurazione pacchetti.

8. Se è stata impostata la convalida dei pacchetti dopo l'installazione, esaminare i risultati della convalida dei pacchetti distribuiti.

Ridistribuzione di pacchetti

Dopo la distribuzione di un progetto, potrebbe essere necessario aggiornare o estendere la funzionalità dei pacchetti e ridistribuire quindi il progetto di Integration Services contenente i pacchetti aggiornati. Durante il processo di ridistribuzione di pacchetti, è consigliabile analizzare le proprietà di configurazione incluse nell'utilità di distribuzione. Potrebbe ad esempio essere utile non consentire alcuna modifica di configurazione dopo la ridistribuzione del pacchetto.

Ridistribuzione

Dopo avere completato l'aggiornamento di pacchetti, è necessario ricompilare il progetto, copiare la cartella di distribuzione nel computer di destinazione e rieseguire l'Installazione guidata pacchetti.

Se si aggiornano solo alcuni pacchetti di un progetto, potrebbe risultare utile ridistribuire solo i pacchetti aggiornati anziché l'intero progetto. Per distribuire solo alcuni pacchetti, è possibile creare un nuovo progetto di Integration Services, aggiungervi i pacchetti aggiornati e quindi compilare e distribuire il progetto. Quando il pacchetto viene aggiunto a un altro progetto, le configurazioni di pacchetto vengono copiate automaticamente insieme al pacchetto.

Riferimento all'interfaccia utente dell'Installazione guidata pacchetti

Usare l'Installazione guidata pacchetti per distribuire un progetto di Integration Services, inclusi i pacchetti, i file Varie contenuti ed eventuali dipendenze dei pacchetti.

Prima di distribuire i pacchetti, è possibile creare configurazioni e distribuirle con i pacchetti. Integration Services usa le configurazioni per aggiornare in modo dinamico le proprietà di pacchetti e relativi oggetti in fase di esecuzione. La stringa di connessione di una connessione OLE DB può essere ad esempio impostata dinamicamente in fase di esecuzione, specificando una configurazione che esegue il mapping di un valore alla proprietà contenente la stringa di connessione.

Non è possibile eseguire l'Installazione guidata pacchetti finché non si compila un progetto di Integration Services e non si crea un'utilità di distribuzione. Per altre informazioni, vedere Distribuzione di pacchetti con l'utilità di distribuzione.

Nelle sezioni seguenti vengono descritte le pagine della procedura guidata.

Pagina dell'Installazione guidata pacchetti

Usare l'Installazione guidata pacchetti per distribuire un progetto di Integration Services per cui è stata compilata un'utilità di distribuzione pacchetti.

Non visualizzare più questa pagina iniziale
Selezionare questa opzione per ignorare la pagina iniziale quando si esegue nuovamente la procedura guidata.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Fine
Consente di passare alla pagina Completamento Installazione guidata pacchetti. Usare questa opzione se sono state controllate le scelte effettuate nelle pagine precedenti della procedura guidata e sono state specificate tutte le opzioni necessarie.

Pagina Configurazione pacchetti

La pagina Configurazione pacchetti consente di modificare le configurazioni dei pacchetti.

Opzioni

File di configurazione
Consente di modificare il contenuto di un file di configurazione selezionando il file dall'elenco.

Argomenti correlati: Creare configurazioni di pacchetti

Percorso
Indica il percorso della proprietà da configurare.

Type
Indica il tipo di dati della proprietà.

valore
Consente di specificare il valore della configurazione.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Fine
Consente di passare alla pagina Completamento Installazione guidata pacchetti. Usare questa opzione se sono state controllate le scelte effettuate nelle pagine precedenti della procedura guidata e sono state specificate tutte le opzioni necessarie.

Pagina Conferma installazione

La pagina Conferma installazione consente di avviare l'installazione dei pacchetti, visualizzare lo stato e visualizzare informazioni che verranno usate dalla procedura guidata per l'installazione dei file dal progetto specificato.

Avanti
Consente di installare i pacchetti e le relative dipendenze, quindi di passare alla pagina successiva della procedura al termine dell'installazione.

Stato
Mostra lo stato dell'installazione del pacchetto.

Fine
Consente di passare alla pagina Completamento Installazione guidata pacchetti. Usare questa opzione se sono state controllate le scelte effettuate nelle pagine precedenti della procedura guidata e sono state specificate tutte le opzioni necessarie.

Pagina Distribuzione pacchetti SSIS

Usare la pagina Distribuzione pacchetti SSIS per specificare il percorso d'installazione dei pacchetti di Integration Services e delle relative dipendenze.

Opzioni

Distribuzione nel file system
Consente di distribuire i pacchetti e le dipendenze in una cartella specificata del file system.

Distribuzione in SQL Server
Consente di distribuire i pacchetti e le dipendenze in un'istanza di SQL Server. Usare questa opzione se SQL Server condivide i pacchetti tra i server. Le eventuali dipendenze dei pacchetti vengono installate nella cartella specificata del file system.

Convalida pacchetti dopo l'installazione
Consente di specificare se convalidare i pacchetti dopo l'installazione.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Fine
Consente di passare alla pagina Completamento Installazione guidata pacchetti. Usare questa opzione se sono state controllate le scelte effettuate nelle pagine precedenti della procedura guidata e sono state specificate tutte le opzioni necessarie.

Pagina Convalida pacchetti

Usare la pagina Convalida pacchetti per visualizzare lo stato e i risultati della convalida dei pacchetti.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Pagina Selezione cartella di destinazione

Usare la pagina Selezione cartella di installazione per specificare la cartella del file system in cui installare i pacchetti e le relative dipendenze.

Opzioni

Cartella
Consente di specificare il percorso e la cartella in cui copiare il pacchetto e le relative dipendenze.

Sfoglia
Consente di selezionare la cartella di destinazione utilizzando la finestra di dialogo Sfoglia cartella .

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Fine
Consente di passare alla pagina Completamento Installazione guidata pacchetti. Usare questa opzione se sono state controllate le scelte effettuate nelle pagine precedenti della procedura guidata e sono state specificate tutte le opzioni necessarie.

Pagina Impostazione istanza di SQL Server di destinazione

Usare la pagina Impostazione istanza di SQL Server di destinazione per specificare le opzioni per la distribuzione del pacchetto in un'istanza di SQL Server.

Opzioni

Nome server
Consente di specificare il nome del server in cui distribuire i pacchetti.

Usa autenticazione di Windows
Consente di specificare se usare l'autenticazione di Windows per l'accesso al server. Per una maggiore sicurezza è consigliabile utilizzare l'autenticazione di Windows.

Usa autenticazione di SQL Server
Consente di specificare se il pacchetto deve usare l'autenticazione di SQL Server per l'accesso al server. Se si usa l'autenticazione di SQL Server, è necessario specificare un nome utente e una password.

Nome utente
Consente di specificare un nome utente.

Password
Consente di specificare una password.

Percorso pacchetto
Consente di specificare il nome della cartella logica o immettere "/" per la cartella predefinita.

Per selezionare la cartella nella finestra di dialogo Pacchetto SSIS, selezionare Sfoglia (...). Tuttavia, la finestra di dialogo non consente di selezionare la cartella predefinita. Se si desidera utilizzare la cartella predefinita, è necessario immettere "/" nella casella di testo.

Usa l'archiviazione su server per la crittografia
Selezionare questa opzione per usare le funzionalità di sicurezza del motore di database per proteggere i pacchetti.

Avanti
Consente di passare alla pagina successiva della procedura guidata.

Fine
Consente di passare alla pagina Completamento Installazione guidata pacchetti. Usare questa opzione se sono state controllate le scelte effettuate nelle pagine precedenti della procedura guidata e sono state specificate tutte le opzioni necessarie.

Pagina Completamento Installazione guidata pacchetti

Usare la pagina Completamento Installazione guidata pacchetti per visualizzare un riepilogo dei risultati dell'installazione dei pacchetti. In questa pagina sono specificati dettagli quali il nome del progetto di Integration Services distribuito, i pacchetti installati, i file di configurazione e il percorso di installazione.

Fine
Fare clic su Fineper uscire dalla procedura guidata.