Partager via


Source Excel

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

La source Excel extrait des données de feuilles de calcul ou de plages dans des classeurs Microsoft Excel.

Important

Pour obtenir des informations détaillées sur la connexion à des fichiers Excel, et sur les limitations et les problèmes connus liés au chargement de données depuis ou vers des fichiers Excel, consultez Charger des données depuis ou vers Excel avec SQL Server Integration Services (SSIS).

Modes d'accès

La source Excel 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.

  • Résultats d’une instruction SQL. La requête peut être une requête paramétrable.

  • Résultats d’une instruction SQL stockée dans une variable.

La source Excel utilise à un gestionnaire de connexions Excel pour se connecter à une source de données ; ce gestionnaire spécifie le classeur à utiliser. Pour plus d'informations, consultez Excel Connection Manager.

La source Excel a une sortie normale et une sortie d'erreur.

Configuration d'une source Excel

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 toutes 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 le bouclage dans un groupe de fichiers Excel, consultez Effectuer une boucle dans des fichiers et des tables Excel en utilisant un conteneur de boucles Foreach.

Éditeur de source Excel (page Gestionnaire de connexions)

Le nœud Gestionnaire de connexions de la boîte de dialogue Éditeur de source Excel vous permet de sélectionner le classeur Microsoft Excel de la source à utiliser. La source Excel lit les données à partir d'une feuille de calcul ou d'une plage nommée dans un classeur existant.

Notes

La propriété CommandTimeout de la source Excel n’est pas disponible dans l’Éditeur de source Excel, mais peut être définie à l’aide de l’Éditeur avancé. Pour plus d’informations sur cette propriété, consultez la section sur la source Excel dans Propriétés personnalisées d’Excel.

Options statiques

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

Nouveau
Créez un gestionnaire de connexions à l’aide de la boîte de dialogue Gestionnaire de connexions Excel .

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

Valeur Description
Table ou vue Récupérez des données à partir d'une feuille de calcul ou d'une plage nommée dans le fichier Excel.
Variable de nom de table ou de vue Spécifiez le nom de la feuille de calcul ou de la plage dans une variable.

Informations connexes : Utiliser des variables dans des packages
Commande SQL Récupérez des données à partir du fichier Excel à l'aide d'une requête SQL.
Commande SQL à partir d'une variable Spécifiez le texte de la requête SQL dans une variable.

Préversion
Affichez un aperçu des résultats à l’aide de la boîte de dialogue Vue de données . L'aperç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 feuille Excel
Sélectionnez le nom de la feuille de calcul ou de la plage nommée dans la liste des éléments disponibles dans le classeur Excel.

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

Nom de la variable
Sélectionnez la variable contenant le nom de la feuille de calcul ou de la plage nommée.

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

Texte de la commande SQL
Entrez le texte d’une requête SQL, créez la requête en cliquant sur Générer une requêteou parcourez l’arborescence jusqu’au 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 Excel (page Colonnes)

La page Colonnes de la boîte de dialogue Éditeur de source Excel vous permet de 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) dans l'ordre de lecture de la tâche. Vous pouvez modifier cet ordre en désactivant les colonnes sélectionnées dans la table mentionnée ci-dessus, puis en sélectionnant les colonnes externes dans la liste, dans 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 fourni sera affiché dans le concepteur SSIS .

Éditeur de source Excel (page Sortie d'erreur)

La page Sortie d’erreur de la boîte de dialogue Éditeur de source Excel 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 ou Sortie
Affichez le nom de la source de données.

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

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

Sujets 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.

Charger des données depuis ou vers Excel avec SQL Server Integration Services (SSIS)
Destination Excel
Gestionnaire de connexions Excel