Impostare le proprietà di un pacchetto
Si applica a:
SQL ServerSSIS Integration Runtime in Azure Data Factory
Quando viene creato un pacchetto in SQL Server Data Tools (SSDT) utilizzando l'interfaccia grafica offerta da Integration Services, è possibile impostare le proprietà dell'oggetto pacchetto nella finestra Proprietà.
In tale finestra le proprietà possono essere elencate per categorie o in ordine alfabetico. Per elencare gli elementi della finestra Proprietà per categoria, fare clic sull'icona Per categoria.
Quando si utilizza questa modalità, le proprietà visualizzate nella finestra Proprietà vengono raggruppate nelle categorie seguenti:
Per informazioni sulle proprietà aggiuntive di un pacchetto che non è possibile impostare nella finestra Proprietà , vedere Package.
Per impostare le proprietà di un pacchetto nella finestra Proprietà
Proprietà per categoria
Nelle tabelle seguenti vengono elencate le proprietà di un pacchetto in base alla categoria.
Checkpoint
È possibile utilizzare le proprietà in questa categoria per riavviare il pacchetto da un punto problematico nel flusso di controllo, anziché rieseguire il pacchetto dall'inizio del flusso di controllo. Per ulteriori informazioni, vedere Restart Packages by Using Checkpoints.
| Proprietà | Descrizione |
|---|---|
| CheckpointFileName | Nome del file in cui vengono acquisite le informazioni di checkpoint che consentono il riavvio del pacchetto. Se l'esecuzione del pacchetto viene completata correttamente, questo file verrà eliminato. |
| CheckpointUsage | Specifica quando è possibile riavviare il pacchetto. I possibili valori sono Never, IfExistse Always. Il valore predefinito della proprietà è Never, che indica che il pacchetto non può essere riavviato. Per ulteriori informazioni, vedere DTSCheckpointUsage. |
| SaveCheckpoints | Specifica se i checkpoint vengono scritti nel file del checkpoint durante l'esecuzione del pacchetto. Il valore predefinito di questa proprietà è False. |
Nota
L'opzione /CheckPointing on di dtexec equivale a impostare la proprietà SaveCheckpoints del pacchetto su True e la proprietà CheckpointUsage su Always. Per altre informazioni, vedere dtexec Utility.
Esecuzione
Le proprietà di questa categoria consentono di configurare il comportamento in fase di esecuzione dell'oggetto di pacchetto.
| Proprietà | Descrizione |
|---|---|
| DelayValidation | Indica se la convalida del pacchetto viene posticipata fino all'esecuzione del pacchetto. Il valore predefinito di questa proprietà è False. |
| Disabilita | Indica se il pacchetto è disabilitato. Il valore predefinito di questa proprietà è False. |
| DisableEventHandlers | Specifica se i gestori di eventi del pacchetto vengono eseguiti. Il valore predefinito di questa proprietà è False. |
| FailPackageOnFailure | Indica se il pacchetto deve essere interrotto in caso di errore in uno dei suoi componenti. L'unico valore valido di questa proprietà è False. |
| FailParentOnError | Indica se il contenitore padre deve essere interrotto in caso di errore in uno dei contenitori figli. Il valore predefinito della proprietà è False. |
| MaxConcurrentExecutables | Numero di file eseguibili che il pacchetto è in grado di eseguire contemporaneamente. Il valore predefinito della proprietà è -1, che indica l'assenza di limiti. |
| MaximumErrorCount | Numero massimo di errori che si possono verificare prima che l'esecuzione del pacchetto venga arrestata. Il valore predefinito di questa proprietà è 1. |
| PackagePriorityClass | Classe di priorità del thread Win32 del pacchetto. I possibili valori sono Default, AboveNormal, Normal, BelowNormale Idle. Il valore predefinito di questa proprietà è Default. Per ulteriori informazioni, vedere DTSPriorityClass. |
Valore esecuzione forzato
Le proprietà di questa categoria consentono di configurare un valore di esecuzione facoltativo per il pacchetto.
| Proprietà | Descrizione |
|---|---|
| ForcedExecutionValue | Se la proprietà ForceExecutionValue è impostata su True, rappresenta il valore che specifica il valore di esecuzione facoltativo restituito dal pacchetto. Il valore predefinito di questa proprietà è 0. |
| ForcedExecutionValueType | Il tipo di dati ForcedExecutionValue. Il valore predefinito di questa proprietà è Int32. |
| ForceExecutionValue | Valore booleano che specifica se il valore di esecuzione facoltativo del contenitore deve essere forzato in modo da contenere un valore specifico. Il valore predefinito di questa proprietà è False. |
Identificazione
Le proprietà di questa categoria forniscono informazioni quali l'identificatore univoco e il nome del pacchetto.
| Proprietà | Descrizione |
|---|---|
| CreationDate | Data di creazione del pacchetto. |
| CreatorComputerName | Nome del computer in cui è stato creato il pacchetto. |
| CreatorName | Nome dell'utente che ha creato il pacchetto. |
| Descrizione | Descrizione delle funzionalità del pacchetto. |
| ID | GUID del pacchetto, assegnato al momento della creazione. Questa proprietà è di sola lettura. Per generare un nuovo valore casuale per la proprietà ID, selezionare <Genera nuovo ID> nell'elenco a discesa. |
| Nome | Il nome del pacchetto. |
| PackageType | Tipo di pacchetto. I possibili valori sono Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMainte SQLReplication. Il valore predefinito di questa proprietà è Default. Per ulteriori informazioni, vedere DTSPackageType. |
Varie
Le proprietà di questa categoria vengono utilizzate per l'accesso alle configurazioni e alle espressioni utilizzate dal pacchetto e per fornire informazioni sulle impostazioni locali e sulla modalità di registrazione del pacchetto. Per altre informazioni, vedere Utilizzo delle espressioni di proprietà nei pacchetti.
| Proprietà | Descrizione |
|---|---|
| Configurazioni | Raccolta delle configurazioni utilizzate dal pacchetto. Per visualizzare e configurare le configurazioni del pacchetto, fare clic sul pulsante Sfoglia (...). |
| Espressioni | Per creare espressioni per le proprietà del pacchetto, fare clic sul pulsante Sfoglia (...). È possibile creare espressioni di proprietà per tutte le proprietà del pacchetto incluse nel modello a oggetti, non solo per quelle elencate nella finestra Proprietà. Per altre informazioni, vedere Utilizzo delle espressioni di proprietà nei pacchetti. Per visualizzare le espressioni di proprietà esistenti, espandere Expressions. Per modificare e valutare un'espressione, fare clic sul pulsante Sfoglia (...) nella casella di testo dell'espressione. |
| ForceExecutionResult | Risultato dell'esecuzione del pacchetto. I valori sono None, Success, Failuree Completion. Il valore predefinito di questa proprietà è None. Per altre informazioni, vedere T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult. |
| LocaleId | Impostazioni locali Microsoft Win32. Il valore predefinito di questa proprietà è costituito dalle impostazioni locali del sistema operativo sul computer locale. |
| LoggingMode | Valore che specifica il comportamento di registrazione del pacchetto. I possibili valori sono Disabled, Enablede UseParentSetting. Il valore predefinito di questa proprietà è UseParentSetting. Per ulteriori informazioni, vedere DTSLoggingMode. |
| OfflineMode | Indica se il pacchetto è in modalità offline. Questa proprietà è di sola lettura. e viene impostata a livello di progetto. In genere, SSIS Designer tenta di connettersi a ogni origine dei dati utilizzata dal pacchetto per convalidare i metadati associati alle origini e alle destinazioni. È possibile attivare l'opzione Offline dal menu SSIS anche prima di aprire un pacchetto, per impedire questi tentativi di connessione e gli errori di convalida risultanti quando le origini dei dati non sono disponibili. È anche possibile abilitare l'opzione Offline per rendere più veloci le operazioni di progettazione e disabilitarla solo quando si vuole convalidare il pacchetto. |
| SuppressConfigurationWarnings | Indica se gli avvisi generati dalle configurazioni vengono soppressi. Il valore predefinito di questa proprietà è False. |
| UpdateObjects | Indica se il pacchetto viene aggiornato in modo da utilizzare le versioni più recenti, se disponibili, degli oggetti che contiene. Se ad esempio la proprietà è impostata su True, un pacchetto che include un'attività Inserimento bulk viene aggiornato in modo da usare la versione più recente dell'attività Inserimento bulk disponibile in Integration Services. Il valore predefinito di questa proprietà è False. |
Sicurezza
Le proprietà di questa categoria consentono di impostare il livello di protezione del pacchetto. Per altre informazioni, vedere Access Control for Sensitive Data in Packages.
| Proprietà | Descrizione |
|---|---|
| PackagePassword | Password per i livelli di protezione del pacchetto che richiedono una password (EncryptSensitiveWithPassword e EncryptAllWithPassword). |
| ProtectionLevel | Livello di protezione del pacchetto. I possibili valori sono DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassworde ServerStorage. Il valore predefinito di questa proprietà è EncryptSensitiveWithUserKey. Per ulteriori informazioni, vedere DTSProtectionLevel. |
Transazioni
Le proprietà di questa categoria consentono di configurare il livello di isolamento e l'opzione relativa alle transazioni per il pacchetto. Per altre informazioni, vedere Transazioni di Integration Services.
| Proprietà | Descrizione |
|---|---|
| IsolationLevel | Livello di isolamento della transazione del pacchetto. I valori sono Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializablee Snapshot. Il valore predefinito di questa proprietà è Serializable. Nota: il valore Snapshot della proprietà IsolationLevel non è compatibile con le transazioni del pacchetto e quindi Pertanto, non è possibile utilizzare la proprietà IsolationLevel per impostare il livello di isolamento delle transazioni del pacchetto su Snapshot. Usare invece una query SQL per impostare le transazioni del pacchetto su Snapshot. Per ulteriori informazioni, vedere SET TRANSACTION ISOLATION LEVEL (Transact-SQL). La proprietà IsolationLevel viene applicata automaticamente alle transazioni del pacchetto solo quando il valore della proprietà TransactionOption è Required. Il valore della proprietà IsolationLevel richiesta da un contenitore figlio viene ignorato quando le condizioni seguenti sono vere: Il valore della proprietà TransactionOption del contenitore figlio è Supported. Il contenitore figlio partecipa alla transazione di un contenitore padre. Il valore della proprietà IsolationLevel richiesta dal contenitore viene rispettato solo quando il contenitore avvia una nuova transazione. Un contenitore avvia una nuova transazione quando le condizioni seguenti sono vere: Il valore della proprietà TransactionOption del contenitore è Required. Non è stata ancora avviata alcuna transazione da parte del padre. Per ulteriori informazioni, vedere IsolationLevel. |
| TransactionOption | Supporto delle transazioni da parte del pacchetto. I possibili valori sono NotSupported, Supportede Required. Il valore predefinito di questa proprietà è Supported. Per ulteriori informazioni, vedere DTSTransactionOption. |
Versione
Le proprietà di questa categoria forniscono informazioni sulla versione dell'oggetto di pacchetto.
| Proprietà | Descrizione |
|---|---|
| VersionBuild | Numero di build del pacchetto. |
| VersionComments | Commenti sulla versione del pacchetto. |
| VersionGUID | GUID della versione del pacchetto. Questa proprietà è di sola lettura. |
| VersionMajor | Versione principale più recente del pacchetto. |
| VersionMinor | Versione secondaria più recente del pacchetto. |
Impostare le proprietà di un pacchetto nella finestra Proprietà
In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto che si vuole configurare.
In Esplora soluzionifare doppio clic sul pacchetto per aprirlo in SSIS Designer oppure fare clic su di esso con il pulsante destro del mouse e scegliere Progettazione visualizzazioni.
Fare clic sulla scheda Flusso di controllo e quindi eseguire una delle operazioni seguenti:
Fare clic con il pulsante destro del mouse in un punto qualsiasi dello sfondo dell'area di progettazione del flusso di controllo, quindi scegliere Proprietà.
Scegliere Finestra Proprietà dal menu Visualizza.
Modificare le proprietà del pacchetto nella finestra Proprietà .
Scegliere Salva elementi selezionati dal menu File per salvare il pacchetto aggiornato.