Source ExcelExcel Source

S’APPLIQUE À : ouiSQL Server,notamment sur Linux ouiAzure SQL Database ouiAzure SQL Data Warehouse nonParallel Data WarehouseAPPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

La source Excel extrait des données de feuilles de calcul ou de plages dans des classeurs MicrosoftMicrosoft Excel.The Excel source extracts data from worksheets or ranges in MicrosoftMicrosoft Excel workbooks.

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).For detailed info about connecting to Excel files, and about limitations and known issues for loading data from or to Excel files, see Load data from or to Excel with SQL Server Integration Services (SSIS).

Modes d'accèsAccess Modes

La source Excel fournit quatre modes d'accès aux données différents pour l'extraction des données :The Excel source provides four different data access modes for extracting data:

  • Une table ou une vue.A table or view.

  • Une table ou une vue spécifiée dans une variable.A table or view specified in a variable.

  • Les résultats d'une instruction SQL.The results of an SQL statement. La requête peut être une requête paramétrable.The query can be a parameterized query.

  • Les résultats d'une instruction SQL stockée dans une variable.The results of an SQL statement stored in a 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.The Excel source uses an Excel connection manager to connect to a data source, and the connection manager specifies the workbook file to use. Pour plus d'informations, consultez Excel Connection Manager.For more information, see Excel Connection Manager.

La source Excel a une sortie normale et une sortie d'erreur.The Excel source has one regular output and one error output.

Configuration d'une source ExcelExcel Source Configuration

Vous pouvez définir les propriétés par le biais du concepteur SSISSSIS ou par programmation.You can set properties through SSISSSIS Designer or programmatically.

La boîte de dialogue Éditeur avancé reflète toutes les propriétés qui peuvent être définies par programmation.The Advanced Editor dialog box reflects all the properties that can be set programmatically. 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 :For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

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.For information about looping through a group of Excel files, see Loop through Excel Files and Tables by Using a Foreach Loop Container.

Éditeur de source Excel (page Gestionnaire de connexions)Excel Source Editor (Connection Manager Page)

Le nœud Gestionnaire de connexions de la boîte de dialogue Éditeur de source Excel vous permet de sélectionner le classeur Microsoft ExcelMicrosoft Excel de la source à utiliser.Use the Connection Manager node of the Excel Source Editor dialog box to select the Microsoft ExcelMicrosoft Excel workbook for the source to use. La source Excel lit les données à partir d'une feuille de calcul ou d'une plage nommée dans un classeur existant.The Excel source reads data from a worksheet or named range in an existing workbook.

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é.The CommandTimeout property of the Excel source is not available in the Excel Source Editor, but can be set by using the Advanced Editor. Pour plus d’informations sur cette propriété, consultez la section sur la source Excel dans Propriétés personnalisées d’Excel.For more information on this property, see the Excel Source section of Excel Custom Properties.

Options statiquesStatic Options

Gestionnaire de connexions OLE DBOLE DB connection manager
Sélectionnez un gestionnaire de connexions Excel existant dans la liste ou créez une connexion en cliquant sur Nouveau.Select an existing Excel connection manager from the list, or create a new connection by clicking New.

NouveauNew
Créez un gestionnaire de connexions à l’aide de la boîte de dialogue Gestionnaire de connexions Excel .Create a new connection manager by using the Excel Connection Manager dialog box.

Mode d'accès aux donnéesData access mode
Spécifiez la méthode de sélection des données dans la source.Specify the method for selecting data from the source.

ValeurValue DescriptionDescription
Table ou vueTable or view Récupérez des données à partir d'une feuille de calcul ou d'une plage nommée dans le fichier Excel.Retrieve data from a worksheet or named range in the Excel file.
Variable de nom de table ou de vueTable name or view name variable Spécifiez le nom de la feuille de calcul ou de la plage dans une variable.Specify the worksheet or range name in a variable.

Informations connexes : Utiliser des variables dans des packagesRelated information: Use Variables in Packages
Commande SQLSQL command Récupérez des données à partir du fichier Excel à l'aide d'une requête SQL.Retrieve data from the Excel file by using a SQL query.
Commande SQL à partir d'une variableSQL command from variable Spécifiez le texte de la requête SQL dans une variable.Specify the SQL query text in a variable.

