Impostazione delle proprietà di un pacchettoSet Package Properties

Quando viene creato un pacchetto in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) utilizzando l'interfaccia grafica offerta da Integration ServicesIntegration Services , è possibile impostare le proprietà dell'oggetto pacchetto nella finestra Proprietà.When you create a package in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) by using the graphical interface that Integration ServicesIntegration Services provides, you set the properties of the package object in the Properties window.

In tale finestra **** le proprietà possono essere elencate per categorie o in ordine alfabetico.The Properties window provides a categorized and alphabetical list of properties. Per elencare gli elementi della finestra Proprietà per categoria, fare clic sull'icona Per categoria.To arrange the Properties window by category, click the Categorized icon.

Quando si utilizza questa modalità, le proprietà visualizzate nella finestra Proprietà vengono raggruppate nelle categorie seguenti:When arranged by category, the Properties window groups properties in the following categories:

Per impostare le proprietà di un pacchetto nella finestra ProprietàTo set package properties in the Properties window

Proprietà per categoriaProperties by Category

Nelle tabelle seguenti vengono elencate le proprietà di un pacchetto in base alla categoria.The following tables list the package properties by category.

Checkpoint Checkpoints

È 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.You can use the properties in this category to restart the package from a point of failure in the package control flow, instead of rerunning the package from the beginning of its control flow. Per ulteriori informazioni, vedere Restart Packages by Using Checkpoints.For more information, see Restart Packages by Using Checkpoints.

ProprietàProperty DescriptionDescription
CheckpointFileNameCheckpointFileName Nome del file in cui vengono acquisite le informazioni di checkpoint che consentono il riavvio del pacchetto.The name of the file that captures the checkpoint information that enables a package to restart. Se l'esecuzione del pacchetto viene completata correttamente, questo file verrà eliminato.When the package finishes successfully, this file is deleted.
CheckpointUsageCheckpointUsage Specifica quando è possibile riavviare il pacchetto.Specifies when a package can be restarted. I possibili valori sono Never, IfExistse Always.The values are Never, IfExists, and Always. Il valore predefinito della proprietà è Never, che indica che il pacchetto non può essere riavviato.The default value of this property is Never, which indicates that the package cannot be restarted. Per ulteriori informazioni, vedere DTSCheckpointUsage.For more information, see DTSCheckpointUsage.
SaveCheckpointsSaveCheckpoints Specifica se i checkpoint vengono scritti nel file del checkpoint durante l'esecuzione del pacchetto.Specifies whether the checkpoints are written to the checkpoint file when the package runs. Il valore predefinito di questa proprietà è False.The default value of this property is False.

Nota

L'opzione /CheckPointing on di dtexec equivale a impostare la proprietà SaveCheckpoints del pacchetto su True e la proprietà CheckpointUsage su Always.The /CheckPointing on option of dtexec is equivalent to setting the SaveCheckpoints property of the package to True, and the CheckpointUsage property to Always. Per altre informazioni, vedere dtexec Utility.For more information, see dtexec Utility.

Esecuzione Execution

Le proprietà di questa categoria consentono di configurare il comportamento in fase di esecuzione dell'oggetto di pacchetto.The properties in this category configure the run-time behavior of the package object.

ProprietàProperty DescriptionDescription
DelayValidationDelayValidation Indica se la convalida del pacchetto viene posticipata fino all'esecuzione del pacchetto.Indicates whether package validation is delayed until the package runs. Il valore predefinito di questa proprietà è False.The default value for this property is False.
DisableDisable Indica se il pacchetto è disabilitato.Indicates whether the package is disabled. Il valore predefinito di questa proprietà è False.The default value of this property is False.
DisableEventHandlersDisableEventHandlers Specifica se i gestori di eventi del pacchetto vengono eseguiti.Specifies whether the package event handlers run. Il valore predefinito di questa proprietà è False.The default value of this property is False.
FailPackageOnFailureFailPackageOnFailure Indica se il pacchetto deve essere interrotto in caso di errore in uno dei suoi componenti.Specifies whether the package fails if an error occurs in a package component. L'unico valore valido di questa proprietà è False.The only valid value of this property is False.
FailParentOnErrorFailParentOnError Indica se il contenitore padre deve essere interrotto in caso di errore in uno dei contenitori figli.Specifies whether the parent container fails if an error occurs in a child container. Il valore predefinito della proprietà è False.The default value is of this property is False.
MaxConcurrentExecutablesMaxConcurrentExecutables Numero di file eseguibili che il pacchetto è in grado di eseguire contemporaneamente.The number of executable files that the package can run concurrently. Il valore predefinito della proprietà è -1, che indica l'assenza di limiti.The default value of this property is -1, which indicates that there is no limit.
MaximumErrorCountMaximumErrorCount Numero massimo di errori che si possono verificare prima che l'esecuzione del pacchetto venga arrestata.The maximum number of errors that can occur before a package stops running. Il valore predefinito di questa proprietà è 1.The default value of this property is 1.
PackagePriorityClassPackagePriorityClass Classe di priorità del thread Win32 del pacchetto.The Win32 thread priority class of the package thread. I possibili valori sono Default, AboveNormal, Normal, BelowNormale Idle.The values are Default, AboveNormal, Normal, BelowNormal, Idle. Il valore predefinito di questa proprietà è Default.The default value of this property is Default. Per ulteriori informazioni, vedere DTSPriorityClass.For more information, see DTSPriorityClass.

