Parametri di Integration Services (SSIS)

I parametri (SSIS) di Integration Services consentono di assegnare valori alle proprietà incluse nei pacchetti durante la fase di esecuzione. È possibile creare parametri di progetto al livello del progetto e parametri di pacchetto al livello del pacchetto. I parametri del progetto vengono utilizzati per fornire input esterno ricevuto dal progetto a uno o più pacchetti nel progetto. I parametri del pacchetto consentono di modificare l'esecuzione del pacchetto senza doverlo modificare e ridistribuire.

In SQL Server Data Tools è possibile creare, modificare o eliminare i parametri di progetto utilizzando la finestra Project.params. Per creare, modificare ed eliminare i parametri di pacchetto, utilizzare la scheda Parametri in Progettazione SSIS. Per associare un parametro nuovo o esistente a una proprietà di un'attività, utilizzare la finestra di dialogo Imposta parametri. Per ulteriori informazioni sull'utilizzo della finestra Project.params e della scheda Parametri, vedere Creazione di parametri. Per ulteriori informazioni sulla finestra di dialogo Imposta parametri, vedere Finestra di dialogo Imposta parametri.

Parametri e modello di distribuzione del pacchetto

In generale, se un pacchetto viene distribuito mediante il relativo modello di distribuzione, è necessario utilizzare le configurazioni anziché i parametri.

Quando si distribuisce un pacchetto che contiene parametri utilizzando il modello di distribuzione del pacchetto e quindi si esegue il pacchetto, i parametri non vengono chiamati durante l'esecuzione. Se il pacchetto contiene espressioni e parametri di pacchetto all'interno del pacchetto, utilizzare i parametri per applicare i valori risultanti in fase di esecuzione. Se il pacchetto contiene parametri di progetto, è possibile che l'esecuzione del pacchetto non venga completata.

Parametri e modello di distribuzione del progetto

Quando si distribuisce un progetto nel server Integration Services, è possibile utilizzare viste, stored procedure e l'interfaccia utente di SQL Server Management Studio per gestire i parametri di progetto e di pacchetto. Per ulteriori informazioni, vedere gli argomenti seguenti.

• Viste (catalogo di Integration Services)

• Stored procedure (catalogo di Integration Services)

• Finestra di dialogo Configura

• Finestra di dialogo Esecuzione pacchetto

Valori di parametri

È possibile assegnare fino a tre tipi diversi di valori a un parametro. Quando viene avviata l'esecuzione di un pacchetto, viene utilizzato un solo valore per il parametro e il parametro viene risolto nel relativo valore letterale finale.

Nella tabella riportata di seguito sono elencati i tipi di valori.

È possibile utilizzare un solo parametro per assegnare un valore a più proprietà del pacchetto. A una singola proprietà del pacchetto è possibile assegnare un valore solo da un singolo parametro.

Esecuzioni e valori dei parametri

L'esecuzione è un oggetto che rappresenta una singola istanza di esecuzione del pacchetto. Quando si crea un'esecuzione, è possibile specificare tutti i dettagli necessari per l'esecuzione di un pacchetto, ad esempio i valori dei parametri di esecuzione. Inoltre, è possibile modificare i valori dei parametri per le esecuzioni esistenti.

Quando si imposta in modo esplicito un valore del parametro di esecuzione, tale valore è applicabile unicamente a quell'istanza particolare di esecuzione. Anziché un valore del server o un valore di progettazione viene utilizzato un valore di esecuzione. Se non si imposta in modo esplicito un valore di esecuzione ed è stato specificato un valore del server, viene utilizzato quest'ultimo.

Se un parametro è contrassegnato come obbligatorio, è necessario specificare per tale parametro un valore del server o un valore di esecuzione. In caso contrario, il pacchetto corrispondente non viene eseguito. Sebbene al parametro sia associato un valore predefinito in fase di progettazione, non sarà mai utilizzato dopo la distribuzione del progetto.

Variabili di ambiente

