Configurazioni di pacchetto

Data aggiornamento: 17 luglio 2006

In SQL Server 2005 Integration Services (SSIS) sono disponibili configurazioni di pacchetto che è possibile utilizzare 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 verrà 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 metodi di archiviazione delle configurazioni di pacchetto diversi, 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.

[!NOTA] Per acquisire maggiore familiarità con i concetti spiegati in questa sezione, vedere Esercitazione per la distribuzione di pacchetti e Lezione 3: Aggiunta delle configurazioni dei pacchetti in Esercitazione per la creazione di un pacchetto ETL semplice.

Tipi di configurazioni di pacchetti

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

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 di registro	La configurazione è inclusa in una voce di registro.
Variabile di 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, riutilizzare un file esistente e aggiungere nuove configurazioni oppure riutilizzare 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 utilizzare una voce del Registro di sistema per archiviare la configurazione, è possibile utilizzare una chiave esistente oppure creare una nuova chiave in HKEY_CURRENT_USER. La chiave del Registro di sistema utilizzata deve disporre di un valore denominato Value, che può corrispondere a un valore 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, nel formato <chiave Registro di sistema>. Se si desidera utilizzare una chiave del Registro di sistema che non si trova nella chiave principale HKEY_CURRENT_USER, per identificare la chiave utilizzare il formato <chiave Registro di sistema\chiave Registro di sistema\...>. Per utilizzare 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

In Integration Services sono disponibili configurazioni dirette e indirette. Se le configurazioni vengono specificate in modo diretto, in Integration Services viene creato un collegamento diretto tra l'elemento di configurazione e la proprietà dell'oggetto di pacchetto. È consigliabile utilizzare 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.

Vedere anche

Attività

Creazione di configurazioni di pacchetto

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione	Cronologia
17 luglio 2006	Contenuto modificato: Aggiunta di un collegamento all'esercitazione in cui viene illustrato come creare e utilizzare le configurazioni di pacchetto in una distribuzione.
14 aprile 2006	Contenuto modificato: Aggiunta delle informazioni relative all'utilizzo delle voci del Registro di sistema per l'archiviazione delle configurazioni.