Définir les propriétés d’un composant de flux de données
S’applique à :
SQL Server SSIS Integration Runtime dans Azure Data Factory
Pour définir les propriétés de composants de flux de données, qui incluent des sources, des destinations et des transformations, utilisez l'une des fonctionnalités suivantes :
Les éditeurs de composants fournis par Integration Services . Ces éditeurs ne peuvent être utilisés que pour définir les propriétés personnalisées de chaque composant de flux de données.
La fenêtre Propriétés énumère les propriétés personnalisées définies au niveau du composant pour chaque élément, ainsi que les propriétés communes à tous les éléments du flux de données.
La boîte de dialogue Éditeur avancé permet d’accéder aux propriétés personnalisées pour chaque composant. La boîte de dialogue Éditeur avancé permet aussi d’accéder aux propriétés communes à l’ensemble des composants de flux de données, à savoir les propriétés des entrées, des sorties, des sorties d’erreurs, des colonnes et des colonnes externes.
Définir les propriétés d’un composant de flux de données à l’aide d’un éditeur de composant
Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package souhaité.
Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.
Cliquez sur l’onglet Flux de contrôle , puis double-cliquez sur la tâche de flux de données qui contient le flux de données et le composant dont vous voulez afficher ou modifier les propriétés.
Double-cliquez sur le composant du flux de données.
Dans l'éditeur de composant, affichez ou modifiez les valeurs des propriétés, puis fermez l'éditeur.
Pour enregistrer le package mis à jour, dans le menu Fichier , cliquez sur Enregistrer les éléments sélectionnés.
Définir les propriétés d’un composant de flux de données dans la fenêtre Propriétés
Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package souhaité.
Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.
Cliquez sur l’onglet Flux de contrôle , puis double-cliquez sur la tâche de flux de données qui contient le composant dont vous voulez afficher ou modifier les propriétés.
Cliquez avec le bouton droit sur le composant du flux de données, puis cliquez sur Propriétés.
Affichez ou modifiez les valeurs des propriétés, puis fermez la fenêtre Propriétés .
Notes
De nombreuses propriétés sont en lecture seule et ne peuvent donc pas être modifiées.
Pour enregistrer le package mis à jour, dans le menu Fichier , cliquez sur Enregistrer les éléments sélectionnés.
Définir les propriétés d’un composant de flux de données à l’aide de l’Éditeur avancé
Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package souhaité.
Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.
Cliquez sur l’onglet Flux de contrôle , puis double-cliquez sur la tâche de flux de données qui contient le composant à afficher ou à modifier.
Dans le concepteur de flux de données, cliquez avec le bouton droit sur le composant du flux de données, puis cliquez sur Afficher l’éditeur avancé.
Notes
Dans SQL Server, les composants de flux de données qui prennent en charge plusieurs entrées ne peuvent pas utiliser l’éditeur avancé.
Dans la boîte de dialogue Éditeur avancé , procédez de l’une des façons suivantes :
Pour afficher et spécifier la connexion utilisée par le composant, cliquez sur l’onglet Gestionnaires de connexions .
Notes
L’onglet Gestionnaire de connexions est accessible uniquement aux composants de flux de données qui utilisent des gestionnaires de connexions pour se connecter à des sources de données telles que des fichiers et des bases de données.
Pour afficher et modifier les propriétés au niveau du composant, cliquez sur l’onglet Propriétés du composant .
Pour afficher et modifier les mappages entre des colonnes externes et la sortie disponible, cliquez sur l’onglet Mappage de colonnes .
Notes
L’onglet Mappage de colonnes est disponible uniquement pendant l’affichage ou la modification des sources et des destinations.
Pour afficher la liste des colonnes d’entrée disponibles et mettre à jour le nom des colonnes de sortie, cliquez sur l’onglet Colonnes d’entrée .
Notes
L'onglet Colonnes d'entrée est disponible uniquement en cas d'utilisation de transformations ou de destinations. Pour plus d’informations, consultez Transformations Integration Services.
Pour afficher et modifier les propriétés des entrées, des sorties, des sorties d’erreur et les propriétés des colonnes qu’elles contiennent, cliquez sur l’onglet Propriétés d’entrée et de sortie .
Notes
Les sources ne comportent pas d'entrées. Les destinations ne comportent pas de sorties, sauf pour une sortie d'erreur facultative.
Affichez ou modifiez les valeurs des propriétés.
Cliquez sur OK.
Pour enregistrer le package mis à jour, dans le menu Fichier , cliquez sur Enregistrer les éléments sélectionnés.
Propriétés communes des composants de flux de données
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.
Component properties
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 | String | CLSID du composant. |
| ContactInfo | String | Informations de contact pour le développeur d'un composant. |
| Description | String | 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 | Integer | Valeur qui identifie de manière unique cette instance du composant. |
| IdentificationString | String | 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 | Integer | 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. |
| Nom | String | Nom du composant de flux de données. |
| PipelineVersion | Integer | 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 | Boolean | Indique si les métadonnées des colonnes externes sont validées. La valeur par défaut de cette propriété est True. |
| Version | Integer | 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 | String | Description de l'entrée. |
| ErrorOrTruncationOperation | String | 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 failureet 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 | Integer | Valeur qui identifie l'entrée de façon unique. |
| IdentificationString | String | Chaîne qui identifie l'entrée. |
| IsSorted | Booléen | Indique si les données dans l'entrée sont triées. |
| Nom | String | Nom de l'entrée. |
| SourceLocale | Integer | 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 failureet 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 des colonnes 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 | Integer | Ensemble d'indicateurs qui spécifient la comparaison des colonnes ayant un type de données character. Pour plus d'informations, voir Comparing String Data. |
| Description | String | Décrit la colonne d'entrée. |
| ErrorOrTruncationOperation | String | 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 failureet Redirect row. |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | ID de la colonne de métadonnées externe assigné à une colonne d'entrée. |
| id | Integer | Valeur qui identifie la colonne d'entrée de façon unique. |
| IdentificationString | String | Chaîne qui identifie la colonne d'entrée. |
| LineageID | Integer | ID de la colonne en amont. |
| LineageIdentificationString | String | Chaîne d’identification qui inclut le nom de la colonne en amont. |
| Nom | String | Nom de la colonne d'entrée. |
| SortKeyPosition | Integer | 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. |
| 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 failureet Redirect row. |
| UpstreamComponentName | String | 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 | String | Décrit la sortie. |
| ErrorOrTruncationOperation | String | 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 failureet Redirect row. |
| ExclusionGroup | Integer | 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 | Integer | Valeur qui identifie la sortie de façon unique. |
| IdentificationString | String | 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 valeur de la propriété IsSorted sur True ne trie pas 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. |
| Nom | String | Nom de la sortie. |
| SynchronousInputID | Integer | 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 failureet Redirect row. |
Propriétés des colonnes 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 | Integer | Ensemble d'indicateurs qui spécifient la comparaison des colonnes ayant un type de données character. Pour plus d'informations, voir Comparing String Data. |
| Description | String | Décrit la colonne de sortie. |
| ErrorOrTruncationOperation | String | 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 failureet Redirect row. La valeur par défaut est Composant défaillant. |
| ExternalMetadataColumnID | Integer | ID de la colonne de métadonnées externe assigné à une colonne d'entrée. |
| id | Integer | Valeur qui identifie la colonne de sortie de façon unique. |
| IdentificationString | String | Chaîne qui identifie la colonne de sortie. |
| LineageID | Integer | ID de la colonne de sortie. Les composants en aval font référence à la colonne à l'aide de cette valeur. |
| LineageIdentificationString | String | Chaîne d’identification qui inclut le nom de la colonne. |
| Nom | String | Nom de la colonne de sortie. |
| SortKeyPosition | Integer | 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 | Integer | 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 failureet 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 des colonnes de métadonnées externes
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 | String | Décrit la colonne externe. |
| id | Integer | Valeur qui identifie la colonne de façon unique. |
| IdentificationString | String | Chaîne qui identifie la colonne. |
| Nom | String | 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 de 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 | Integer | Spécifie la page de codes pour les données de chaîne qui ne sont pas Unicode. |
| DataType | Integer (énumération) | Type de données Integration Services de la colonne. Pour plus d’informations, consultez Types de données Integration Services. |
| Longueur | Integer | Longueur d'une colonne en caractères. |
| Precision | Integer | Précision d'une colonne numérique. |
| Scale | Integer | Échelle d'une colonne numérique. |
Propriétés personnalisées des composants de flux de données
Pour plus d’informations sur les propriétés personnalisées, consultez les rubriques suivantes :
Propriétés personnalisées de la tâche de contrôle de capture de données modifiées
Propriétés personnalisées de la destination d'apprentissage du modèle d'exploration de données
Propriétés personnalisées de la destination de traitement de dimension
OLE DB Custom PropertiesPropriétés personnalisées OLE DB
Propriétés personnalisées de la destination de traitement de partition
Propriétés personnalisées de la destination du jeu d'enregistrements
Propriétés personnalisées de la destination SQL Server Compact Edition
Utiliser une expression dans un composant de flux de données
Cette procédure permet d'ajouter une expression à la transformation de fractionnement conditionnel ou à la transformation de colonne dérivée. La transformation de fractionnement conditionnel utilise des expressions pour définir les conditions qui dirigent les lignes de données vers une sortie de transformation et la transformation de colonne dérivée utilise des expressions pour définir les valeurs affectées aux colonnes.
Pour implémenter une expression dans une transformation, le package doit déjà inclure au moins une tâche de flux de données et une source.
Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package souhaité.
Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.
Dans le concepteur SSIS , cliquez sur l’onglet Flux de contrôle , puis cliquez sur la tâche de flux de données contenant le flux de données dans lequel vous voulez implémenter une expression.
Cliquez sur l’onglet Flux de données , et faites glisser une transformation de fractionnement conditionnel ou de colonne dérivée de la Boîte à outils jusqu’à l’aire de conception.
Faites glisser le connecteur vert de la source ou d'une transformation vers la transformation de fractionnement conditionnel ou de colonne dérivée.
Double-cliquez sur la transformation pour ouvrir sa boîte de dialogue.
Dans le volet gauche, développez Variables pour afficher les variables système et définies par l’utilisateur, et développez Colonnes pour afficher les colonnes d’entrée de transformation.
Dans le volet droit, développez Fonctions mathématiques, Fonctions de chaîne, Fonctions de date et d’heure, Fonctions NULL, Casts de typeet Opérateurs pour accéder aux fonctions, conversions et opérateurs fournis par la grammaire d’expression.
Selon la transformation, effectuez l'une des opérations suivantes pour générer une expression :
Dans la boîte de dialogue Éditeur de transformation de fractionnement conditionnel , faites glisser les variables, colonnes, fonctions, conversions et opérateurs vers la colonne Condition . Vous pouvez également aussi taper une expression directement dans la colonne Condition .
Dans la boîte de dialogue Éditeur de transformation de colonne dérivée , faites glisser les variables, colonnes, fonctions, conversions et opérateurs vers la colonne Expression . Vous pouvez également taper une expression directement dans la colonne Expression .
Notes
Quand la colonne Condition ou Expression n’est plus active, le texte de l’expression peut être mis en surbrillance, ce qui indique que la syntaxe de l’expression est incorrecte.
Cliquez sur OK pour quitter la boîte de dialogue.
Notes
Si l'expression n'est pas valide, une alerte apparaît et décrit les erreurs de syntaxe de l'expression.
Propriétés de flux de données que vous pouvez définir avec une expression
Les valeurs de certaines propriétés d'objets de flux de données peuvent être spécifiées à l'aide d'expressions de propriété disponibles sur le conteneur de tâche de flux de données.
Pour plus d’informations sur l’utilisation d’expressions de propriété, consultez Expressions de propriété dans des packages.
Vous pouvez utiliser des expressions de propriété pour personnaliser les configurations de chaque instance déployée d'un package. Vous pouvez également utiliser des expressions de propriété pour spécifier des contraintes d’exécution pour un package à l’aide de l’option /set avec l’utilitaire d’invite de commandes dtexec . Par exemple, vous pouvez limiter le nombre maximal de threads ( MaximumThreads ) utilisés par la transformation de tri ou l’utilisation maximale de la mémoire ( MaxMemoryUsage des transformations de regroupement probable et de recherche floue. Si elles sont libres, ces transformations peuvent mettre en cache de grandes quantités de données en mémoire.
Pour spécifier une expression de propriété pour une des propriétés d’objets de flux de données répertoriées dans cette rubrique, affichez la fenêtre Propriétés pour la tâche de flux de données en la sélectionnant sur l’aire Flux de contrôle du concepteur ou en sélectionnant l’onglet Flux de données du concepteur sans sélectionner de composant ou de chemin individuel. Sélectionnez la propriété Expressions , puis cliquez sur les points de suspension (...) pour afficher la boîte de dialogue de l’Éditeur d’expressions de la propriété . Déroulez la liste Propriété pour sélectionner une propriété, puis entrez une expression dans la zone de texte Expression ou cliquez sur les points de suspension (...) pour afficher la boîte de dialogue Générateur d’expressions .
La liste Propriété affiche les propriétés disponibles uniquement pour les objets de flux de données que vous avez déjà placés sur l’aire Flux de données du concepteur. Par conséquent, vous ne pouvez pas utiliser la liste Propriété pour consulter toutes les propriétés possibles des objets de flux de données qui prennent en charge les expressions de propriété. Par exemple, si vous avez placé une source ADO.NET sur l’aire du concepteur, la liste Propriété contient une entrée pour la propriété [ADO NET Source].[SqlCommand] . La liste affiche également de nombreuses propriétés de la tâche de flux de données elle-même.
Les valeurs des propriétés de la liste suivante peuvent être spécifiées à l'aide d'expressions de propriété.
Sources de flux de données
| Objet de flux de données | Property |
|---|---|
| Source ADO NET | Propriété TableOrViewName Propriété SQLCommand |
| Source XML | Propriété XMLData Propriété XMLSchemaDefinition |
Transformations de flux de données
Pour plus d’informations sur ces propriétés personnalisées, consultez Propriétés personnalisées des transformations.
| Objet de flux de données | Property |
|---|---|
| transformation de fractionnement conditionnel | Propriété FriendlyExpression |
| Transformation de colonnes dérivées | Propriété FriendlyExpression |
| Transformation de regroupement approximatif | Propriété MaxMemoryUsage |
| transformation de recherche floue | Propriété MaxMemoryUsage |
| Transformation de recherche | Propriété SQLCommand Propriété SqlCommandParam |
| transformation de commande OLE DB | Propriété SQLCommand |
| transformation de l'échantillonnage du pourcentage | Propriété SamplingValue |
| transformation de tableau croisé dynamique | Propriété PivotKeyValue |
| transformation d'échantillonnage de lignes | Propriété SamplingValue |
| transformation de tri | Propriété MaximumThreads |
| Transformation Unpivot | Propriété PivotKeyValue |
Destinations du flux de données
| Objet de flux de données | Property |
|---|---|
| Destination ADO NET | Propriété TableOrViewName Propriété BatchSize Propriété CommandTimeout |
| Destination de fichier plat | Propriété Header |
| Destination SQL Server Compact | Propriété TableName |
| Destination SQL Server | Propriété BulkInsertTableName Propriété BulkInsertFirstRow Propriété BulkInsertLastRow Propriété BulkInsertOrder Propriété Timeout |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour