Impostazione delle proprietà di un componente del flusso di datiSet the Properties of a Data Flow Component

Per impostare le proprietà dei componenti flusso di dati, tra cui origini, destinazioni e trasformazioni, utilizzare una delle funzionalità seguenti:To set the properties of data flow components, which include sources, destinations, and transformations, use one of the following features:

  • Editor dei componenti forniti da Integration ServicesIntegration Services .The component editors that Integration ServicesIntegration Services provides. Gli editor includono solo le proprietà personalizzate di ogni componente flusso di dati.These editors include only the custom properties of each data flow component.

  • Nella finestra Proprietà sono elencate sia le proprietà personalizzate a livello di componente per ogni elemento, sia le proprietà comuni a tutti gli elementi del flusso di dati.The Properties window lists the component-level custom properties of each element, as well as the properties common to all data flow elements.

  • La finestra di dialogo Editor avanzato consente l'accesso alle proprietà personalizzate di ciascun componente.The Advanced Editor dialog box provides access to custom properties for each component. La finestra di dialogo Editor avanzato consente anche di accedere alle proprietà comuni a tutti i componenti flusso di dati, ovvero le proprietà degli input, degli output, degli output degli errori, delle colonne e delle colonne esterne.The Advanced Editor dialog box also provides access to the properties common to all data flow components—the properties of inputs, outputs, error outputs, columns, and external columns.

Impostare le proprietà di un componente del flusso di dati con un editor di componentiSet the properties of a data flow component with a component editor

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want.

  2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.In Solution Explorer, double-click the package to open it.

  3. Fare clic sulla scheda Flusso di controllo , quindi fare doppio clic sull'attività Flusso di dati che contiene il flusso di dati con il componente di cui si desidera visualizzare e modificare le proprietà.Click the Control Flow tab, and then double-click the Data Flow task that contains the data flow with the component whose properties you want to view and modify.

  4. Fare doppio clic sul componente del flusso di dati.Double-click the data flow component.

  5. Nell'editor del componente visualizzare o modificare i valori delle proprietà e quindi chiudere l'editor.In the component editor, view or modify the property values, and then close the editor.

  6. Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.To save the updated package, on the File menu, click Save Selected Items.

Impostare le proprietà di un componente del flusso di dati nella finestra proprietàSet the properties of a data flow component in the Properties window

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want.

  2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.In Solution Explorer, double-click the package to open it.

  3. Fare clic sulla scheda Flusso di controllo , quindi fare doppio clic sull'attività Flusso di dati che contiene il componente di cui si desidera visualizzare e modificare le proprietà.Click the Control Flow tab, and then double-click the Data Flow task that contains the component whose properties you want to view and modify.

  4. Fare clic con il pulsante destro del mouse sul componente flusso di dati, quindi scegliere Proprietà.Right-click the data flow component, and then click Properties.

  5. Visualizzare o modificare i valori delle proprietà, quindi chiudere la finestra Proprietà .View or modify the property values, and then close the Properties window.

    Nota

    Molte proprietà sono in sola lettura e non possono essere modificate.Many properties are read-only, and cannot be modified.

  6. Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.To save the updated package, on the File menu, click Save Selected Items.

