Condividi tramite


Proprietà comuni

Gli oggetti del flusso di dati nel modello di oggetti Microsoft SQL Server Integration Services hanno proprietà comuni e proprietà personalizzate a livello di componente, input e output, colonne di input e colonne di output. Molte proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

In questo argomento vengono elencate e descritte le proprietà comuni degli oggetti del flusso di dati.

  • Componenti

  • Input

  • Colonne di input

  • Output

  • Colonne di output

Proprietà dei componenti

Nel modello di oggetti Integration Services un componente nel flusso di dati implementa l'interfaccia IDTSComponentMetaData100.

Nella tabella seguente vengono descritte le proprietà dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

Proprietà

Tipo di dati

Descrizione

ComponentClassID

String

Valore CLSID del componente.

ContactInfo

String

Informazioni di contatto dello sviluppatore di un componente.

Description

String

Descrizione del componente del flusso di dati. Il valore predefinito di questa proprietà è il nome del componente del flusso di dati.

ID

Integer

Valore che identifica in modo univoco questa istanza del componente.

IdentificationString

String

Identifica il componente.

IsDefaultLocale

Boolean

Indica se il componente utilizza le impostazioni locali dell'attività Flusso di dati alla quale appartiene.

LocaleID

Integer

Impostazioni locali che il componente del flusso di dati utilizza durante l'esecuzione del pacchetto. Tutte le impostazioni locali di Windows sono disponibili per l'utilizzo nei componenti del flusso di dati.

Name

String

Nome del componente del flusso di dati.

PipelineVersion

Integer

Versione dell'attività Flusso di dati nella quale il componente è progettato per l'esecuzione.

UsesDispositions

Boolean

Indica se un componente ha un output degli errori.

ValidateExternalMetadata

Boolean

Indica se i metadati delle colonne esterne sono convalidati. Il valore predefinito di questa proprietà è True.

Version

Integer

Versione di un componente.

Proprietà degli input

Nel modello di oggetti Integration Services, le trasformazioni e le destinazioni includono input. L'input di un componente nel flusso di dati implementa l'interfaccia IDTSInput100.

Nella tabella seguente vengono descritte le proprietà degli input dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

Proprietà

Tipo di dati

Descrizione

Description

String

Descrizione dell'input.

ErrorOrTruncationOperation

String

Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.

ErrorRowDisposition

DTSRowDisposition

Valore che specifica la gestione degli errori. I possibili valori sono Fail component, Ignore failure e Redirect row.

HasSideEffects

Boolean

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.

ID

Integer

Valore che identifica l'input in modo univoco.

IdentificationString

String

Stringa che identifica l'input.

IsSorted

Boolean

Indica se i dati nell'input sono ordinati.

Name

String

Nome dell'input.

SourceLocale

Integer

ID delle impostazioni locali (LCID) dei dati di input.

TruncationRowDisposition

DTSRowDisposition

Valore che determina la modalità di gestione da parte del componente dei troncamenti che si verificano durante l'elaborazione delle righe. . I possibili valori sono Fail component, Ignore failure e 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.

Proprietà delle colonne di input

Nel modello di oggetti Integration Services, un input contiene una raccolta di colonne di input. Una colonna di input di un componente nel flusso di dati implementa l'interfaccia IDTSInputColumn100.

Nella tabella seguente vengono descritte le proprietà delle colonne di input dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

Proprietà

Tipo di dati

Descrizione

ComparisonFlags

Integer

Insieme di flag che specificano il confronto di colonne che hanno un tipo di dati character. Per ulteriori informazioni, vedere Confronto di dati stringa.

Description

String

Descrive la colonna di input.

ErrorOrTruncationOperation

String

Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.

ErrorRowDisposition

DTSRowDisposition

Valore che specifica la gestione degli errori. I possibili valori sono Fail component, Ignore failure e Redirect row.

ExternalMetadataColumnID

IDTSExternalMetadataColumn100

ID della colonna di metadati esterna assegnato a una colonna di input.

ID

Integer

Valore che identifica la colonna di input in modo univoco.

IdentificationString

String

Stringa che identifica la colonna di input.

LineageID

Integer

ID della colonna a monte.

Name

String

Nome della colonna di input.

SortKeyPosition

Integer

Valore che indica se una colonna è ordinata, l'ordinamento e la sequenza di ordinamento di più colonne. Il valore 0 indica che la colonna non è ordinata. Per ulteriori informazioni, vedere Procedura: Ordinamento dei dati per le trasformazioni Unione e Merge Join.

TruncationRowDisposition

DTSRowDisposition

Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I possibili valori sono Fail component, Ignore failure e Redirect row.

UpstreamComponentName

String

Nome del componente a monte.

UsageType

DTSUsageType

Valore che determina come una colonna di input viene utilizzata dal componente.

Le colonne di input includono anche le proprietà del tipo di dati descritte in "Proprietà del tipo di dati".

Proprietà degli output

