Destination ODBC

  • Article

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

La destination ODBC charge en masse les données dans les tables de base de données compatibles ODBC. La destination ODBC utilise un gestionnaire de connexions ODBC pour se connecter à la source de données.

Une destination ODBC 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, mais en fonction des propriétés des colonnes de destination, des erreurs peuvent se produire si aucune colonne d’entrée n’est mappée aux colonnes de destination. Par exemple, si une colonne de destination n'autorise pas les valeurs null, une colonne d'entrée doit être mappée à cette colonne. En outre, même si des colonnes de types différents peuvent être mappées, si les données d'entrée ne sont pas compatibles pour le type de colonne de destination, une erreur se produit au moment de l'exécution. En fonction du comportement des erreurs configuré, l'erreur sera ignorée, entraînera un échec ou la ligne sera envoyée à la sortie d'erreur.

La destination ODBC comporte une sortie standard et une sortie d'erreur.

Options de chargement

La destination ODBC peut utiliser l'un des deux modules de charge d'accès. Vous définissez le mode dans l’Éditeur de source ODBC (page Gestionnaire de connexions). Les deux modes sont :

  • Lot: dans ce mode, la destination ODBC tente d’utiliser la méthode d’insertion la plus efficace en fonction des capacités perçues du fournisseur ODBC. Pour la plupart des fournisseurs modernes ODBC, cela implique de préparer une instruction INSERT avec des paramètres, puis d’utiliser une liaison de paramètre de table selon les lignes (où la taille de la table est contrôlée par la propriété BatchSize ). Si vous sélectionnez Lot et que le fournisseur ne prend pas en charge cette méthode, la destination ODBC bascule automatiquement en mode Ligne par ligne .

  • Ligne par ligne: dans ce mode, la destination ODBC prépare une instruction INSERT avec des paramètres et utilise SQL Execute pour insérer les lignes une par une.

Gestion des erreurs

La destination ODBC a une sortie d'erreur. La sortie d'erreur du composant contient les colonnes de sortie suivantes :

  • Code d’erreur: numéro qui correspond à l’erreur actuelle. Consultez la documentation de votre base de données source pour obtenir la liste des erreurs. Pour obtenir la liste des codes d'erreur SSIS, consultez le Guide de référence des erreurs et des événements SSIS.

  • Colonne d’erreur: colonne source à l’origine de l’erreur (pour les erreurs de conversion).

  • Colonnes de données de sortie standard.

Selon le comportement paramétré pour les erreurs, la destination ODBC prend en charge les erreurs de retour (conversion de données, troncation) qui se produisent pendant le processus de récupération dans la sortie d'erreur. Pour plus d’informations, consultez Éditeur de source ODBC (page Sortie d’erreur).

Parallélisme

Il n'existe aucune limitation quant au nombre de composants de destination ODBC pouvant s'exécuter en parallèle sur la même table ou des tables différentes, sur le même ordinateur ou sur des ordinateurs différents (autre que les limites de session globale habituelles).

Toutefois, les limites du fournisseur ODBC utilisé peuvent limiter le nombre de connexions simultanées par le fournisseur. Ces limites restreignent le nombre d'instances parallèles prises en charge pour la destination ODBC. Le développeur SSIS doit avoir connaissance des limites de tout fournisseur ODBC utilisé et en tenir compte lors de la génération de packages SSIS.

Vous devez également savoir qu'un chargement simultané dans la même table peut réduire les performances en raison du verrouillage des enregistrements standard. Cela dépend des données chargées et de l'organisation de table.

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

Vous pouvez consigner dans un journal les appels que la source ODBC effectue vers des 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 ODBC. Pour consigner les appels effectués par la destination ODBC vers des fournisseurs ODBC externes, activez la trace du gestionnaire de pilotes ODBC. Pour plus d’informations, consultez la documentation Microsoft sur la génération d’une trace ODBC avec l’administrateur de sources de données ODBC.

Configuration de la destination ODBC

Vous pouvez configurer la destination ODBC par programmation ou par le biais du concepteur SSIS

Pour plus d’informations, consultez l’une des rubriques suivantes :

La boîte de dialogue Éditeur avancé contient les propriétés qui peuvent être définies par programme.

Pour ouvrir la boîte de dialogue Éditeur avancé :

  • Sur l’écran Flux de données de votre projet SQL Server 2019 Integration Services (SSIS) , cliquez avec le bouton droit sur la destination ODBC, puis sélectionnez Afficher l’éditeur avancé.

Pour plus d’informations sur les propriétés que vous pouvez définir dans la boîte de dialogue Éditeur avancé, consultez Propriétés personnalisées des destinations ODBC.

Dans cette section

Éditeur de destination ODBC (page Gestionnaire de connexions)

Utilisez la page Gestionnaire de connexions de la boîte de dialogue Éditeur de destination ODBC pour sélectionner le gestionnaire de connexions ODBC 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 l'Éditeur de destination ODBC (page Gestionnaire de connexions)

