Chemins d'accès d'Integration Services

S’applique à : SQL Server SSIS Integration Runtime dans Azure Data Factory

Un chemin d'accès connecte deux composants d'un flux de données en reliant la sortie d'un composant à l'entrée d'un autre composant. Un chemin d'accès comporte une source et une destination. Par exemple, si un chemin d'accès connecte une source OLE DB et une transformation de tri, la source OLE DB est la source du chemin d'accès, tandis que la transformation de tri est la destination du chemin d'accès. La source est le composant où débute le chemin d'accès et la destination, le composant où il se termine.

Si vous exécutez un package dans le concepteur SSIS, vous pouvez voir les données dans un flux de données en attachant des visionneuses de données à un chemin. Une visionneuse de données peut être configurée pour afficher des données dans une grille. Une visionneuse de données est un outil de débogage très utile. Pour plus d’informations, consultez Débogage d’un flux de données.

Configurer le chemin

Le concepteur SSIS fournit la boîte de dialogue Éditeur du chemin de flux de données pour définir les propriétés du chemin, voir les métadonnées des colonnes de données qui passent par le chemin et configurer les visionneuses de données.

Le nom, la description et l'annotation du chemin d'accès sont des propriétés que vous pouvez configurer. Vous pouvez également configurer les chemins d'accès par programme. Pour plus d’informations, consultez Connexion de composants de flux de données par programme.

Une annotation de chemin affiche le nom de la source du chemin ou le nom du chemin sur l’aire de conception de l’onglet Flux de données du concepteur SSIS. Les annotations de chemins d'accès sont similaires aux annotations ajoutées aux flux de données, aux flux de contrôles et aux gestionnaires d'événements. La seule différence est qu’une annotation de chemin est attachée à un chemin, alors que les autres annotations apparaissent sous les onglets Flux de données, Flux de contrôleet Gestionnaires d’événements du concepteur SSIS.

Les métadonnées indiquent le nom, le type de données, la précision, l'échelle, la longueur, la page de codes et le composant source de chaque colonne dans la sortie du composant précédent. Le composant source est le composant du flux de données ayant créé la colonne. Il peut ou non s'agir du premier composant du flux de données. Par exemple, les transformations d'union totale et de tri créent leurs propres colonnes et sont les sources de leurs colonnes de sortie. À l'inverse, une transformation de copie de colonne peut transmettre des colonnes sans les modifier ou créer des colonnes en copiant les colonnes d'entrée. La transformation de copie de colonne est le composant source des nouvelles colonnes uniquement.

Définir les propriétés d’un chemin à l’aide de l’Éditeur du chemin d’accès au flux de données

Les chemins d'accès connectent deux composants de flux de données. Pour pouvoir définir les propriétés des chemins d'accès, le flux de données doit contenir au moins deux composants de flux de données connectés.

  1. Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package souhaité.

  2. Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.

  3. Cliquez sur l’onglet Flux de données , puis double-cliquez sur un chemin.

  4. Dans Éditeur du chemin d’accès au flux de données, cliquez sur Général. Vous pouvez ensuite modifier le nom par défaut du chemin d'accès et fournir une description. Vous pouvez également modifier la propriété PathAnnotation.

  5. Cliquez sur OK.

  6. Pour enregistrer le package mis à jour, cliquez sur Enregistrer les éléments sélectionnés dans le menu Fichier .

Page Général - Éditeur du chemin d’accès au flux de données

Utilisez la boîte de dialogue Éditeur du chemin d'accès au flux de données pour définir les propriétés du chemin d'accès, afficher les métadonnées de la colonne et gérer les visionneuses de données liées à ce chemin d'accès.

Utilisez le nœud Général de la boîte de dialogue Éditeur du chemin d'accès au flux de données pour nommer et décrire le chemin d'accès et pour spécifier ses options d'annotation.

Options

Nom
Donnez un nom unique au chemin d'accès.

Identifiant
Identificateur de lignage du chemin d'accès. Cette propriété est en lecture seule.

IdentificationString
Chaîne identifiant le chemin d'accès. Généré automatiquement à partir du nom entré précédemment.

