Destination ADO NET

  • Article

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

La destination ADO NET charge des données dans différentes bases de données compatibles ADO.NETqui utilisent une table ou une vue de base de données. Vous pouvez charger ces données dans une table ou une vue existante ou créer une table et y charger les données.

Vous pouvez utiliser la destination ADO .NET. pour vous connecter à Microsoft Azure SQL Database. La connexion à SQL Database via OLE DB n'est pas prise en charge. Pour plus d’informations sur SQL Database, consultez Recommandations générales et limitations (Azure SQL Database).

Résolution des problèmes liés à la destination ADO NET

Vous pouvez consigner les appels que la destination ADO NET effectue auprès de fournisseurs de données externes. Cette fonctionnalité de journalisation permet de résoudre des problèmes liés à l'enregistrement de données vers des sources de données externes que réalise la destination ADO NET. Pour consigner les appels aux fournisseurs de données externes effectués par la destination ADO.NET, activez la journalisation du 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 destination ADO NET

Cette destination utilise un gestionnaire de connexions ADO.NET pour se connecter à une source de données. Il indique quel fournisseur ADO.NET utiliser. Pour plus d’informations, consultez Gestionnaire de connexions ADO.NET.

Une destination ADO NET inclut des mappages entre les colonnes d'entrée et les colonnes de la source de données de destination. Vous n'avez pas besoin de mapper les colonnes d'entrée à toutes les colonnes de destination. Toutefois, les propriétés de certaines colonnes de destination peuvent requérir le mappage de colonnes d'entrée. Sinon, des erreurs peuvent se produire. Par exemple, si une colonne de destination n'autorise pas les valeurs Null, vous devez mapper une colonne d'entrée à cette colonne. Par ailleurs, les types de données des colonnes mappées doivent être compatibles. Par exemple, vous ne pouvez pas mapper une colonne d’entrée avec un type de données chaîne à une colonne de destination avec un type de données numérique si le fournisseur ADO.NET ne prend pas en charge ce mappage.

Notes

SQL Server ne prend pas en charge l’insertion de texte dans des colonnes dont le type de données est défini sur image. Pour plus d’informations sur les types de données SQL Server, consultez Types de données (Transact-SQL).

Notes

La destination ADO NET ne prend pas en charge le mappage d'une colonne d'entrée dont le type a la valeur DT_DBTIME avec une colonne de base de données dont le type a la valeur datetime. Pour plus d’informations sur les types de données Integration Services , consultez Types de données d’Integration Services.

La destination ADO NET comporte une entrée standard et une sortie d'erreur.

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

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 :

Pour plus d’informations sur la façon de définir les propriétés, consultez Définir les propriétés d’un composant de flux de données.

Éditeur de destination ADO NET (page Gestionnaire de connexions)

Utilisez la page Gestionnaire de connexions de la boîte de dialogue Éditeur de destination ADO NET pour sélectionner la connexion ADO.NET de la destination. Cette page vous permet également de sélectionner une table ou une vue à partir de la base de données.

Pour ouvrir la page Gestionnaire de connexions

  1. Dans SQL Server Data Tools (SSDT), ouvrez le package Integration Services qui possède la destination ADO NET.

  2. Sous l’onglet Flux de données , double-cliquez sur la destination ADO NET.

  3. Dans l’Éditeur de destination ADO NET, cliquez sur Gestionnaire de connexions.

Options statiques

Connection manager
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 à partir de la boîte de dialogue Configurer le gestionnaire de connexions ADO.NET .

Utiliser une table ou une vue
Sélectionnez une table ou une vue existante dans la liste ou créez une table en cliquant sur Nouvelle.

Nouveau
Créez une table ou vue à l’aide de la boîte de dialogue Créer une table .

Notes

Quand vous cliquez sur Nouvelle, Integration Services génère une instruction CREATE TABLE par défaut, basée sur la source de données connectée. Cette instruction CREATE TABLE par défaut n'inclut pas l'attribut FILESTREAM, même si la table source inclut une colonne dans laquelle l'attribut FILESTREAM est déclaré. Pour exécuter un composant Integration Services avec l'attribut FILESTREAM, implémentez d'abord le stockage FILESTREAM sur la base de données de destination. Ajoutez ensuite l’attribut FILESTREAM à l’instruction CREATE TABLE dans la boîte de dialogue Créer une table . Pour plus d’informations, consultez Données BLOB (Binary Large Object) (SQL Server).