Impostare le proprietà di un componente del flusso di dati con l'Editor avanzatoSet the properties of a data flow component with the Advanced Editor

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want.

  2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.In Solution Explorer, double-click the package to open it.

  3. Fare clic sulla scheda Flusso di controllo , quindi fare doppio clic sull'attività Flusso di dati che contiene il componente che si desidera visualizzare o modificare.Click the Control Flow tab, and then double-click the Data Flow task that contains the component you want to view or modify.

  4. Nella finestra di progettazione del flusso di dati fare clic con il pulsante destro del mouse sul componente flusso di dati, quindi scegliere Visualizza editor avanzato.In the data flow designer, right-click the data flow component, and then click Show Advanced Editor.

    Nota

    In SQL ServerSQL Servernon è possibile utilizzare la finestra di dialogo Editor avanzatoper i componenti flusso di dati che supportano più input.In SQL ServerSQL Server, data flow components that support multiple inputs cannot use the Advanced Editor.

  5. Nella finestra di dialogo Editor avanzato eseguire una delle operazioni seguenti:In the Advanced Editor dialog box, do any of the following steps:

    • Fare clic sulla scheda Gestioni connessioni per visualizzare e specificare la connessione usata dal componente.To view and specify the connection that the component uses, click the Connection Managers tab.

      Nota

      La scheda Gestioni connessioni è disponibile solo per i componenti flusso di dati che utilizzano gestioni connessioni per connettersi a origini dati quali file e database.The Connection Managers tab is available only to data flow components that use connection managers to connect to data sources such as files and databases

    • Fare clic sulla scheda Proprietà componente per visualizzare e modificare le proprietà a livello di componente.To view and modify component-level properties, click the Component Properties tab.

    • Fare clic sulla scheda Mapping colonne per visualizzare e modificare i mapping tra le colonne esterne e l'output disponibile.To view and modify mappings between external columns and the available output, click the Column Mappings tab.

      Nota

      La scheda Mapping colonne è disponibile solo durante la visualizzazione o la modifica di origini o destinazioni.The Column Mappings tab is available only when viewing or editing sources or destinations.

    • Per visualizzare un elenco delle colonne di input disponibili e aggiornare i nomi delle colonne di output, fare clic sulla scheda Colonne di input .To view a list of the available input columns and to update the names of output columns, click the Input Columns tab.

      Nota

      La scheda Colonne di input è disponibile solo quando si utilizzano trasformazioni o destinazioni.The Input Columns tab is available only when working with transformations or destinations. Per altre informazioni, vedere Trasformazioni di Integration Services.For more information, see Integration Services Transformations.

    • Fare clic sulla scheda Proprietà input e output per visualizzare e modificare le proprietà degli input, degli output e degli output degli errori, nonché le proprietà delle colonne che contengono.To view and modify the properties of inputs, outputs, and error outputs, and the properties of the columns they contain, click the Input and Output Properties tab.

      Nota

      Le origini non includono input,Sources have no inputs. mentre le destinazioni non includono output, ad eccezione di un output degli errori facoltativo.Destinations have no outputs, except for an optional error output.

  6. Visualizzare o modificare i valori delle proprietà.View or modify the property values.

  7. Scegliere OK.Click OK.

  8. Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.To save the updated package, on the File menu, click Save Selected Items.

Proprietà comuni di componenti flusso di datiCommon properties of data flow components

Gli oggetti del flusso di dati nel modello a oggetti MicrosoftMicrosoft SQL ServerSQL Server Integration ServicesIntegration Services hanno proprietà comuni e proprietà personalizzate a livello di componente, input e output, colonne di input e colonne di output.The data flow objects in the MicrosoftMicrosoft SQL ServerSQL Server Integration ServicesIntegration Services object model have common properties and custom properties at the component, input and output, and input column and output column levels. Molte proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Many properties have read-only values that are assigned at run time by the data flow engine.

In questo argomento vengono elencate e descritte le proprietà comuni degli oggetti del flusso di dati.This topic lists and describes the common properties of data flow objects.

Component properties Component properties

Nel modello a oggetti Integration ServicesIntegration Services un componente nel flusso di dati implementa l'interfaccia IDTSComponentMetaData100.In the Integration ServicesIntegration Services object model, a component in the data flow implements the IDTSComponentMetaData100 interface.

Nella tabella seguente vengono descritte le proprietà dei componenti in un flusso di dati.The following table describes the properties of the components in a data flow. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Some properties have read-only values that are assigned at run time by the data flow engine.

ProprietàProperty Tipo di datiData Type DescriptionDescription
ComponentClassIDComponentClassID StringString Valore CLSID del componente.The CLSID of the component.
ContactInfoContactInfo StringString Informazioni di contatto dello sviluppatore di un componente.Contact information for the developer of a component.
DescriptionDescription StringString Descrizione del componente flusso di dati.The description of the data flow component. Il valore predefinito di questa proprietà è il nome del componente flusso di dati.The default value of this property is the name of the data flow component.
IDID Valore interoInteger Valore che identifica in modo univoco questa istanza del componente.A value that uniquely identifies this instance of the component.
IdentificationStringIdentificationString StringString Identifica il componente.Identifies the component.
IsDefaultLocaleIsDefaultLocale BooleanBoolean Indica se il componente utilizza le impostazioni locali dell'attività Flusso di dati alla quale appartiene.Indicates whether the component uses the locale of the Data Flow task to which it belongs.
LocaleIDLocaleID Valore interoInteger Impostazioni locali che il componente flusso di dati utilizza durante l'esecuzione del pacchetto.The locale that the data flow component uses when the package runs. Tutte le impostazioni locali di Windows sono disponibili per l'utilizzo nei componenti flusso di dati.All Windows locales are available for use in data flow components.
NomeName StringString Nome del componente del flusso di dati.The name of the data flow component.
PipelineVersionPipelineVersion Valore interoInteger Versione dell'attività Flusso di dati nella quale il componente è progettato per l'esecuzione.The version of the data flow task within which a component is designed to execute.
UsesDispositionsUsesDispositions BooleanBoolean Indica se un componente ha un output degli errori.Indicates whether a component has an error output.
ValidateExternalMetadataValidateExternalMetadata BooleanBoolean Indica se i metadati delle colonne esterne sono convalidati.Indicates whether the metadata of external columns is validated. Il valore predefinito di questa proprietà è True.The default value of this property is True.
VersionVersion Valore interoInteger Versione di un componente.The version of a component.