AperçuPreview
Affichez un aperçu des résultats à l’aide de la boîte de dialogue Vue de données .Preview results by using the Data View dialog box. L'aperçu peut afficher jusqu'à 200 lignes.Preview can display up to 200 rows.

Options dynamiques du mode d'accès aux donnéesData Access Mode Dynamic Options

Mode d'accès aux données = Table ou vueData access mode = Table or view

Nom de la feuille ExcelName of the Excel sheet
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.Select the name of the worksheet or named range from a list of those available in the Excel workbook.

Mode d'accès aux données = Variable de nom de table ou de vueData access mode = Table name or view name variable

Nom de la variableVariable name
Sélectionnez la variable contenant le nom de la feuille de calcul ou de la plage nommée.Select the variable that contains the name of the worksheet or named range.

Mode d'accès aux données = Commande SQLData access mode = SQL command

Texte de la commande SQLSQL command text
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.Enter the text of a SQL query, build the query by clicking Build Query, or browse to the file that contains the query text by clicking Browse.

ParamètresParameters
Si vous avez entré une requête paramétrable en spécifiant ?If you have entered a parameterized query by using ? 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.as a parameter placeholder in the query text, use the Set Query Parameters dialog box to map query input parameters to package variables.

Build queryBuild query
Utilisez la boîte de dialogue Générateur de requêtes pour construire la requête SQL visuellement.Use the Query Builder dialog box to construct the SQL query visually.

ParcourirBrowse
Dans la boîte de dialogue Ouvrir , localisez le fichier qui contient le texte de la requête SQL.Use the Open dialog box to locate the file that contains the text of the SQL query.

Analyser la requêteParse query
Vérifiez la syntaxe du texte de la requête.Verify the syntax of the query text.

Mode d'accès aux données = Commande SQL à partir d'une variableData access mode = SQL command from variable

Nom de la variableVariable name
Sélectionnez la variable qui contient le texte de la requête SQL.Select the variable that contains the text of the SQL query.

Éditeur de source Excel (page Colonnes)Excel Source Editor (Columns Page)

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).Use the Columns page of the Excel Source Editor dialog box to map an output column to each external (source) column.

OptionsOptions

Colonnes externes disponiblesAvailable External Columns
Affiche la liste des colonnes externes disponibles dans la source de données.View the list of available external columns in the data source. Vous ne pouvez pas ajouter ou supprimer des colonnes à l'aide de cette table.You cannot use this table to add or delete columns.

Colonne externeExternal Column
Affiche les colonnes externes (sources) dans l'ordre de lecture de la tâche.View external (source) columns in the order in which the task will read them. 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.You can change this order by first clearing the selected columns in the table discussed above, and then selecting external columns from the list in a different order.

Colonne de sortieOutput Column
Spécifiez un nom unique pour chaque colonne de sortie.Provide a unique name for each output column. 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.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name. Le nom fourni sera affiché dans le concepteur SSISSSIS .The name provided will be displayed within SSISSSIS Designer.

Éditeur de source Excel (page Sortie d'erreur)Excel Source Editor (Error Output Page)

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.Use the Error Output page of the Excel Source Editor dialog box to select error handling options and to set properties on error output columns.

OptionsOptions

Entrée ou SortieInput or Output
Affichez le nom de la source de données.View the name of the data source.

ColonneColumn
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.View the external (source) columns that you selected on the Connection Manager page of the Excel Source Editordialog box.

ErreurError
Indiquez ce qui doit se produire lorsqu'une erreur se produit : ignorer l'échec, rediriger la ligne ou faire échouer le composant.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

Rubriques connexes : Gestion des erreurs dans les donnéesRelated Topics: Error Handling in Data

TroncationTruncation
Indiquez ce qui doit se produire lorsqu'une troncation se produit : ignorer l'échec, rediriger la ligne ou faire échouer le composant.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
Affiche la description de l'erreur.View the description of the error.

Définir cette valeur sur les cellules sélectionnéesSet this value to selected cells
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.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

AppliquerApply
Appliquez l'option de gestion des erreurs aux cellules sélectionnées.Apply the error handling option to the selected cells.

Charger des données depuis ou vers Excel avec SQL Server Integration Services (SSIS)Load data from or to Excel with SQL Server Integration Services (SSIS)
Destination ExcelExcel Destination
Gestionnaire de connexions ExcelExcel Connection Manager