Se un parametro fa riferimento a una variabile di ambiente, il valore letterale di tale variabile viene risolto attraverso il riferimento all'ambiente specificato e applicato al parametro. Il valore del parametro letterale finale utilizzato per l'esecuzione del pacchetto è definito valore del parametro di esecuzione. Il riferimento all'ambiente per un'esecuzione viene specificato tramite la finestra di dialogo Esegui.

Se un parametro del progetto fa riferimento a una variabile di ambiente e il valore letterale della variabile non può essere risolto in fase di esecuzione, viene utilizzato il valore di progettazione. Il valore del server non viene utilizzato.

Per visualizzare le variabili di ambiente assegnate ai valori del parametro, eseguire una query sulla vista catalog.object_parameters. Per ulteriori informazioni, vedere catalog.object_parameters (database SSISDB).

Determinazione dei valori dei parametri di esecuzione

Le stored procedure e le viste Transact-SQL seguenti possono essere utilizzate per visualizzare e impostare i valori di parametri.

• catalog.execution_parameter_values (database SSISDB) (vista)
  Consente di visualizzare i valori di parametri effettivi che verranno utilizzati da un'esecuzione specifica

• catalog.get_parameter_values (database SSISDB) (stored procedure)
  Consente di risolvere e visualizzare i valori effettivi per il riferimento all'ambiente e al pacchetto specificato

• catalog.object_parameters (database SSISDB) (vista)
  Consente di visualizzare i parametri e le proprietà per tutti i pacchetti e i progetti nel catalogo di Integration Services, inclusi i valori predefiniti del server e i valori predefiniti di progettazione.

• catalog.set_execution_parameter_value (database SSISDB)
  Imposta il valore di un parametro per un'istanza di esecuzione nel catalogo di Integration Services.

È inoltre possibile utilizzare la finestra di dialogo Esegui pacchetto in SQL Server Data Tools (SSDT) per modificare il valore di un parametro. Per ulteriori informazioni, vedere Finestra di dialogo Esecuzione pacchetto.

È inoltre possibile utilizzare l'opzione dtexec /Parameter per modificare il valore di un parametro. Per ulteriori informazioni, vedere Utilità dtexec.

Convalida dei parametri

Se i valori dei parametri non possono essere risolti, il pacchetto corrispondente non viene eseguito. Per evitare errori, è possibile convalidare progetti e pacchetti mediante la finestra di dialogo Convalida in SQL Server Data Tools (SSDT). Tramite la convalida è possibile confermare che tutti i parametri dispongono dei valori necessari o che possono risolvere i valori necessari con riferimenti all'ambiente specifici. Durante la convalida vengono inoltre verificati altri problemi comuni relativi ai pacchetti.

Per ulteriori informazioni, vedere Finestra di dialogo Convalida.

Esempio di parametro

In questo esempio viene descritto un parametro denominato pkgOptions utilizzato per specificare opzioni per il pacchetto in cui risiede.

Durante la fase di progettazione, quando il parametro è stato creato in SQL Server Data Tools, il valore predefinito 1 è stato assegnato al parametro. Questo valore predefinito è noto come valore predefinito di progettazione. Se il progetto è stato distribuito nel catalogo SSISDB e non sono stati assegnati altri valori al parametro, durante l'esecuzione del pacchetto alla proprietà del pacchetto corrispondente al parametro pkgOptions verrà assegnato il valore 1. Il valore predefinito di progettazione viene reso persistente nel progetto per tutto il ciclo di vita.

Durante la preparazione di un'istanza specifica di esecuzione del pacchetto, il valore 5 viene assegnato al parametro pkgOptions. A questo valore viene fatto riferimento come valore di esecuzione perché si applica al parametro solo per quell'istanza specifica dell'esecuzione. All'avvio dell'esecuzione, alla proprietà del pacchetto corrispondente al parametro pkgOptions viene assegnato il valore 5.

Attività correlate

Creazione di parametri

Impostazione dei valori di parametri dopo la distribuzione del progetto

Contenuto correlato

Intervento nel blog riguardante un suggerimento rapido relativo ai parametri obbligatori in SQL Server Integration Services sul sito Web mattmasson.com.