Parametri del pacchetto e del progetto di Integration Services (SSIS)

Articolo
05/23/2023

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

I parametri di Integration Services (SSIS) 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, usare 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 altre informazioni sull'utilizzo della finestra Project.params e della scheda Parametri , vedere Create Parameters. Per altre informazioni sulla finestra di dialogo Imposta parametri , vedere Parameterize Dialog Box.

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 (SSIS), è possibile usare viste, stored procedure e l'interfaccia utente di SQL Server Management Studio per gestire i parametri del progetto e del pacchetto. Per ulteriori informazioni, vedere gli argomenti seguenti.

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.

Nome valore	Descrizione	Tipo di valore
Valore di esecuzione	Valore assegnato a un'istanza specifica di esecuzione del pacchetto. Questa assegnazione esegue l'override di tutti gli altri valori, tuttavia è applicabile a una sola istanza di esecuzione del pacchetto.	Literal
Valore del server	Valore assegnato al parametro nell'ambito del progetto, dopo la distribuzione del progetto nel server Integration Services. Questo valore esegue l'override del valore predefinito di progettazione.	Valore letterale o riferimento a una variabile di ambiente
Valore di progettazione	Valore assegnato al parametro durante la creazione o modifica del progetto in SQL Server Data Tools. Questo valore rimane persistente nel progetto.	Literal

È 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 altre 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)
Visualizza i valori dei parametri effettivi in un'esecuzione specifica.

catalog.get_parameter_values (database SSISDB) (stored procedure)
Risolve e visualizza i valori effettivi per il riferimento al pacchetto e all'ambiente 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.

È anche possibile usare la finestra di dialogo Esegui pacchetto in SQL Server Data Tools (SSDT) per modificare il valore di un parametro. Per altre informazioni, vedere Execute Package Dialog Box.

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

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 altre informazioni, vedere Validate Dialog Box.

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.

Creare un parametro

È possibile usare SQL Server Data Tools (SSDT) per creare parametri di progetto e parametri di pacchetto. Le procedure riportate di seguito contengono istruzioni dettagliate per la creazione di parametri di pacchetto/progetto.

Nota

Se si converte un progetto creato con una versione precedente di Integration Services nel modello di distribuzione del progetto, è possibile usare la Conversione guidata progetto di Integration Services per creare parametri basati su configurazioni. Per altre informazioni, vedere Distribuire progetti e pacchetti di Integration Services (SSIS).

Creare parametri del pacchetto

Aprire il pacchetto in SQL Server Data Tools e quindi fare clic sulla scheda Parametri in Progettazione SSIS.
Fare clic sul pulsante Aggiungi parametro sulla barra degli strumenti.

Immettere i valori per le proprietà Nome, Tipo di dati, Valore, Sensibile e Richiesto nell'elenco stesso o nella finestra Proprietà. Queste proprietà sono descritte nella tabella seguente.

Proprietà	Descrizione
Name	Nome del parametro.
Tipo di dati	Tipo di dati del parametro.
Valore predefinito	Valore predefinito del parametro assegnato in fase di progettazione. Noto anche come valore predefinito di progettazione.
Sensibili	I valori di parametri sensibili sono crittografati nel catalogo e risultano NULL quando vengono visualizzati con Transact-SQL o con SQL Server Management Studio.
Richiesto	Richiede che un valore diverso dal valore predefinito di progettazione venga specificato prima dell'esecuzione del pacchetto.
Descrizione	Per manutenzione, la descrizione del parametro. In SQL Server Data Tools (SSDT) impostare la descrizione del parametro nella finestra Proprietà di Visual Studio quando il parametro viene selezionato nella finestra dei parametri applicabili.

Nota

Quando si distribuisce un progetto nel catalogo, molte più proprietà vengono associate al progetto. Per visualizzare tutte le proprietà di tutti i parametri nel catalogo, usare la vista catalog.object_parameters (database SSISDB).

Salvare il progetto per salvare le modifiche ai parametri. I valori dei parametri vengono archiviati nel file di progetto.

Avviso

È possibile modificare direttamente l'elenco oppure usare la finestra Proprietà per modificare i valori delle proprietà dei parametri. È possibile eliminare un parametro tramite il pulsante Elimina (X). Usando l'ultimo pulsante della barra degli strumenti, è possibile specificare un valore per un parametro usato solo quando si esegue il pacchetto in SQL Server Data Tools.

Nota

Se si riapre il file di pacchetto senza aprire il progetto in SQL Server Data Tools, la scheda Parametri sarà vuota e disabilitata.

Creare parametri del progetto

Aprire il progetto in SQL Server Data Tools.
Fare clic con il pulsante destro del mouse su Project.params in Esplora soluzioni e quindi scegliere Apri (OPPURE) fare doppio clic su Project.params per aprirlo.
Fare clic sul pulsante Aggiungi parametro sulla barra degli strumenti.