Valore esecuzione forzato Forced Execution Value

Le proprietà di questa categoria consentono di configurare un valore di esecuzione facoltativo per il pacchetto.The properties in this category configure an optional execution value for the package.

ProprietàProperty DescriptionDescription
ForcedExecutionValueForcedExecutionValue Se la proprietà ForceExecutionValue è impostata su True, rappresenta il valore che specifica il valore di esecuzione facoltativo restituito dal pacchetto.If ForceExecutionValue is set to True, a value that specifies the optional execution value that the package returns. Il valore predefinito di questa proprietà è 0.The default value of this property is 0.
ForcedExecutionValueTypeForcedExecutionValueType Il tipo di dati di ForcedExecutionValue.The data type of ForcedExecutionValue. Il valore predefinito di questa proprietà è Int32.The default value of this property is Int32.
ForceExecutionValueForceExecutionValue Valore booleano che specifica se il valore di esecuzione facoltativo del contenitore deve essere forzato in modo da contenere un valore specifico.A Boolean value that specifies whether the optional execution value of the container should be forced to contain a particular value. Il valore predefinito di questa proprietà è False.The default value of this property is False.

Identificazione Identification

Le proprietà di questa categoria forniscono informazioni quali l'identificatore univoco e il nome del pacchetto.The properties in this category provide information such as the unique identifier and name of the package.

ProprietàProperty DescriptionDescription
CreationDateCreationDate Data di creazione del pacchetto.The date that the package was created.
CreatorComputerNameCreatorComputerName Nome del computer in cui è stato creato il pacchetto.The name of the computer on which the package was created.
CreatorNameCreatorName Nome dell'utente che ha creato il pacchetto.The name of the person who created the package.
DescriptionDescription Descrizione delle funzionalità del pacchetto.A description of package functionality.
IDID GUID del pacchetto, assegnato al momento della creazione.The package GUID, which is assigned when the package is created. Questa proprietà è di sola lettura.This property is read-only. Per generare un nuovo valore casuale per il ID proprietà, selezionare <Genera nuovo ID> nell'elenco a discesa.To generate a new random value for the ID property, select <Generate New ID> in the drop-down list.
NomeName Nome del pacchetto.The name of the package.
PackageTypePackageType Tipo di pacchetto.The package type. I possibili valori sono Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMainte SQLReplication.The values are Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaint, and SQLReplication. Il valore predefinito di questa proprietà è Default.The default value of this property is Default. Per ulteriori informazioni, vedere DTSPackageType.For more information, see DTSPackageType.

Varie Misc

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.The properties in this category are used to access the configurations and expressions that a package uses and to provide information about the locale and logging mode of the package. Per altre informazioni, vedere Utilizzo delle espressioni di proprietà nei pacchetti.For more information, see Use Property Expressions in Packages.

ProprietàProperty DescriptionDescription
ConfigurazioniConfigurations Raccolta delle configurazioni utilizzate dal pacchetto.The collection of configurations that the package uses. Per visualizzare e configurare le configurazioni del pacchetto, fare clic sul pulsante Sfoglia (…) .Click the browse button (…) to view and configure package configurations.
EspressioniExpressions Per creare espressioni per le proprietà del pacchetto, fare clic sul pulsante Sfoglia (…) .Click the browse button (…) to create expressions for package properties.

È possibile creare espressioni di proprietà per tutte le proprietà del pacchetto incluse nel modello a oggetti, non solo per quelle elencate nella finestra Proprietà.Note that you can create property expressions for all the package properties that object model includes, not just the properties listed in the Properties window.

Per altre informazioni, vedere Utilizzo delle espressioni di proprietà nei pacchetti.For more information, see Use Property Expressions in Packages.