Proprietà di input Input properties

Nel modello a oggetti Integration ServicesIntegration Services , le trasformazioni e le destinazioni includono input.In the Integration ServicesIntegration Services object model, transformations and destinations have inputs. L'input di un componente nel flusso di dati implementa l'interfaccia IDTSInput100.An input of a component in the data flow implements the IDTSInput100 interface.

Nella tabella seguente vengono descritte le proprietà degli input dei componenti in un flusso di dati.The following table describes the properties of the inputs of components in a data flow. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Some properties have read-only values that are assigned at run time by the data flow engine.

ProprietàProperty Tipo di datiData Type DescriptionDescription
DescriptionDescription StringString Descrizione dell'input.The description of the input.
ErrorOrTruncationOperationErrorOrTruncationOperation StringString Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.An optional string that specifies the types of errors or truncations that can occur when processing a row.
ErrorRowDispositionErrorRowDisposition DTSRowDisposition Valore che specifica la gestione degli errori.A value that specifies the handling of errors. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row.
HasSideEffectsHasSideEffects BooleanBoolean Indica se un componente può essere rimosso dal piano di esecuzione del flusso di dati se non è collegato a un componente a valle e se la proprietà RunInOptimizedMode è impostata su true.Indicates whether a component can be removed from the execution plan of the data flow when it is not attached to a downstream component and when RunInOptimizedMode is true.
IDID Valore interoInteger Valore che identifica l'input in modo univoco.A value that uniquely identifies the input.
IdentificationStringIdentificationString StringString Stringa che identifica l'input.A string that identifies the input.
IsSortedIsSorted BooleanBoolean Indica se i dati nell'input sono ordinati.Indicates whether the data in the input is sorted.
NomeName StringString Nome dell'input.The name of the input.
SourceLocaleSourceLocale Valore interoInteger ID delle impostazioni locali (LCID) dei dati di input.The locale ID (LCID) of the input data.
TruncationRowDispositionTruncationRowDisposition DTSRowDisposition Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe.A value that determines how the component handles truncations that occur when processing rows. .. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row.

Le destinazioni e alcune trasformazioni non supportano gli output degli errori e le proprietà ErrorRowDisposition e TruncationRowDisposition di questi componenti sono di sola lettura.Destinations and some transformations do not support error outputs, and the ErrorRowDisposition and TruncationRowDisposition properties of these components are read-only.

Proprietà delle colonne di input Input column properties

Nel modello a oggetti Integration ServicesIntegration Services , un input contiene una raccolta di colonne di input.In the Integration ServicesIntegration Services object model, an input contains a collection of input columns. Una colonna di input di un componente nel flusso di dati implementa l'interfaccia IDTSInputColumn100.An input column of a component in the data flow implements the IDTSInputColumn100 interface.

Nella tabella seguente vengono descritte le proprietà delle colonne di input dei componenti in un flusso di dati.The following table describes the properties of the input columns of components in a data flow. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Some properties have read-only values that are assigned at run time by the data flow engine.