Liste des tâches

  • Dans SQL Server Data Tools, ouvrez le package SQL Server 2019 Integration Services (SSIS) qui possède la destination ODBC.

  • Sous l’onglet Flux de données , double-cliquez sur la destination ODBC.

  • Dans l' Éditeur de destination ODBC, cliquez sur Gestionnaire de connexions.

Options

Gestionnaire de connexions

Sélectionnez un gestionnaire de connexions ODBC existant dans la liste ou cliquez sur Nouveau pour créer une nouvelle connexion. La connexion peut concerner n'importe quelle base de données prise en charge par ODBC.

Nouveau

Cliquez sur Nouveau. La boîte de dialogue Configurer l'Éditeur du gestionnaire de connexions ODBC s'ouvre et vous permet de créer un nouveau gestionnaire de connexions.

Mode d'accès aux données

Spécifiez la méthode de chargement des données dans la destination. Ces fonctions sont répertoriées dans le tableau suivant :

Option Description
Nom de la table - Lot Sélectionnez cette option pour configurer la destination ODBC en mode par lot. Lorsque vous sélectionnez cette option, les options suivantes sont disponibles :
Nom de la table ou de la vue: sélectionnez une table ou une vue disponible dans la liste.

Cette liste contient les 1 000 premières tables uniquement. Si votre base de données contient plus de 1 000 tables, vous pouvez taper le début du nom d'une table ou utiliser le caractère générique (*) pour entrer une partie du nom afin d'afficher la table ou les tables que vous souhaitez utiliser.

Taille du lot: entrez la taille du lot pour le chargement en bloc. Il s'agit du nombre de lignes chargées dans un même lot.
Nom de la table - Ligne par ligne Sélectionnez cette option pour configurer la destination ODBC de manière à insérer les lignes dans la table de destination une par une. Lorsque vous sélectionnez cette option, l'option suivante est disponible :
Nom de la table ou de la vue: sélectionnez dans la liste une table ou une vue disponible dans la base de données.

Cette liste contient les 1 000 premières tables uniquement. Si votre base de données contient plus de 1 000 tables, vous pouvez taper le début du nom d'une table ou utiliser le caractère générique (*) pour entrer une partie du nom afin d'afficher la table ou les tables que vous souhaitez utiliser.

PRÉVERSION

Cliquez sur Aperçu pour afficher jusqu'à 200 lignes de données pour la table sélectionnée.

Éditeur de destination ODBC (page Mappages)

La page Mappages de la boîte de dialogue Éditeur de destination ODBC vous permet de mapper les colonnes d’entrée aux colonnes de destination.

Options

Colonnes d’entrée disponibles

Liste des colonnes d'entrée disponibles. Par glisser-déplacer, mappez une colonne d'entrée à une colonne de destination disponible.

Colonnes de destination disponibles

Liste des colonnes de destination disponibles. Par glisser-déplacer, mappez une colonne de destination à une colonne d'entrée disponible.

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> de manière à exclure des colonnes de la sortie.

Colonne de destination

Affiche toutes les colonnes de destination disponibles, mappées et non mappées.

Éditeur de destination ODBC (page Sortie d'erreur)

Utilisez la page Sortie d'erreur de la boîte de dialogue Éditeur de destination ODBC pour sélectionner les options de gestion des erreurs.

Pour ouvrir l'Éditeur de destination ODBC (page Sortie d'erreur)

Liste des tâches

  • Dans SQL Server Data Tools, ouvrez le package SQL Server 2019 Integration Services (SSIS) qui possède la destination ODBC.

  • Sous l’onglet Flux de données , double-cliquez sur la destination ODBC.

  • Dans l' Éditeur de destination ODBC, cliquez sur Sortie d'erreur.

Options

Entrée/sortie

Affichez le nom de la source de données.

Colonne

Non utilisé.

Error

Sélectionnez la façon dont la destination ODBC doit gérer les erreurs dans un flux : ignorer l'échec, rediriger la ligne ou faire échouer le composant.

Troncation

Sélectionnez la façon dont la destination ODBC doit gérer la troncation dans un flux : ignorer l'échec, rediriger la ligne ou faire échouer le composant.

Description

Affichez la description d'une erreur.

Définir cette valeur sur les cellules sélectionnées

Sélectionnez la façon dont la destination ODBC gère 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 les options de gestion des erreurs aux cellules sélectionnées.

Options de gestion des erreurs

Vous pouvez utiliser les options suivantes pour configurer la façon dont la destination ODBC gère les erreurs et les troncations.

Composant défaillant

La tâche de flux de données échoue lorsqu'une erreur ou une troncation a lieu. Il s'agit du comportement par défaut.

Ignorer l'échec

L'erreur ou la troncation est ignorée.

Rediriger le flux

La ligne qui provoque l'erreur ou la troncation est dirigée vers la sortie d'erreur de la destination ODBC. Pour plus d'informations, consultez Destination ODBC.