Source OLE DB

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

La source OLE DB extrait des données d'une série de bases de données relationnelles compatibles OLE DB à l'aide d'une table de base de données, d'une vue ou d'une commande SQL. Par exemple, la source OLE DB peut extraire des données de tables de bases de données Microsoft Office Access ou SQL Server .

La source OLE DB fournit quatre modes d'accès aux données différents pour l'extraction des données :

• Une table ou une vue.

• Une table ou une vue spécifiée dans une variable.

• Les résultats d'une instruction SQL. La requête peut être une requête paramétrable.

• Les résultats d'une instruction SQL stockée dans une variable.

Si vous utilisez une requête paramétrable, vous pouvez mapper des variables à des paramètres pour spécifier les valeurs de paramètres individuels dans les instructions SQL.

Cette source utilise un gestionnaire de connexions OLE DB pour se connecter à une source de données et le gestionnaire de connexions spécifie le fournisseur OLE DB à utiliser. Pour plus d’informations, consultez OLE DB Connection Manager.

Un projet Integration Services fournit également l'objet de source de données à partir duquel vous pouvez créer un gestionnaire de connexions OLE DB et rendre ainsi les sources de données et les vues de source de données disponibles pour la source OLE DB.

Selon le fournisseur OLE DB, certaines contraintes s'appliquent à la source OLE DB :

• Le fournisseur Microsoft OLE DB pour Oracle ne prend pas en charge les types de données Oracle BLOB, CLOB, NCLOB, BFILE ou UROWID et la source OLE DB ne peut pas extraire de données des tables qui contiennent des colonnes de ces types de données.

• Le fournisseur IBM OLE DB DB2 et le fournisseur Microsoft OLE DB DB2 ne prennent pas en charge l'utilisation d'une commande SQL qui appelle une procédure stockée. Lorsque ce type de commande est utilisé, la source OLE DB ne peut pas créer les métadonnées de colonne ; par conséquent, les composants de flux de données qui suivent la source OLE DB dans le flux de données ne disposent pas de données de colonnes et l'exécution du flux de données échoue.

La source OLE DB a une sortie normale et une sortie d'erreur.

Utilisation d'instructions SQL paramétrables

La source OLE DB peut utiliser une instruction SQL pour extraire des données. L'instruction peut être une instruction SELECT ou EXEC.

La source OLE DB utilise un gestionnaire de connexions OLE DB pour établir une connexion à la source de données à partir de laquelle elle extrait des données. Selon le fournisseur que le gestionnaire de connexions OLE DB utilise et le système de gestion de bases de données relationnelles (SGBDR) auquel le gestionnaire de connexions se connecte, différentes règles s'appliquent à la dénomination des paramètres et à la constitution de leur liste. Si les noms des paramètres sont retournés à partir du SGBDR, vous pouvez utiliser des noms de paramètres pour mapper les paramètres d'une liste de paramètres aux paramètres d'une instruction SQL ; sinon, les paramètres sont mappés aux paramètres de l'instruction SQL en fonction de leur position ordinale dans la liste de paramètres. Les types de noms de paramètres pris en charge varient selon le fournisseur. Par exemple, certains fournisseurs imposent l'utilisation de noms de variables ou de colonnes, d'autres exigent l'emploi de noms symboliques tels que 0 ou Param0. Il convient de consulter la documentation spécifique du fournisseur pour obtenir des informations sur les noms de paramètres à utiliser dans les instructions SQL.

Lorsque vous utilisez un gestionnaire de connexions OLE DB, vous ne pouvez pas utiliser de sous-requêtes paramétrables, car la source OLE DB ne peut pas dériver d'informations de paramètre par le biais du fournisseur OLE DB. Vous pouvez toutefois utiliser une expression pour concaténer les valeurs de paramètre dans la chaîne de requête et définir la propriété SqlCommand de la source. Dans le Concepteur SSIS , vous configurez une source OLE DB à l’aide de la boîte de dialogue Éditeur de source OLE DB et mappez les paramètres à des variables dans la boîte de dialogue Définition des paramètres de la requête .

Spécifications de paramètres à l'aide de positions ordinales

Si aucun nom de paramètre n’est retourné, l’ordre selon lequel les paramètres sont répertoriés dans la liste Paramètres dans la boîte de dialogue Définition des paramètres de la requête régit le marqueur de paramètre auquel ils sont mappés au moment de l’exécution. Le premier paramètre de la liste est-il mappé sur le premier dans l'instruction SQL, le deuxième sur le deuxième ?, etc.