ProprietàProperty Tipo di datiData Type DescriptionDescription
ComparisonFlagsComparisonFlags Valore interoInteger Set di flag che specificano il confronto di colonne che hanno un tipo di dati character.A set of flags that specify the comparison of columns that have a character data type. Per altre informazioni, vedere Comparing String Data.For more information, see Comparing String Data.
DescriptionDescription StringString Descrive la colonna di input.Describes the input column.
ErrorOrTruncationOperationErrorOrTruncationOperation StringString Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.An optional string that specifies the types of errors or truncations that can occur when processing a row.
ErrorRowDispositionErrorRowDisposition DTSRowDisposition Valore che specifica la gestione degli errori.A value that specifies the handling of errors. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row.
ExternalMetadataColumnIDExternalMetadataColumnID IDTSExternalMetadataColumn100 ID della colonna di metadati esterna assegnato a una colonna di input.The ID of the external metadata column assigned to an input column.
IDID Valore interoInteger Valore che identifica la colonna di input in modo univoco.A value that uniquely identifies the input column.
IdentificationStringIdentificationString StringString Stringa che identifica la colonna di input.A string that identifies the input column.
LineageIDLineageID Valore interoInteger ID della colonna a monte.The ID of the upstream column.
LineageIdentificationStringLineageIdentificationString StringString Stringa di identificazione che include il nome della colonna a monte.The identification string which includes the name of the upstream column.
NomeName StringString Nome della colonna di input.The name of the input column.
SortKeyPositionSortKeyPosition Valore interoInteger Valore che indica se una colonna è ordinata, l'ordinamento e la sequenza di ordinamento di più colonne.A value that indicates whether a column is sorted, its sort order, and the sequence in which multiple columns are sorted. Il valore 0 indica che la colonna non è ordinata.The value 0 indicates the column is not sorted. Per altre informazioni, vedere Ordinare i dati per le trasformazioni Unione e Merge join.For more information, see Sort Data for the Merge and Merge Join Transformations.
TruncationRowDispositionTruncationRowDisposition DTSRowDisposition Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe.A value that determines how the component handles truncations that occur when processing rows. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row.
UpstreamComponentNameUpstreamComponentName StringString Nome del componente a monte.The name of the upstream component.
UsageTypeUsageType DTSUsageType Valore che determina come una colonna di input viene utilizzata dal componente.A value that determines how an input column is used by the component.

Le colonne di input includono anche le proprietà del tipo di dati descritte in "Proprietà del tipo di dati".Input columns also have the data type properties described under "Data Type Properties."

Proprietà di output Output properties

Nel modello a oggetti Integration ServicesIntegration Services , le origini e le trasformazioni includono output.In the Integration ServicesIntegration Services object model, sources and transformations have outputs. L'output di un componente nel flusso di dati implementa l'interfaccia IDTSOutput100.An output of a component in the data flow implements the IDTSOutput100 interface.

Nella tabella seguente vengono descritte le proprietà degli output dei componenti in un flusso di dati.The following table describes the properties of the outputs of components in a data flow. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Some properties have read-only values that are assigned at run time by the data flow engine.

ProprietàProperty Tipo di datiData Type DescriptionDescription
DeleteOutputOnPathDetachedDeleteOutputOnPathDetached BooleanBoolean Valore che determina se il motore del flusso di dati elimina l'output quando viene scollegato da un percorso.A value that determines whether the data flow engine deletes the output when it is detached from a path.
DescriptionDescription StringString Descrive l'output.Describes the output.
ErrorOrTruncationOperationErrorOrTruncationOperation StringString Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.An optional string that specifies the types of errors or truncations that can occur when processing a row.
ErrorRowDispositionErrorRowDisposition DTSRowDisposition Valore che specifica la gestione degli errori.A value that specifies the handling of errors. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row.
ExclusionGroupExclusionGroup Valore interoInteger Valore che identifica un gruppo di output che si escludono a vicenda.A value that identifies a group of mutually exclusive outputs.
HasSideEffectsHasSideEffects BooleanBoolean Valore che indica se un componente può essere rimosso dal piano di esecuzione del flusso di dati se non è collegato a un componente a monte e se la proprietà RunInOptimizedMode è impostata su true.A value that indicates whether a component can be removed from the execution plan of the data flow when it is not attached to an upstream component and when RunInOptimizedMode is true.
IDID Valore interoInteger Valore che identifica l'output in modo univoco.A value that uniquely identifies the output.
IdentificationStringIdentificationString StringString Stringa che identifica l'output.A string that identifies the output.
IsErrorOutIsErrorOut BooleanBoolean Indica se l'output è un output degli errori.Indicates whether the output is an error output.
IsSortedIsSorted BooleanBoolean Indica se l'output è ordinato.Indicates whether the output is sorted. Il valore predefinito è False.The default value is False.

