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 |
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 |
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 |
Valore che specifica la gestione degli errori. I possibili valori sono Fail component, Ignore failure e Redirect row. |
|
ExternalMetadataColumnID |
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 |
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 |
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 |
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.
Importante
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 |
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 |
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 |
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. |