Préversion
Affichez un aperçu des résultats à l’aide de la boîte de dialogue Visualiser les résultats de la requête . L'aperçu peut afficher jusqu'à 200 lignes.

Utiliser l'insertion en bloc le cas échéant
Spécifiez s’il convient d’utiliser l’interface SqlBulkCopy pour améliorer les performances des opérations d’insertion en bloc.

Seuls les fournisseurs ADO.NET qui retournent un objet SqlConnection prennent en charge l’utilisation de l’interface SqlBulkCopy . Le fournisseur de données .NET pour SQL Server (SqlClient) retourne un objet SqlConnection , et un fournisseur personnalisé peut retourner un objet SqlConnection .

Vous pouvez utiliser le fournisseur de données .NET pour SQL Server (SqlClient) pour vous connecter à Microsoft Azure SQL Database.

Si vous sélectionnez Utiliser l’insertion en bloc le cas échéantet affectez à l’option Erreur la valeur Rediriger la ligne, le lot de données que la destination redirige vers la sortie d’erreur peut inclure des lignes correctes. Pour plus d’informations sur la gestion des erreurs dans les opérations en bloc, consultez Gestion des erreurs dans les données. Pour plus d’informations sur l’option Erreur , consultez Éditeur de destination ADO NET (page Sortie d’erreur).

Notes

Si une table source SQL Server ou Sybase inclut une colonne d’identité, vous devez utiliser les tâches d’exécution de requêtes SQL pour activer IDENTITY_INSERT avant la destination ADO NET et le désactiver après. (La propriété de colonne d’identité spécifie une valeur incrémentielle pour la colonne. L’instruction SET IDENTITY_INSERT permet aux valeurs explicites de la table source d’être insérées dans la colonne d’identité de la table de destination.)

Pour exécuter avec succès les instructions SET IDENTITY_INSERT et le chargement des données, vous devez effectuer les opérations suivantes.
1. Utilisez le même gestionnaire de connexions ADO.NET pour les tâches d’exécution de requêtes SQL et la destination ADO NET.
2. Dans le gestionnaire de connexions, définissez la propriété RetainSameConnection et la propriété MultipleActiveResultSets sur True.
3. Sur la destination ADO.NET, définissez la propriété UseBulkInsertWhenPossible sur False.

Pour plus d’informations, consultez SET IDENTITY_INSERT (Transact-SQL) et IDENTITY (Propriété) (Transact-SQL).

Ressources externes

Article technique sur sqlcat.com, traitant du chargement rapide de données sur Azure SQL Database

Éditeur de destination ADO NET (page Mappages)

Utilisez la page Mappages de la boîte de dialogue Éditeur de destination ADO NET pour mapper des colonnes d’entrée à des colonnes de destination.

Pour ouvrir la page Mappages

  1. Dans SQL Server Data Tools (SSDT), ouvrez le package Integration Services qui possède la destination ADO NET.

  2. Sous l’onglet Flux de données , double-cliquez sur la destination ADO NET.

  3. Dans l’Éditeur de destination ADO NET, cliquez sur Mappages.

Options

Colonnes d'entrée disponibles
Affichez la liste des colonnes d'entrée disponibles. Au moyen du glisser-déplacer, mappez les colonnes d'entrée disponibles dans la table sur des colonnes de destination.

Colonnes de destination disponibles
Affichez la liste des colonnes de destination disponibles. Utilisez une opération de glisser-déplacer pour mapper les colonnes de destination disponibles dans la table aux colonnes d'entrée.

Colonne d'entrée
Affichez les colonnes d’entrée que vous avez sélectionnées. Vous pouvez supprimer des mappages en sélectionnant < ignorer > pour exclure des colonnes de la sortie.

Colonne de destination
Indique chaque colonne de destination disponible, qu'elle soit mappée ou non.

Éditeur de destination ADO NET (page Sortie d'erreur)

Utilisez la page Sortie d'erreur de la boîte de dialogue Éditeur de destination ADO NET pour spécifier les options de gestion des erreurs.

Pour ouvrir la page Sortie d'erreur

  1. Dans SQL Server Data Tools (SSDT), ouvrez le package Integration Services qui possède la destination ADO NET.

  2. Sous l’onglet Flux de données , double-cliquez sur la destination ADO NET.

  3. Dans l’Éditeur de destination ADO NET, cliquez sur Sortie d’erreur.

Options

Entrée ou Sortie
Affichez le nom de l'entrée.

Colonne
Non utilisé.

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
Non utilisé.

Description
Affichez la description de l'opération.

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.