**Importante * * ** impostando il valore della **IsSorted proprietà True non consente di ordinare i dati.** Important *\* Setting the value of the IsSorted property to True does not sort the data. Questa proprietà fornisce solo un hint ai componenti a valle in relazione all'ordinamento precedente dei dati.This property only provides a hint to downstream components that the data has been previously sorted. Per altre informazioni, vedere Ordinare i dati per le trasformazioni Unione e Merge join.For more information, see Sort Data for the Merge and Merge Join Transformations.
NomeName StringString Nome dell'output.The name of the output.
SynchronousInputIDSynchronousInputID Valore interoInteger ID di un input sincrono all'output.The ID of an input that is synchronous to the output.
TruncationRowDispositionTruncationRowDisposition DTSRowDisposition Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe.A value that determines how the component handles truncations that occur when processing rows. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row.

Proprietà colonna di output Output column properties

Nel modello a oggetti Integration ServicesIntegration Services , un output contiene una raccolta di colonne di output.In the Integration ServicesIntegration Services object model, an output contains a collection of output columns. Una colonna di output di un componente nel flusso di dati implementa l'interfaccia IDTSOutputColumn100.An output column of a component in the data flow implements the IDTSOutputColumn100 interface.

Nella tabella seguente vengono descritte le proprietà delle colonne di output dei componenti in un flusso di dati.The following table describes the properties of the output columns of components in a data flow. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Some properties have read-only values that are assigned at run time by the data flow engine.

ProprietàProperty Tipo di datiData Type DescriptionDescription
ComparisonFlagsComparisonFlags Valore interoInteger Set di flag che specificano il confronto di colonne che hanno un tipo di dati character.A set of flags that specify the comparison of columns that have a character data type. Per altre informazioni, vedere Comparing String Data.For more information, see Comparing String Data.
DescriptionDescription StringString Descrive la colonna di output.Describes the output column.
ErrorOrTruncationOperationErrorOrTruncationOperation StringString Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.An optional string that specifies the types of errors or truncations that can occur when processing a row.
ErrorRowDispositionErrorRowDisposition DTSRowDisposition Valore che specifica la gestione degli errori.A value that specifies the handling of errors. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row. Il valore predefinito è Interrompi componente.The default value is Fail component.
ExternalMetadataColumnIDExternalMetadataColumnID Valore interoInteger ID della colonna di metadati esterna assegnato a una colonna di input.The ID of the external metadata column assigned to an input column.
IDID Valore interoInteger Valore che identifica la colonna di output in modo univoco.A value that uniquely identifies the output column.
IdentificationStringIdentificationString StringString Stringa che identifica la colonna di output.A string that identifies the output column.
LineageIDLineageID Valore interoInteger ID della colonna di output.The ID of the output column. I componenti a valle fanno riferimento alla colonna utilizzando questo valore.Downstream components refer to the column by using this value.
LineageIdentificationStringLineageIdentificationString StringString Stringa di identificazione che include il nome della colonna.The identification string which includes the name of the column.
NomeName StringString Nome della colonna di output.The name of the output column.
SortKeyPositionSortKeyPosition Valore interoInteger Valore che indica se una colonna è ordinata, l'ordinamento e la sequenza di ordinamento di più colonne.A value that indicates whether a column is sorted, its sort order, and the sequence in which multiple columns are sorted. Il valore 0 indica che la colonna non è ordinata.The value 0 indicates the column is not sorted. Per altre informazioni, vedere Ordinare i dati per le trasformazioni Unione e Merge join.For more information, see Sort Data for the Merge and Merge Join Transformations.
SpecialFlagsSpecialFlags Valore interoInteger Valore che contiene i flag speciali della colonna di output.A value that contains the special flags of the output column.
TruncationRowDispositionTruncationRowDisposition DTSRowDisposition Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe.A value that determines how the component handles truncations that occur when processing rows. I valori sono Interrompi componente, Ignora erroree Reindirizza riga.The values are Fail component, Ignore failure, and Redirect row. Il valore predefinito è Interrompi componente.The default value is Fail component.

Le colonne di output includono anche un set di proprietà del tipo di dati.Output columns also include a set of data type properties.

Proprietà colonne di metadati esterniExternal metadata column properties

Nel modello a oggetti Integration ServicesIntegration Services , input e output possono contenere un insieme di colonne di metadati esterne.In the Integration ServicesIntegration Services object model, inputs and outputs can contain a collection of external metadata columns. Una colonna di metadati esterna di un componente nel flusso di dati implementa l'interfaccia IDTSExternalMetadataColumn100.An external metadata column of a component in the data flow implements the IDTSExternalMetadataColumn100 interface.