Per visualizzare le espressioni di proprietà esistenti, espandere Expressions.To view existing property expressions, expand Expressions. Per modificare e valutare un'espressione, fare clic sul pulsante Sfoglia (…) nella casella di testo dell'espressione.Click the browse button (…) in an expression text box to modify and evaluate an expression.
ForceExecutionResultForceExecutionResult Risultato dell'esecuzione del pacchetto.The execution result of the package. I valori sono None, Success, Failuree Completion.The values are None, Success, Failure, and Completion. Il valore predefinito di questa proprietà è None.The default value of this property is None. Per altre informazioni, vedere T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.For more information, see T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.
LocaleIdLocaleId Impostazioni locali Microsoft Win32.A Microsoft Win32 locale. Il valore predefinito di questa proprietà è costituito dalle impostazioni locali del sistema operativo sul computer locale.The default value of this property is the locale of the operating system on the local computer.
LoggingModeLoggingMode Valore che specifica il comportamento di registrazione del pacchetto.A value that specifies the logging behavior of the package. I possibili valori sono Disabled, Enablede UseParentSetting.The values are Disabled, Enabled, and UseParentSetting. Il valore predefinito di questa proprietà è UseParentSetting.The default value of this property is UseParentSetting. Per ulteriori informazioni, vedere DTSLoggingMode.For more information, see DTSLoggingMode.
OfflineModeOfflineMode Indica se il pacchetto è in modalità offline.Indicates whether the package is in offline mode. Questa proprietà è di sola lettura.This property is read-only. e viene impostata a livello di progetto.The property is set at the project level. In genere, Progettazione SSISSSIS tenta di connettersi a ogni origine dei dati utilizzata dal pacchetto per convalidare i metadati associati alle origini e alle destinazioni.Normally, SSISSSIS Designer tries to connect to each data source used by your package to validate the metadata associated with sources and destinations. È 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.You can enable Work Offline from the SSIS menu, even before you open a package, to prevent these connection attempts and the resulting validation errors when the data sources are not available. È anche possibile abilitare l'opzione Offline per rendere più veloci le operazioni di progettazione e disabilitarla solo quando si vuole convalidare il pacchetto.You can also enable Work Offline to speed up operations in the designer, and disable it only when you want your package to be validated.
SuppressConfigurationWarningsSuppressConfigurationWarnings Indica se gli avvisi generati dalle configurazioni vengono soppressi.Indicates whether the warnings generated by configurations are suppressed. Il valore predefinito di questa proprietà è False.The default value of this property is False.
UpdateObjectsUpdateObjects Indica se il pacchetto viene aggiornato in modo da utilizzare le versioni più recenti, se disponibili, degli oggetti che contiene.Indicates whether the package is updated to use newer versions of the objects it contains, if newer versions are available. 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 ServicesIntegration Services .For example, if this property is set to True, a package that includes a Bulk Insert task is updated to use the newer version of the Bulk Insert task that Integration ServicesIntegration Services provides. Il valore predefinito di questa proprietà è False.The default value of this property is False.

Sicurezza Security

Le proprietà di questa categoria consentono di impostare il livello di protezione del pacchetto.The properties in this category are used to set the protection level of the package. Per altre informazioni, vedere Access Control for Sensitive Data in Packages.For more information, see Access Control for Sensitive Data in Packages.

ProprietàProperty DescriptionDescription
PackagePasswordPackagePassword Password per i livelli di protezione del pacchetto che richiedono una password (EncryptSensitiveWithPassword e EncryptAllWithPassword).The password for package protection levels (EncryptSensitiveWithPassword and EncryptAllWithPassword) that require passwords.
ProtectionLevelProtectionLevel Livello di protezione del pacchetto.The protection level of the package. I possibili valori sono DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassworde ServerStorage.The values are DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassword, and ServerStorage. Il valore predefinito di questa proprietà è EncryptSensitiveWithUserKey.The default value of this property is EncryptSensitiveWithUserKey. Per ulteriori informazioni, vedere DTSProtectionLevel.For more information, see DTSProtectionLevel.

Transazioni Transactions

Le proprietà di questa categoria consentono di configurare il livello di isolamento e l'opzione relativa alle transazioni per il pacchetto.The properties in this category configure the isolation level and the transaction option of the package. Per altre informazioni, vedere Transazioni di Integration Services.For more information, see Integration Services Transactions.

ProprietàProperty DescriptionDescription
IsolationLevelIsolationLevel Livello di isolamento della transazione del pacchetto.The isolation level of the package transaction. I valori sono Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializablee Snapshot.The values are Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable, and Snapshot. Il valore predefinito di questa proprietà è Serializable.The default value of this property is Serializable.