Nel modello di oggetti Integration Services, le origini e le trasformazioni includono output. L'output di un componente nel flusso di dati implementa l'interfaccia IDTSOutput100.

Nella tabella seguente vengono descritte le proprietà degli output dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

Proprietà

Tipo di dati

Descrizione

DeleteOutputOnPathDetached

Boolean

Valore che determina se il motore del flusso di dati elimina l'output quando viene scollegato da un percorso.

Description

String

Descrive l'output.

ErrorOrTruncationOperation

String

Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.

ErrorRowDisposition

DTSRowDisposition

Valore che specifica la gestione degli errori. I possibili valori sono Fail component, Ignore failure e Redirect row.

ExclusionGroup

Integer

Valore che identifica un gruppo di output che si escludono a vicenda.

HasSideEffects

Boolean

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.

ID

Integer

Valore che identifica l'output in modo univoco.

IdentificationString

String

Stringa che identifica l'output.

IsErrorOut

Boolean

Indica se l'output è un output degli errori.

IsSorted

Boolean

Indica se l'output è ordinato. Il valore predefinito è False.

Nota importanteImportante
L'impostazione del valore della proprietà IsSorted su True non determina l'ordinamento dei dati. Questa proprietà fornisce solo un hint ai componenti a valle in relazione all'ordinamento precedente dei dati. Per ulteriori informazioni, vedere Procedura: Ordinamento dei dati per le trasformazioni Unione e Merge Join.

Name

String

Nome dell'output.

SynchronousInputID

Integer

ID di un input sincrono all'output.

TruncationRowDisposition

DTSRowDisposition

Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I possibili valori sono Fail component, Ignore failure e Redirect row.

Proprietà delle colonne di output

Nel modello di oggetti Integration Services, un output contiene una raccolta di colonne di output. Una colonna di output di un componente nel flusso di dati implementa l'interfaccia IDTSOutputColumn100.

Nella tabella seguente vengono descritte le proprietà delle colonne di output dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

Proprietà

Tipo di dati

Descrizione

ComparisonFlags

Integer

Insieme di flag che specificano il confronto di colonne che hanno un tipo di dati character. Per ulteriori informazioni, vedere Confronto di dati stringa.

Description

String

Descrive la colonna di output.

ErrorOrTruncationOperation

String

Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga.

ErrorRowDisposition

DTSRowDisposition

Valore che specifica la gestione degli errori. I possibili valori sono Fail component, Ignore failure e Redirect row. Il valore predefinito è Interrompi componente.

ExternalMetadataColumnID

Integer

ID della colonna di metadati esterna assegnato a una colonna di input.

ID

Integer

Valore che identifica la colonna di output in modo univoco.

IdentificationString

String

Stringa che identifica la colonna di output.

LineageID

Integer

ID della colonna di output. I componenti a valle fanno riferimento alla colonna utilizzando questo valore.

Name

String

Nome della colonna di output.

SortKeyPosition

Integer

Valore che indica se una colonna è ordinata, l'ordinamento e la sequenza di ordinamento di più colonne. Il valore 0 indica che la colonna non è ordinata. Per ulteriori informazioni, vedere Procedura: Ordinamento dei dati per le trasformazioni Unione e Merge Join.

SpecialFlags

Integer

Valore che contiene i flag speciali della colonna di output.

TruncationRowDisposition

DTSRowDisposition

Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I possibili valori sono Fail component, Ignore failure e Redirect row. Il valore predefinito è Interrompi componente.

Le colonne di output includono anche un set di proprietà del tipo di dati.

Proprietà delle colonne di metadati esterne

Nel modello di oggetti Integration Services, input e output possono contenere un insieme di colonne di metadati esterne. Una colonna di metadati esterna di un componente nel flusso di dati implementa l'interfaccia IDTSExternalMetadataColumn100.

Nella tabella seguente vengono descritte le proprietà delle colonne di metadati esterne dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.

Proprietà

Tipo di dati

Descrizione

Description

String

Descrive la colonna esterna.

ID

Integer

Valore che identifica la colonna in modo univoco.

IdentificationString

String

Stringa che identifica la colonna.

Name

String

Nome della colonna esterna.

Le colonne di metadati esterne includono anche un set di proprietà del tipo di dati.

Proprietà del tipo di dati

Le colonne di metadati esterne e le colonne di output includono anche un set di proprietà del tipo di dati. A seconda del tipo di dati della colonna, le proprietà possono essere di lettura/scrittura o di sola lettura.

Nella tabella seguente vengono descritte le proprietà del tipo di dati delle colonne di metadati esterne e delle colonne di output.

Proprietà

Tipo di dati

Descrizione

CodePage

Integer

Specifica la tabella codici per i dati stringa non Unicode.

DataType

Integer (enumerazione)

Tipo di dati Integration Services della colonna. Per ulteriori informazioni, vedere Tipi di dati di Integration Services.

Length

Integer

Lunghezza della colonna in caratteri.

Precision

Integer

Precisione di una colonna numerica.

Scale

Integer

Scala di una colonna numerica.