Nella tabella seguente vengono descritte le proprietà delle colonne di metadati esterne dei componenti in un flusso di dati.The following table describes the properties of the external metadata columns of components in a data flow. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Some properties have read-only values that are assigned at run time by the data flow engine.

ProprietàProperty Tipo di datiData Type DescriptionDescription
DescriptionDescription StringString Descrive la colonna esterna.Describes the external column.
IDID Valore interoInteger Valore che identifica la colonna in modo univoco.A value that uniquely identifies the column.
IdentificationStringIdentificationString StringString Stringa che identifica la colonna.A string that identifies the column.
NomeName StringString Nome della colonna esterna.The name of the external column.

Le colonne di metadati esterne includono anche un set di proprietà del tipo di dati.External metadata columns also include a set of data type properties.

Proprietà del tipo di datiData type properties

Le colonne di metadati esterne e le colonne di output includono anche un set di proprietà del tipo di dati.Output columns and external metadata columns include a set of data type properties. A seconda del tipo di dati della colonna, le proprietà possono essere di lettura/scrittura o di sola lettura.Depending on the data type of the column, properties can be read/write or read-only.

Nella tabella seguente vengono descritte le proprietà del tipo di dati delle colonne di metadati esterne e delle colonne di output.The following table describes the data type properties of output columns and external metadata columns.

ProprietàProperty Tipo di datiData Type DescriptionDescription
CodePageCodePage Valore interoInteger Specifica la tabella codici per i dati stringa non Unicode.Specifies the code page for string data that is not Unicode.
DataTypeDataType Integer (enumerazione)Integer (enumeration) Tipo di dati Integration ServicesIntegration Services della colonna.The Integration ServicesIntegration Services data type of the column. Per altre informazioni, vedere Tipi di dati di Integration Services.For more information, see Integration Services Data Types.
LunghezzaLength Valore interoInteger Lunghezza della colonna in caratteri.The length, measured in characters, of a column.
PrecisionePrecision Valore interoInteger Precisione di una colonna numerica.The precision of a numeric column.
ScalaScale Valore interoInteger Scala di una colonna numerica.The scale of a numeric column.

Proprietà personalizzate dei componenti del flusso di datiCustom properties of data flow components

Per informazioni sulle proprietà personalizzate, vedere gli argomenti seguentiFor information about custom properties, see the following topics

Utilizzare un'espressione in un componente del flusso di datiUse an expression in a data flow component

In questo argomento viene descritta la procedura per l'aggiunta di un'espressione nella trasformazione Suddivisione condizionale o Colonna derivata.This procedure describes how to add an expression to the Conditional Split transformation or to the Derived Column transformation. La trasformazione Suddivisione condizionale utilizza espressioni per definire le condizioni che dirigono le righe di dati all'output della trasformazione, mentre la trasformazione Colonna derivata utilizza espressioni per definire i valori assegnati alle colonne.The Conditional Split transformation uses expressions to define the conditions that direct data rows to a transformation output, and the Derived Column transformation uses expressions to define values assigned to columns.