L’instruction SQL suivante sélectionne des lignes dans la table Product de la base de données AdventureWorks2022 . Le premier paramètre dans la liste Mappages est mappé au premier paramètre de la colonne Color , le deuxième paramètre à la colonne Size .

SELECT * FROM Production.Product WHERE Color = ? AND Size = ?

Les noms de paramètres n'ont aucune incidence. Par exemple, si un paramètre porte le même nom que la colonne à laquelle il s’applique, mais qu’il n’est pas placé à la bonne position ordinale dans la liste Paramètres , le mappage de paramètres effectué au moment de l’exécution utilise la position ordinale du paramètre, pas le nom du paramètre.

La commande EXEC impose généralement l'utilisation des noms des variables qui fournissent des valeurs de paramètres dans la procédure comme noms de paramètres.

Spécification de paramètres à l'aide de noms

Si les noms de paramètres réels sont retournés à partir du SGBDR, les paramètres utilisés par une instruction SELECT et EXEC sont mappés par nom. Les noms de paramètres doivent correspondre aux noms que la procédure stockée, exécutée par l'instruction SELECT ou l'instruction EXEC, attend.

L’instruction SQL suivante exécute la procédure stockée uspGetWhereUsedProductID , disponible dans la base de données AdventureWorks2022 .

EXEC uspGetWhereUsedProductID ?, ?

La procédure stockée attend les variables, @StartProductID et @CheckDate, pour fournir des valeurs de paramètres. L’ordre dans lequel les paramètres apparaissent dans la liste Mappages n’est pas pertinent. Le seul impératif est que les noms de paramètres correspondent aux noms de variables dans la procédure stockée, notamment le signe @.

Mappage de paramètres à des variables

Les paramètres sont mappés à des variables qui fournissent les valeurs de paramètres au moment de l'exécution. Les variables sont généralement des variables définies par l’utilisateur, bien que vous puissiez utiliser les variables système fournies par Integration Services . Si vous utilisez des variables définies par l'utilisateur, assurez-vous que vous choisissez un type de données compatible avec celui de la colonne référencée par le paramètre mappé. Pour plus d’informations, consultez Variables Integration Services (SSIS).

Résolution des problèmes liés à la source OLE DB

Vous pouvez consigner les appels que la source OLE DB effectue vers des fournisseurs de données externes. Cette fonctionnalité de journalisation permet de résoudre des problèmes liés au chargement de données que réalise la source OLE DB depuis des sources de données externes. Pour consigner les appels que la source OLE DB effectue vers des fournisseurs de données externes, activez la journalisation de package et sélectionnez l’événement Diagnostic au niveau du package. Pour plus d’informations, consultez Outils de dépannage pour l’exécution des packages.

Configuration de la source OLE DB

Vous pouvez définir les propriétés par programmation ou par le biais du concepteur SSIS .

La boîte de dialogue Éditeur avancé reflète les propriétés qui peuvent être définies par programmation. Pour plus d'informations sur les propriétés définissables dans la boîte de dialogue Éditeur avancé ou par programmation, cliquez sur l'une des rubriques suivantes :

• Propriétés communes

• Propriétés personnalisées OLE DB

Tâches associées

• Extraire des données à l’aide de la source OLE DB

• Mapper des paramètres de requête à des variables dans un composant de flux de données

• Définir les propriétés d’un composant de flux de données

• Trier des données pour les transformations de fusion et de jointure de fusion

Contenu associé

SSIS avec des connecteurs Oracle

Éditeur de source OLE DB (page Gestionnaire de connexions)

La page Gestionnaire de connexions de la boîte de dialogue Éditeur de source OLE DB vous permet de sélectionner le gestionnaire de connexions OLE DB pour la source. Cette page vous permet également de sélectionner une table ou une vue à partir de la base de données.

Ouvrir l’Éditeur de source OLE DB (page Gestionnaire de connexions)

1. Ajoutez la source OLE DB au package Integration Services dans SQL Server Data Tools (SSDT).

2. Cliquez avec le bouton droit sur le composant de la source, puis cliquez sur Modifier.

3. Cliquez sur Gestionnaire de connexions.

