Propriétés communes

Article
05/07/2013

Les objets de flux de données dans le modèle objet Microsoft SQL Server Integration 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

Pour plus d'informations sur les propriétés des clients, consultez les rubriques suivantes

Propriétés du composant

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	DTSRowDisposition	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	DTSRowDisposition	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	DTSRowDisposition	Valeur qui spécifie la gestion des erreurs. Ces valeurs sont Fail component, Ignore failure et Redirect row.
ExternalMetadataColumnID	IDTSExternalMetadataColumn100	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 Trier des données pour les transformations de fusion et de jointure de fusion.
TruncationRowDisposition	DTSRowDisposition	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	DTSUsageType	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	DTSRowDisposition	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 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	DTSRowDisposition	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	DTSRowDisposition	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 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	DTSRowDisposition	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.