Per implementare un'espressione in una trasformazione, è necessario che il pacchetto includa almeno un'attività Flusso di dati e un'origine.To implement an expression in a transformation, the package must already include at least one Data Flow task and a source.

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want.

  2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.In Solution Explorer, double-click the package to open it.

  3. In Progettazione SSISSSIS fare clic sulla scheda Flusso di controllo e quindi sull'attività Flusso di dati contenente il flusso di dati in cui si vuole implementare un'espressione.In SSISSSIS Designer, click the Control Flow tab, and then click the Data Flow task that contains the data flow in which you want to implement an expression.

  4. Fare clic sulla scheda Flusso di dati e trascinare una trasformazione Suddivisione condizionale o Colonna derivata dalla casella degli strumenti all'area di progettazione.Click the Data Flow tab, and drag either a Conditional Split or Derived Column transformation from the Toolbox to the design surface.

  5. Trascinare il connettore verde dall'origine o trasformazione alla trasformazione Suddivisione condizionale o Colonna derivata.Drag the green connector from the source or a transformation to the Conditional Split or Derived Column transformation.

  6. Fare doppio clic sulla trasformazione. Verrà visualizzata la finestra di dialogo corrispondente.Double-click the transformation to open its dialog box.

  7. Nel riquadro di sinistra espandere il nodo Variabili in modo da visualizzare le variabili definite dall'utente e di sistema. Espandere anche il nodo Colonne in modo da visualizzare le colonne di input della trasformazione.In the left pane, expand Variables to display system and user-defined variables, and expand Columns to display the transformation input columns.

  8. Nel riquadro di destra espandere i nodi Funzioni matematiche, Funzioni per i valori stringa, Funzioni di data/ora, Funzioni NULL, Cast di tipoe Operatori per accedere alle funzioni, ai cast e agli operatori del linguaggio delle espressioni.In the right pane, expand Mathematical Functions, String Functions, Date/Time Functions, NULL Functions, Type Casts, and Operators to access the functions, the casts, and the operators that the expression grammar provides.

  9. A seconda della trasformazione, compilare un'espressione in uno dei modi seguenti:Depending on the transformation, do one of the following to build an expression:

    • Nella finestra di dialogo Editor trasformazione Suddivisione condizionale trascinare variabili, colonne, funzioni, operatori e cast nella colonna Condizione .In the Conditional Split Transformation Editor dialog box, drag variables, columns, functions, operators, and casts to the Condition column. In alternativa, è possibile digitare l'espressione direttamente nella colonna Condizione .Alternatively, you can type an expression directly in the Condition column.

    • Nella finestra di dialogo Editor trasformazione Colonna derivata trascinare variabili, colonne, funzioni, operatori e cast nella colonna Espressione .In the Derived Column Transformation Editor dialog box, drag variables, columns, functions, operators, and casts to the Expression column. In alternativa, è possibile digitare l'espressione direttamente nella colonna Espressione .Alternatively, you can type an expression directly in the Expression column.

      Nota

      Quando lo stato attivo viene rimosso dalla colonna Condizione o Espressione , il testo dell'espressione potrebbe essere evidenziato per indicare che la sintassi dell'espressione non è corretta.When you remove the focus from the Condition column or the Expression column, the expression text might be highlighted to indicate that the expression syntax is incorrect.

  10. Fare clic su OK per chiudere la finestra di dialogo.Click OK to exit the dialog box.

    Nota

    Se l'espressione non è valida, viene visualizzato un avviso che evidenzia gli errori di sintassi.If the expression is not valid, an alert appears describing the syntax errors in the expression.

Proprietà del flusso di dati che è possibile impostare con un'espressioneData flow properties that you can set with an expression

I valori di determinate proprietà di oggetti del flusso di dati possono essere specificati utilizzando espressioni di proprietà disponibili nel contenitore dell'attività Flusso di dati.The values of certain properties of data flow objects can be specified by using property expressions available on the Data Flow task container.

Per informazioni sull'utilizzo delle espressioni di proprietà, vedere utilizzo delle espressioni di proprietà nei pacchetti.For information about using property expressions, see Use Property Expressions in Packages.

È possibile utilizzare espressioni di proprietà per personalizzare la configurazione di ogni istanza di pacchetto distribuita.You can use property expressions to customize configurations for each deployed instance of a package. È anche possibile usare espressioni di proprietà per specificare i vincoli in fase di esecuzione per un pacchetto tramite l'opzione /set con l'utilità del prompt dei comandi dtexec .You can also use property expressions to specify run-time constraints for a package by using the /set option with the dtexec command prompt utility. Ad esempio, è possibile vincolare il MaximumThreads usato dalla trasformazione dell'ordinamento o il MaxMemoryUsage delle trasformazioni del raggruppamento fuzzy e della ricerca fuzzy.For example, you can constrain the MaximumThreads used by the Sort transformation, or the MaxMemoryUsage of the Fuzzy Grouping and Fuzzy Lookup transformations. Se non vincolate, queste trasformazioni possono memorizzare nella cache grandi quantità di dati.If unconstrained, these transformations may cache large amounts of data in memory.

Per specificare un'espressione di proprietà per una delle proprietà degli oggetti del flusso di dati elencate in questo argomento, visualizzare la finestra Proprietà per l'attività flusso di dati selezionando l'attività flusso di dati nell'area di progettazione Flusso di controllo o selezionando la scheda Flusso di dati della finestra di progettazione senza selezionare componenti o percorsi singoli.To specify a property expression for one of the properties of data flow objects listed in this topic, display the Properties window for the Data Flow task by selecting the Data Flow task on the Control Flow surface of the designer, or by selecting the Data Flow tab of the designer without selecting any individual component or path. Selezionare la proprietà Espressioni e fare clic sui puntini di sospensione per visualizzare la finestra di dialogo Editor espressioni di proprietà .Select the Expressions property and click the ellipsis (...) to display the Property Expressions Editor dialog box. Visualizzare l'elenco a discesa Proprietà per selezionare una proprietà, quindi digitare un'espressione nella casella di testo Espressione o fare clic sui puntini di sospensione per visualizzare la finestra di dialogo Generatore di espressioni .Drop down the Property list to select a property, then type an expression in the Expression text box, or click the ellipsis (...) to display the Expression Builder dialog box.