Options statiques

Gestionnaire de connexions OLE DB
Sélectionnez un gestionnaire de connexions existant dans la liste ou créez une nouvelle connexion en cliquant sur Nouveau.

Nouveau
Créez un gestionnaire de connexions à l’aide de la boîte de dialogue Configurer le gestionnaire de connexions OLE DB .

Mode d'accès aux données
Spécifiez la méthode de sélection des données dans la source.

Préversion
Affichez un aperçu des résultats à l’aide de la boîte de dialogue Vue de données . Le modeAperçu peut afficher jusqu’à 200 lignes.

Options dynamiques du mode d'accès aux données

Mode d'accès aux données = Table ou vue

Nom de la table ou de la vue
Sélectionnez le nom de la table ou de la vue dans la liste de celles qui sont disponibles dans la source de données.

Mode d'accès aux données = Variable de nom de table ou de vue

Nom de la variable
Sélectionnez la variable qui contient le nom de la table ou de la vue.

Mode d'accès aux données = Commande SQL

Texte de la commande SQL
Entrez le texte d’une requête SQL, générez la requête en cliquant sur Générer une requêteou recherchez le fichier qui contient le texte de la requête en cliquant sur Parcourir.

Paramètres
Si vous avez entré une requête paramétrable en spécifiant ? comme espace réservé de paramètre dans le texte de la requête, utilisez la boîte de dialogue Définition des paramètres de la requête pour mapper des paramètres d’entrée de la requête à des variables du package.

Construire une requête
Utilisez la boîte de dialogue Générateur de requêtes pour construire la requête SQL visuellement.

Parcourir
Dans la boîte de dialogue Ouvrir , localisez le fichier qui contient le texte de la requête SQL.

Analyser la requête
Vérifiez la syntaxe du texte de la requête.

Mode d'accès aux données = Commande SQL à partir d'une variable

Nom de la variable
Sélectionnez la variable qui contient le texte de la requête SQL.

Éditeur de source OLE DB (page Colonnes)

Utilisez la page Colonnes de la boîte de dialogue Éditeur de source OLE DB pour mapper une colonne de sortie à chaque colonne externe (source).

Options

Colonnes externes disponibles
Affiche la liste des colonnes externes disponibles dans la source de données. Vous ne pouvez pas ajouter ou supprimer des colonnes à l'aide de cette table.

Colonne externe
Affiche les colonnes externes (sources) selon l'ordre dans lequel vous les visualisez lorsque vous configurez des composants qui consomment des données à partir de cette source. Vous pouvez modifier cet ordre en supprimant d'abord les colonnes sélectionnées dans la table, puis en choisissant des colonnes externes dans la liste selon un ordre différent.

Colonne de sortie
Spécifiez un nom unique pour chaque colonne de sortie. Le nom par défaut est celui de la colonne externe (source) sélectionnée ; vous pouvez néanmoins choisir n'importe quel nom unique et significatif. Le nom spécifié s'affiche dans le concepteur SSIS.

Éditeur de source OLE DB (page Sortie d'erreur)

La page Sortie d’erreur de la boîte de dialogue Éditeur de source OLE DB vous permet de sélectionner les options de gestion des erreurs et de définir les propriétés sur les colonnes de sortie d’erreur.

Options

Entrée/sortie
Affichez le nom de la source de données.

Colonne
Indique les colonnes (sources) externes que vous avez sélectionnées dans la page Gestionnaire de connexions de la boîte de dialogue Éditeur de source OLE DB.

Error
Indiquez ce qui doit se produire lorsqu'une erreur se produit : ignorer l'échec, rediriger la ligne ou faire échouer le composant.

Rubriques connexes :Gestion des erreurs dans les données

Troncation
Indiquez ce qui doit se produire lorsqu'une troncation se produit : ignorer l'échec, rediriger la ligne ou faire échouer le composant.

Description
Affiche la description de l'erreur.

Définir cette valeur sur les cellules sélectionnées
Indiquez ce qui doit se produire pour l'ensemble des cellules sélectionnées lorsqu'une erreur ou une troncation se produit : ignorer l'échec, rediriger la ligne ou faire échouer le composant.

Appliquer
Appliquez l'option de gestion des erreurs aux cellules sélectionnées.

Voir aussi

Destination OLE DB
Variables Integration Services (SSIS)
Flux de données