Propriétés communes
Les objets de flux de données dans le modèle objet MicrosoftSQL ServerIntegration Services présentent des propriétés communes et personnalisées au niveau des composants, des entrées et sorties, et des colonnes d'entrée et de sortie. De nombreuses propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Cette rubrique répertorie et décrit les propriétés communes des objets de flux de données.
Composants
Entrées
Colonnes d'entrée
Sorties
Colonnes de sortie
Propriétés des composants
Dans le modèle objet Integration Services, un composant dans le flux de données implémente l'interface IDTSComponentMetaData100.
Le tableau suivant décrit les propriétés des composants dans un flux de données. Certaines propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Propriété |
Type de données |
Description |
---|---|---|
ComponentClassID |
Chaîne |
CLSID du composant. |
ContactInfo |
Chaîne |
Informations de contact pour le développeur d'un composant. |
Description |
Chaîne |
Description du composant de flux de données. La valeur par défaut de cette propriété est le nom du composant de flux de données. |
ID |
Entier |
Valeur qui identifie de manière unique cette instance du composant. |
IdentificationString |
Chaîne |
Identifie le composant. |
IsDefaultLocale |
Booléen |
Indique si le composant utilise les paramètres régionaux de la tâche de flux de données à laquelle il appartient. |
LocaleID |
Entier |
Paramètres régionaux utilisés par le composant de flux de données lors de l'exécution du package. Tous les paramètres régionaux Windows sont disponibles dans les composants de flux de données. |
Name |
Chaîne |
Nom du composant de flux de données. |
PipelineVersion |
Entier |
Version de la tâche de flux de données dans laquelle un composant est destiné à être exécuté. |
UsesDispositions |
Booléen |
Indique si un composant a une sortie d'erreur. |
ValidateExternalMetadata |
Booléen |
Indique si les métadonnées des colonnes externes sont validées. La valeur par défaut de cette propriété est True. |
Version |
Entier |
Version d'un composant. |
Propriétés d'entrée
Dans le modèle objet Integration Services, les transformations et destinations ont des sorties. Une entrée d'un composant dans le flux de données implémente l'interface IDTSInput100.
Le tableau suivant décrit les propriétés des entrées de composants dans un flux de données. Certaines propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Propriété |
Type de données |
Description |
---|---|---|
Description |
Chaîne |
Description de l'entrée. |
ErrorOrTruncationOperation |
Chaîne |
Chaîne facultative qui spécifie les types d'erreurs ou troncations qui peuvent se produire lors du traitement d'une ligne. |
ErrorRowDisposition |
Valeur qui spécifie la gestion des erreurs. Ces valeurs sont Fail component, Ignore failure et Redirect row. |
|
HasSideEffects |
Booléen |
Indique si un composant peut être supprimé du plan d'exécution du flux de données lorsqu'il n'est pas attaché à un composant en aval et lorsque la propriété RunInOptimizedMode a la valeur true. |
ID |
Entier |
Valeur qui identifie l'entrée de façon unique. |
IdentificationString |
Chaîne |
Chaîne qui identifie l'entrée. |
IsSorted |
Booléen |
Indique si les données dans l'entrée sont triées. |
Name |
Chaîne |
Nom de l'entrée. |
SourceLocale |
Entier |
ID de paramètres régionaux (LCID) des données d'entrée. |
TruncationRowDisposition |
Valeur qui détermine la façon dont le composant gère les troncations qui se produisent lors du traitement des lignes. . Ces valeurs sont Fail component, Ignore failure et Redirect row. |
Les destinations et certaines transformations ne prennent pas en charge les sorties d'erreur, et les propriétés ErrorRowDisposition et TruncationRowDisposition de ces composants sont en lecture seule.
Propriétés de colonne d'entrée
Dans le modèle objet Integration Services, une entrée contient une collection de colonnes d'entrée. Une colonne d'entrée d'un composant dans le flux de données implémente l'interface IDTSInputColumn100.
Le tableau suivant décrit les propriétés des colonnes d'entrée de composants dans un flux de données. Certaines propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Propriété |
Type de données |
Description |
---|---|---|
ComparisonFlags |
Entier |
Ensemble d'indicateurs qui spécifient la comparaison des colonnes ayant un type de données character. Pour plus d'informations, consultez Comparaison des données chaînes. |
Description |
Chaîne |
Décrit la colonne d'entrée. |
ErrorOrTruncationOperation |
Chaîne |
Chaîne facultative qui spécifie les types d'erreurs ou troncations qui peuvent se produire lors du traitement d'une ligne. |
ErrorRowDisposition |
Valeur qui spécifie la gestion des erreurs. Ces valeurs sont Fail component, Ignore failure et Redirect row. |
|
ExternalMetadataColumnID |
ID de la colonne de métadonnées externe assigné à une colonne d'entrée. |
|
ID |
Entier |
Valeur qui identifie la colonne d'entrée de façon unique. |
IdentificationString |
Chaîne |
Chaîne qui identifie la colonne d'entrée. |
LineageID |
Entier |
ID de la colonne en amont. |
Name |
Chaîne |
Nom de la colonne d'entrée. |
SortKeyPosition |
Entier |
Valeur qui indique si une colonne est triée, son ordre de tri et la séquence dans laquelle plusieurs colonnes sont triées. La valeur 0 indique que la colonne n'est pas triée. Pour plus d'informations, consultez Procédure : trier des données pour les transformations de fusion et de jointure de fusion. |
TruncationRowDisposition |
Valeur qui détermine la façon dont le composant gère les troncations qui se produisent lors du traitement des lignes. Ces valeurs sont Fail component, Ignore failure et Redirect row. |
|
UpstreamComponentName |
Chaîne |
Nom du composant en amont. |
UsageType |
Valeur qui détermine la façon dont une colonne d'entrée est utilisée par le composant. |
Les propriétés de type de données des colonnes d'entrée sont également décrites sous « Propriétés du type de données ».
Propriétés de sortie
Dans le modèle objet Integration Services, les sources et les transformations ont des sorties. Une sortie d'un composant dans le flux de données implémente l'interface IDTSOutput100.
Le tableau suivant décrit les propriétés des sorties de composants dans un flux de données. Certaines propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Propriété |
Type de données |
Description |
---|---|---|
DeleteOutputOnPathDetached |
Booléen |
Valeur qui détermine si le moteur de flux de données supprime la sortie lorsqu'elle est détachée d'un chemin d'accès. |
Description |
Chaîne |
Décrit la sortie. |
ErrorOrTruncationOperation |
Chaîne |
Chaîne facultative qui spécifie les types d'erreurs ou troncations qui peuvent se produire lors du traitement d'une ligne. |
ErrorRowDisposition |
Valeur qui spécifie la gestion des erreurs. Ces valeurs sont Fail component, Ignore failure et Redirect row. |
|
ExclusionGroup |
Entier |
Valeur qui identifie un groupe de sorties s'excluant mutuellement. |
HasSideEffects |
Booléen |
Valeur qui indique si un composant peut être supprimé du plan d'exécution du flux de données lorsqu'il n'est pas attaché à un composant en amont et lorsque la propriété RunInOptimizedMode a la valeur true. |
ID |
Entier |
Valeur qui identifie la sortie de façon unique. |
IdentificationString |
Chaîne |
Chaîne qui identifie la sortie. |
IsErrorOut |
Booléen |
Indique si la sortie est une sortie d'erreur. |
IsSorted |
Booléen |
Indique si la sortie est triée. La valeur par défaut est False.
Important
La définition de la propriété IsSorted à la valeur True ne permet pas de trier les données. Cette propriété indique uniquement aux composants en aval que les données ont été précédemment triées. Pour plus d'informations, consultez Procédure : trier des données pour les transformations de fusion et de jointure de fusion.
|
Name |
Chaîne |
Nom de la sortie. |
SynchronousInputID |
Entier |
ID d'une entrée synchrone avec la sortie. |
TruncationRowDisposition |
Valeur qui détermine la façon dont le composant gère les troncations qui se produisent lors du traitement des lignes. Ces valeurs sont Fail component, Ignore failure et Redirect row. |
Propriétés de colonne de sortie
Dans le modèle objet Integration Services, une sortie contient une collection de colonnes de sortie. Une colonne de sortie d'un composant dans le flux de données implémente l'interface IDTSOutputColumn100.
Le tableau suivant décrit les propriétés des colonnes de sortie de composants dans un flux de données. Certaines propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Propriété |
Type de données |
Description |
---|---|---|
ComparisonFlags |
Entier |
Ensemble d'indicateurs qui spécifient la comparaison des colonnes ayant un type de données character. Pour plus d'informations, consultez Comparaison des données chaînes. |
Description |
Chaîne |
Décrit la colonne de sortie. |
ErrorOrTruncationOperation |
Chaîne |
Chaîne facultative qui spécifie les types d'erreurs ou troncations qui peuvent se produire lors du traitement d'une ligne. |
ErrorRowDisposition |
Valeur qui spécifie la gestion des erreurs. Ces valeurs sont Fail component, Ignore failure et Redirect row. La valeur par défaut est Composant défaillant. |
|
ExternalMetadataColumnID |
Entier |
ID de la colonne de métadonnées externe assigné à une colonne d'entrée. |
ID |
Entier |
Valeur qui identifie la colonne de sortie de façon unique. |
IdentificationString |
Chaîne |
Chaîne qui identifie la colonne de sortie. |
LineageID |
Entier |
ID de la colonne de sortie. Les composants en aval font référence à la colonne à l'aide de cette valeur. |
Name |
Chaîne |
Nom de la colonne de sortie. |
SortKeyPosition |
Entier |
Valeur qui indique si une colonne est triée, son ordre de tri et l'ordre dans lequel plusieurs colonnes sont triées. La valeur 0 indique que la colonne n'est pas triée. Pour plus d'informations, consultez Procédure : trier des données pour les transformations de fusion et de jointure de fusion. |
SpecialFlags |
Entier |
Valeur qui contient les indicateurs spéciaux de la colonne de sortie. |
TruncationRowDisposition |
Valeur qui détermine la façon dont le composant gère les troncations qui se produisent lors du traitement des lignes. Ces valeurs sont Fail component, Ignore failure et Redirect row. La valeur par défaut est Composant défaillant. |
Les colonnes de sortie incluent également un jeu de propriétés de type de données.
Propriétés de colonne de métadonnées externe
Dans le modèle objet Integration Services, les entrées et sorties peuvent contenir une collection de colonnes de métadonnées externes. Une colonne de métadonnées externe d'un composant dans le flux de données implémente l'interface IDTSExternalMetadataColumn100.
Le tableau suivant décrit les propriétés des colonnes de métadonnées externes de composants dans un flux de données. Certaines propriétés ont des valeurs en lecture seule qui sont assignées au moment de l'exécution par le moteur de flux de données.
Propriété |
Type de données |
Description |
---|---|---|
Description |
Chaîne |
Décrit la colonne externe. |
ID |
Entier |
Valeur qui identifie la colonne de façon unique. |
IdentificationString |
Chaîne |
Chaîne qui identifie la colonne. |
Name |
Chaîne |
Nom de la colonne externe. |
Les colonnes de métadonnées externes incluent également un jeu de propriétés de type de données.
Propriétés du type de données
Les colonnes de sortie et les colonnes de métadonnées externes incluent un jeu de propriétés de type de données. Selon le type de données de la colonne, les propriétés peuvent être en lecture/écriture ou en lecture seule.
Le tableau suivant décrit les propriétés de type de données des colonnes de sortie et des colonnes de métadonnées externes.
Propriété |
Type de données |
Description |
---|---|---|
CodePage |
Entier |
Spécifie la page de codes pour les données de chaîne qui ne sont pas Unicode. |
DataType |
Entier (énumération) |
Type de données Integration Services de la colonne. Pour plus d'informations, consultez Types de données d'Integration Services. |
Length |
Entier |
Longueur d'une colonne en caractères. |
Precision |
Entier |
Précision d'une colonne numérique. |
Scale |
Entier |
Échelle d'une colonne numérique. |