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

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 Procédure : 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.

ImportantImportant
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

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 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

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.