Description
Décrivez le chemin d'accès.

PathAnnotation
Spécifiez le type d'annotation à utiliser. Choisissez Never pour désactiver les annotations, AsNeeded pour activer l'annotation à la demande, SourceName pour annoter automatiquement en utilisant la valeur de l'option SourceName et PathName pour annoter automatiquement en utilisant la valeur de la propriété Nom .

DestinationName
Affiche l'entrée qui représente l'issue du chemin d'accès.

SourceName
Affiche la sortie qui représente le début du chemin d'accès.

Page Métadonnées - Éditeur du chemin d’accès au flux de données

Utilisez la page Métadonnées de la boîte de dialogue Éditeur du chemin d'accès au flux de données pour afficher les métadonnées des colonnes du chemin d'accès.

Options

Path metadata
Affiche la liste des métadonnées des colonnes. Cliquez sur les en-têtes de colonne pour trier les données des colonnes.

Nom
Donne le nom de la colonne.

Type de données
Affiche le type de données de la colonne.

Précision
Affiche le nombre de chiffres d'une valeur numérique.

Mise à l’échelle
Affiche le nombre de chiffres à droite du séparateur décimal d'une valeur numérique.

Longueur
Affiche la longueur actuelle de la colonne.

Page de codes
Affiche la page de codes de la colonne. La valeur 0 indique que la colonne d'utilise pas de page de codes. Cette situation se produit lorsque les données sont au format Unicode ou de type numérique, date ou heure.

Position de la clé de tri
Affiche la position de la clé de tri de la colonne. La valeur 0 indique que la colonne n'est pas triée.

Notes

Un signe moins (-) comme préfixe indique que la colonne est triée dans l'ordre décroissant.

Indicateurs de comparaison
Affiche la liste des indicateurs de comparaison qui s'appliquent à la colonne.

Composant source
Affiche le composant du flux de données qui représente la source de la colonne.

Copier dans le Presse-papiers
Copie les données de la colonne dans le Presse-papiers. Par défaut, toutes les lignes de métadonnées sont copiées dans l'ordre de tri actuellement affiché.

Page Visionneuses de données - Éditeur du chemin d’accès au flux de données

Utilisez la page Visionneuses de données de la boîte de dialogue Éditeur du chemin d'accès au flux de données pour gérer les visionneuses de données liées au chemin d'accès.

Options

Nom
Affiche la liste des visionneuses de données.

Type de Visionneuse de données
Affiche le type de la visionneuse de données.

Ajouter
Cliquez sur ce bouton pour ajouter une visionneuse de données à l’aide de la boîte de dialogue Configurer la Visionneuse de données .

Supprimer
Cliquez sur cette option pour supprimer la Visionneuse de données sélectionnée.

Configurer
Cliquez sur ce bouton pour configurer la visionneuse de données sélectionnée à l’aide de la boîte de dialogue Configurer la Visionneuse de données .

Propriétés du chemin d’accès

Les objets de flux de données dans le modèle objet Microsoft SQL Server Integration Services ont des propriétés communes et des propriétés personnalisées au niveau du composant, des entrées et sorties, et des colonnes d’entrée et colonnes 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 personnalisées des chemins d'accès qui connectent des objets de flux de données.

Propriétés personnalisées d’un chemin

Dans le modèle objet Integration Services, un chemin qui connecte des composants dans le flux de données implémente l’interface IDTSPath100.

Le tableau suivant décrit les propriétés configurables des chemins d'accès dans un flux de données. Le moteur de flux de données assigne également des valeurs à d'autres propriétés en lecture seule qui ne sont pas répertoriées ici.

Nom de la propriété Type de données Description
PathAnnotation Integer (énumération) Valeur qui indique si une annotation doit être affichée avec le chemin d'accès sur l'aire du concepteur. Les valeurs possibles sont AsNeeded, SourceName, PathNameet Never. La valeur par défaut est AsNeeded.
DestinationName IDTSInput100 Entrée associée au chemin d'accès.
SourceName IDTSOutput100 Sortie associée au chemin d'accès.