Nota: il valore Snapshot della proprietà IsolationLevel non è compatibile con le transazioni del pacchetto e quindiNote: The Snapshot value of the IsolationLevel property is incompatible with package transactions. non è possibile utilizzare la proprietà IsolationLevel per impostare il livello di isolamento delle transazioni del pacchetto su Shapshot.Therefore, you cannot use the IsolationLevel property to set the isolation level of package transactions to Shapshot. È necessario invece eseguire una query SQL per impostare le transazioni del pacchetto su Snapshot.Instead, use an SQL query to set package transactions to Snapshot. Per altre informazioni, vedere SET TRANSACTION ISOLATION LEVEL (Transact-SQL).For more information, see SET TRANSACTION ISOLATION LEVEL (Transact-SQL).

La proprietà IsolationLevel viene applicata automaticamente alle transazioni del pacchetto solo quando il valore della proprietà TransactionOption è Required.The system applies the IsolationLevel property to package transactions only when the value of the TransactionOption property is Required.

Il valore della proprietà IsolationLevel richiesta da un contenitore figlio viene ignorato quando le condizioni seguenti sono vere:The value of the IsolationLevel property requested by a child container is ignored when the following conditions are true:
Il valore della proprietà TransactionOption del contenitore figlio è Supported.The value of the child container's TransactionOption property is Supported.
Il contenitore figlio partecipa alla transazione di un contenitore padre.The child container joins the transaction of a parent container.

Il valore della proprietà IsolationLevel richiesta dal contenitore viene rispettato solo quando il contenitore avvia una nuova transazione.The value of the IsolationLevel property requested by the container is respected only when the container initiates a new transaction. Un contenitore avvia una nuova transazione quando le condizioni seguenti sono vere:A container initiates a new transaction when the following conditions are true:
Il valore della proprietà TransactionOption del contenitore è Required.The value of the container's TransactionOption property is Required.
Non è stata ancora avviata alcuna transazione da parte del padre.The parent has not already started a transaction.



Per ulteriori informazioni, vedere IsolationLevel.For more information, see IsolationLevel.
TransactionOptionTransactionOption Supporto delle transazioni da parte del pacchetto.The transactional participation of the package. I possibili valori sono NotSupported, Supportede Required.The values are NotSupported, Supported, Required. Il valore predefinito di questa proprietà è Supported.The default value of this property is Supported. Per ulteriori informazioni, vedere DTSTransactionOption.For more information, see DTSTransactionOption.

Version Version

Le proprietà di questa categoria forniscono informazioni sulla versione dell'oggetto di pacchetto.The properties in this category provide information about the version of the package object.

ProprietàProperty DescriptionDescription
VersionBuildVersionBuild Numero di build del pacchetto.The version number of the build of the package.
VersionCommentsVersionComments Commenti sulla versione del pacchetto.Comments about the version of the package.
VersionGUIDVersionGUID GUID della versione del pacchetto.The GUID of the version of the package. Questa proprietà è di sola lettura.This property is read-only.
VersionMajorVersionMajor Versione principale più recente del pacchetto.The latest major version of the package.
VersionMinorVersionMinor Versione secondaria più recente del pacchetto.The latest minor version of the package.

Impostare le proprietà del pacchetto nella finestra proprietàSet package properties in the Properties window

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services contenente il pacchetto che si desidera configurare.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want to configure.

  2. In Esplora soluzionifare doppio clic sul pacchetto per aprirlo in Progettazione SSISSSIS oppure fare clic su di esso con il pulsante destro del mouse e scegliere Visualizza finestra di progettazione.In Solution Explorer, double-click the package to open it in SSISSSIS Designer, or right-click and select View Designer.

  3. Fare clic sulla scheda Flusso di controllo e quindi eseguire una delle operazioni seguenti:Click the Control Flow tab and then do one of the following:

    • Fare clic con il pulsante destro del mouse in un punto qualsiasi dello sfondo dell'area di progettazione del flusso di controllo e quindi scegliere Proprietà.Right-click anywhere in the background of the control flow design surface, and then click Properties.

    • Scegliere Finestra Proprietà dal menu Visualizza.On the View menu, click Properties Window.

  4. Modificare le proprietà del pacchetto nella finestra Proprietà .Edit the package properties in the Properties window.

  5. Scegliere Salva elementi selezionati dal menu File per salvare il pacchetto aggiornato.On the File menu, click Save Selected Items to save the updated package.