Nell'elenco Proprietà vengono visualizzate le proprietà disponibili per gli oggetti del flusso di dati già posizionati nell'area di progettazione Flusso di dati .The Property list displays available properties for only those data flow objects that you have already placed on the Data Flow surface of the designer. Pertanto, non è possibile usare l'elenco Proprietà per visualizzare tutte le possibili proprietà degli oggetti del flusso di dati che supportano le espressioni di proprietà.Therefore, you cannot use the Property list to view all the possible properties of data flow objects that support property expressions. Ad esempio, se è stata posizionata un'origine ADO NET nell'area di progettazione, l'elenco Proprietà contiene una voce per la proprietà [ADO NET Source].[SqlCommand] .For example, if you have placed an ADO NET source on the designer surface, the Property list contains an entry for the [ADO NET Source].[SqlCommand] property. Nell'elenco vengono anche visualizzate molte proprietà dell'attività Flusso di dati.The list also displays many properties of the Data Flow task itself.

È possibile specificare i valori delle proprietà del seguente elenco utilizzando le espressioni di proprietà.The values of the properties in the following list can be specified by using property expressions.

Origini flusso di datiData flow sources

Oggetto del flusso di datiData Flow object ProprietàProperty
Origine ADO NETADO NET source Proprietà TableOrViewNameTableOrViewName property

Proprietà SqlCommandSqlCommand property
Origine XMLXML source Proprietà XMLDataXMLData property

Proprietà XMLSchemaDefinitionXMLSchemaDefinition property

Trasformazioni del flusso di datiData flow transformations

Per altre informazioni su queste proprietà personalizzate, vedere proprietà personalizzate della trasformazione.For more information about these custom properties, see Transformation Custom Properties.

Oggetto del flusso di datiData Flow object ProprietàProperty
Suddivisione condizionale - trasformazioneConditional Split transformation Proprietà FriendlyExpressionFriendlyExpression property
Trasformazione Colonna derivataDerived Column transformation Proprietà FriendlyExpressionFriendlyExpression property
Raggruppamento fuzzy - trasformazioneFuzzy Grouping transformation Proprietà MaxMemoryUsageMaxMemoryUsage property
Ricerca fuzzy - trasformazioneFuzzy Lookup transformation Proprietà MaxMemoryUsageMaxMemoryUsage property
Trasformazione RicercaLookup transformation Proprietà SqlCommandSqlCommand property

Proprietà SqlCommandParamSqlCommandParam property
Comando OLE DB - trasformazioneOLE DB Command transformation Proprietà SqlCommandSqlCommand property
Campionamento percentuale - trasformazionePercentage Sampling transformation Proprietà SamplingValueSamplingValue property
Pivot - trasformazionePivot transformation Proprietà PivotKeyValuePivotKeyValue property
Campionamento righe - trasformazioneRow Sampling transformation Proprietà SamplingValueSamplingValue property
Ordinamento - trasformazioneSort transformation Proprietà MaximumThreadsMaximumThreads property
UnPivot - trasformazioneUnpivot transformation Proprietà PivotKeyValuePivotKeyValue property

Destinazioni flusso di datiData flow destinations

Oggetto del flusso di datiData Flow object ProprietàProperty
Destinazione ADO NETADO NET Destination Proprietà TableOrViewNameTableOrViewName property

Proprietà BatchSizeBatchSize property

Proprietà CommandTimeoutCommandTimeout property
file flat - destinazioneFlat File destination Proprietà dell'intestazioneHeader property
SQL ServerSQL ServerDestinazione Compact Compact destination Proprietà TableNameTableName property
SQL ServerSQL Serverdestinazione destination Proprietà BulkInsertTableNameBulkInsertTableName property

Proprietà BulkInsertFirstRowBulkInsertFirstRow property

Proprietà BulkInsertLastRowBulkInsertLastRow property

Proprietà BulkInsertOrderBulkInsertOrder property

Proprietà TimeoutTimeout property