Immettere valori per le proprietà Nome, Tipo di dati, Valore, Sensibile e Richiesto.

Proprietà	Descrizione
Name	Nome del parametro.
Tipo di dati	Tipo di dati del parametro.
Valore predefinito	Valore predefinito del parametro assegnato in fase di progettazione. Noto anche come valore predefinito di progettazione.
Sensibili	I valori di parametri sensibili sono crittografati nel catalogo e risultano NULL quando vengono visualizzati con Transact-SQL o con SQL Server Management Studio.
Richiesto	Richiede che un valore diverso dal valore predefinito di progettazione venga specificato prima dell'esecuzione del pacchetto.
Descrizione	Per manutenzione, la descrizione del parametro. In SQL Server Data Tools impostare la descrizione del parametro nella finestra Proprietà di Visual Studio quando il parametro viene selezionato nella finestra dei parametri applicabili.

Salvare il progetto per salvare le modifiche ai parametri. I valori dei parametri sono archiviati nelle configurazioni del file di progetto. Salvare il file di progetto per eseguire il commit al disco delle eventuali modifiche apportate ai valori dei parametri.

Avviso

È possibile modificare direttamente l'elenco oppure usare la finestra Proprietà per modificare i valori delle proprietà dei parametri. È possibile eliminare un parametro tramite il pulsante Elimina (X). Usando l'ultimo pulsante della barra degli strumenti per aprire la finestra di dialogo Gestione dei valori dei parametri, è possibile specificare un valore per un parametro usato solo quando si esegue il pacchetto in SQL Server Data Tools.

Finestra di dialogo Imposta parametri

La finestra di dialogo Imposta parametri consente di associare un parametro nuovo o esistente a una proprietà di un'attività. È possibile aprire la finestra di dialogo facendo clic con il pulsante destro del mouse su un'attività o sulla scheda Flusso di controllo in Progettazione SSIS, quindi selezionando Imposta parametri. Nell'elenco seguente vengono descritti gli elementi dell'interfaccia utente della finestra di dialogo. Per altre informazioni sui parametri, vedere Parametri di Integration Services (SSIS).

Opzioni

Proprietà
Selezionare la proprietà dell'attività che si desidera associare a un parametro. Questo elenco viene popolato con tutte le proprietà che è possibile impostare come parametri.

Usa parametro esistente
Selezionare questa opzione per associare la proprietà dell'attività a un parametro esistente, quindi selezionare il parametro dall'elenco a discesa.

Non utilizzare il parametro
Selezionare questa opzione per rimuovere un riferimento a un parametro. Il parametro non viene eliminato.

Crea nuovo parametro
Selezionare questa opzione per creare un nuovo parametro che si desidera associare alla proprietà dell'attività.

Nome
Specificare il nome del parametro che si desidera creare.

Descrizione
Specificare la descrizione per il parametro.

valore
Specificare il valore predefinito per il parametro. Definito anche valore predefinito per la progettazione, potrà essere sostituito in seguito in fase di distribuzione.

Scope
Specificare l'ambito del parametro selezionando l'opzione Progetto o 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.

Sensibile
Specificare se il parametro è sensibile selezionando o deselezionando la casella di controllo. I valori di parametri sensibili sono crittografati nel catalogo e risultano NULL quando vengono visualizzati con Transact-SQL o con SQL Server Management Studio.

Obbligatorio
Specificare se il parametro richiede che un valore diverso dal valore predefinito per la progettazione venga specificato prima dell'esecuzione del pacchetto.

Impostare i valori dei parametri dopo la distribuzione del progetto

La Distribuzione guidata consente di impostare i valori dei parametri predefiniti quando si distribuisce il progetto nel catalogo. Quando il progetto si trova nel catalogo, è possibile utilizzare Transact-SQL o Esplora oggetti di SQL Server Management Studio (SSMS) per impostare i valori predefiniti del server.

Impostare i valori predefiniti del server con Esplora oggetti di SSMS

Selezionare e fare clic con il pulsante destro del mouse sul progetto nel nodo Integration Services.
Per aprire la finestra di dialogo Proprietà progetto fare clic su Proprietà .
Aprire la pagina dei parametri facendo clic su Parametri in Selezione pagina.
Selezionare il parametro desiderato nell'elenco Parametri . Nota: la colonna Contenitore consente di distinguere tra i parametri del progetto e i parametri del pacchetto.
Nella colonna Valore specificare il valore del parametro predefinito del server desiderato.

Impostare i valori predefiniti del server con Transact-SQL

Per impostare valori predefiniti del server con Transact-SQL, usare la stored procedure catalog.set_object_parameter_value (database SSISDB). Per visualizzare i valori predefiniti del server corrente, eseguire una query nella vista catalog.object_parameters (database SSISDB). Per cancellare un valore predefinito del server, usare la stored procedure catalog.clear_object_parameter_value (database SSISDB).