Requêtes Integration Services (SSIS)Integration Services (SSIS) Queries

La tâche Exécution SQL, la source OLE DB, la destination OLE DB et la transformation de recherche peuvent utiliser des requêtes SQL.The Execute SQL task, the OLE DB source, the OLE DB destination, and the Lookup transformation can use SQL queries. Dans la tâche d'exécution SQL, les instructions SQL peuvent créer, mettre à jour et supprimer des données et des objets de base de données, exécuter des procédures stockées et des instructions SELECT.In the Execute SQL task, the SQL statements can create, update, and delete database objects and data; run stored procedures; and perform SELECT statements. Dans la source OLE DB et la transformation de recherche, les instructions SQL sont généralement des instructions SELECT ou EXEC.In the OLE DB source and the Lookup transformation, the SQL statements are typically SELECT statements or EXEC statements. Cette dernière exécute le plus souvent des procédures stockées qui retournent des jeux de résultats.The latter most frequently run stored procedures that return result sets.

Un requête peut être analysée pour déterminer si elle est valide.A query can be parsed to establish whether it is valid. Pendant l’analyse d’une requête utilisant une connexion vers SQL ServerSQL Server, la requête est analysée, exécutée et le résultat de l’exécution (succès ou échec) est affecté au résultat de l’analyse.When parsing a query that uses a connection to SQL ServerSQL Server, the query is parsed, executed, and the execution outcome (success or failure) is assigned to the parsing outcome. Si la requête utilise une connexion à des données qui ne sont pas SQL ServerSQL Server, l'instruction est seulement analysée.If the query uses a connection to a data other than SQL ServerSQL Server, the statement is parsed only.

Vous pouvez fournir l’instruction SQL de plusieurs manières :You can provide the SQL statement in the following ways:

  1. En l’entrant directement dans le concepteurEnter it directly in the designer.
  2. En spécifiant une connexion à un fichier qui contient l’instructionSpecify a connection to a file contains the statement.
  3. En spécifiant une variable qui contient l’instructionSpecify a variable that contains the statement.

SQL à entrée directeDirect Input SQL

Le Générateur de requêtes est disponible dans l'interface utilisateur pour la tâche d'exécution SQL, la source OLE DB, la destination OLE DB et la transformation de recherche.Query Builder is available in the user interface for the Execute SQL task, the OLE DB source, the OLE DB destination, and the Lookup transformation. Le générateur de requêtes présente les avantages suivants :Query Builder offers the following advantages:

  • Travailler visuellement ou avec des commandes SQL.Work visually or with SQL commands.

    Le Générateur de requêtes comprend des volets graphiques qui composent visuellement votre requête et un volet de texte qui contient le texte SQL de votre requête.Query Builder includes graphical panes that compose your query visually and a text pane that displays the SQL text of your query. Vous pouvez travailler dans le volet graphique ou le volet de texte.You can work in either the graphical or text panes. Le Générateur de requêtes synchronise les vues afin de toujours faire correspondre le texte de la requête et la représentation graphique.Query Builder synchronizes the views so that the query text and graphical representation always match.

  • Joindre des tables liées.Join related tables.

    Si vous ajoutez plusieurs tables à votre requête, le générateur de requêtes détermine automatiquement la manière dont les tables sont associées entre elles et construit la commande de jointure appropriée.If you add more than one table to your query, Query Builder automatically determines how the tables are related and constructs the appropriate join command.

  • Interroger ou mettre à jour les bases de données.Query or update databases.

    Vous pouvez utiliser le générateur de requêtes pour renvoyer des données à l'aide d'instructions Transact-SQL SELECT, ou pour créer des requêtes qui mettent à jour, ajoutent ou suppriment des enregistrements dans une base de données.You can use Query Builder to return data using Transact-SQL SELECT statements, or to create queries that update, add, or delete records in a database.

  • Afficher et modifier les résultats immédiatement.View and edit results immediately.

    Vous pouvez exécuter votre requête et travailler avec un jeu d'enregistrements dans une grille qui vous permet de faire défiler et de modifier les enregistrements de la base de données.You can execute your query and work with a recordset in a grid that lets you scroll through and edit records in the database.

    Bien que le générateur de requêtes soit limité visuellement à la création de requêtes SELECT, vous pouvez tapez le SQL pour d'autres types d'instructions, par exemple des instructions DELETE et UPDATE, dans le volet de texte.Although Query Builder is visually limited to creating SELECT queries, you can type the SQL for other types of statements such as DELETE and UPDATE statements in the text pane. Le volet graphique est automatiquement mis à jour pour prendre en compte l'instruction SQL que vous avez tapée.The graphical pane is automatically updated to reflect the SQL statement that you typed.

    Vous pouvez également fournir une entrée directe en tapant la requête dans la boîte de dialogue de la tâche ou du composant de flux de données ou dans la fenêtre Propriétés.You can also provide direct input by typing the query in the task or data flow component dialog box or the Properties window.

    Pour plus d’informations, consultez Générateur de requêtes.For more information, see Query Builder.

SQL dans des fichiersSQL in Files

L'instruction SQL pour la tâche d'exécution SQL peut également se trouver dans un fichier distinct.The SQL statement for the Execute SQL task can also reside in a separate file. Par exemple, vous pouvez écrire des requêtes à l'aide d'outils tels que l'éditeur de requêtes dans SQL Server Management StudioSQL Server Management Studio, enregistrer la requête dans un fichier, puis lire la requête à partir du fichier lors de l'exécution d'un package.For example, you can write queries using tools such as the Query Editor in SQL Server Management StudioSQL Server Management Studio, save the query to a file, and then read the query from the file when running a package. Le fichier ne peut contenir que les instructions SQL à exécuter et des commentaires.The file can contain only the SQL statements to run and comments. Pour utiliser une instruction SQL stockée dans un fichier, vous devez fournir une connexion de fichiers qui spécifie le nom et l'emplacement du fichier.To use a SQL statement stored in a file, you must provide a file connection that specifies the file name and location. Pour plus d’informations, consultez File Connection Manager.For more information, see File Connection Manager.

SQL dans des variablesSQL in Variables

Si la source de l'instruction SQL dans la tâche d'exécution SQL est une variable, vous fournissez le nom de la variable qui contient la requête.If the source of the SQL statement in the Execute SQL task is a variable, you provide the name of the variable that contains the query. La propriété Value de la variable contient le texte de la requête.The Value property of the variable contains the query text. Vous définissez la propriété ValueType de la variable en tant que type de données String, puis vous tapez ou copiez l’instruction SQL dans la propriété Value.You set the ValueType property of the variable to a string data type and then type or copy the SQL statement into the Value property. Pour plus d’informations, consultez Variables Integration Services (SSIS) et Utiliser des variables dans des packages.For more information, see Integration Services (SSIS) Variables and Use Variables in Packages.

Générateur de requêtes, boîte de dialogueQuery Builder dialog box

Utilisez la boîte de dialogue Générateur de requêtes pour créer une requête à utiliser dans la tâche Exécution SQL, la source OLE DB et la destination OLE DB, ainsi que la transformation de recherche.Use the Query Builder dialog box to create a query for use in the Execute SQL task, the OLE DB source and the OLE DB destination, and the Lookup transformation.

Vous pouvez utiliser le générateur de requêtes pour réaliser les tâches suivantes :You can use Query Builder to perform the following tasks:

  • Utilisation d'une représentation graphique d'une requête ou des commandes SQL Le générateur de requêtes inclut un volet qui affiche votre requête graphiquement et un volet qui affiche le texte SQL de votre requête.Working with a graphical representation of a query or with SQL commands Query Builder includes a pane that displays your query graphically and a pane that displays the SQL text of your query. Vous pouvez travailler dans le volet graphique ou dans le volet texte.You can work in either the graphical pane or the text pane. Le générateur de requêtes synchronise les vues de manière à ce qu'elles soient toujours actualisées.Query Builder synchronizes the views so that they are always current.

  • Jointure de tables associées Si vous ajoutez plusieurs tables à votre requête, le générateur de requêtes détermine automatiquement la manière dont les tables sont associées et construit la commande de jointure appropriée.Joining related tables If you add more than one table to your query, Query Builder automatically determines how the tables are related and constructs the appropriate join command.

  • Requête ou mise à jour de bases de données Vous pouvez utiliser le générateur de requêtes pour renvoyer des données à l’aide d’instructions Transact-SQL SELECT et pour créer des requêtes qui mettent à jour, ajoutent ou suppriment des enregistrements dans une base de données.Querying or updating databases You can use Query Builder to return data by using Transact-SQL SELECT statements and to create queries that update, add, or delete records in a database.

  • Affichage et modification immédiate des résultats Vous pouvez exécuter votre requête et travailler avec un jeu d'enregistrements dans une grille qui vous permet de faire défiler et de modifier les enregistrements de la base de données.Viewing and editing results immediately You can run your query and work with a recordset in a grid that allows you to scroll through and edit records in the database.

    Les outils graphiques de la boîte de dialogue Générateur de requêtes permettent de créer des requêtes par glisser-déplacer.The graphical tools in the Query Builder dialog box let you construct queries using drag-and-drop operations. Par défaut, la boîte de dialogue Générateur de requêtes crée des requêtes SELECT, mais vous pouvez également générer des requêtes INSERT, UPDATE ou DELETE.By default, the Query Builder dialog box constructs SELECT queries, but you can also build INSERT, UPDATE, or DELETE queries. Tous les types d'instructions SQL peuvent être analysés et exécutés dans la boîte de dialogue Générateur de requêtes .All types of SQL statements can be parsed and run in the Query Builder dialog box. Pour plus d’informations sur les instructions SQL dans les packages, consultez Requêtes Integration Services (SSIS).For more information about SQL statements in packages, see Integration Services (SSIS) Queries.

    Pour en savoir plus sur le langage Transact-SQL et sa syntaxe, consultez Référence Transact-SQL (moteur de base de données).To learn more about the Transact-SQL language and its syntax, see Transact-SQL Reference (Database Engine).

    Vous pouvez aussi utiliser des variables dans une requête pour fournir des valeurs à un paramètre d'entrée, pour capturer les valeurs des paramètres de sortie et pour stocker des codes de retour.You can also use variables in a query to provide values to an input parameter, to capture values of output parameters, and to store return codes. Pour en savoir plus sur l’utilisation de variables dans les requêtes utilisées par les packages, consultez Tâche d’exécution de requêtes SQL, Source OLE DBet Integration Services (SSIS) Queries.To learn more about using variables in the queries that packages use, see Execute SQL Task, OLE DB Source, and Integration Services (SSIS) Queries. Pour en savoir plus sur l’utilisation de variables dans la tâche d’exécution de requêtes SQL, consultez Paramètres et codes de retour dans la tâche d’exécution SQL et Ensembles de résultats dans la tâche d’exécution SQL.To learn more about using variables in the Execute SQL Task, see Parameters and Return Codes in the Execute SQL Task and Result Sets in the Execute SQL Task.

    Les transformations de recherche et de recherche floue peuvent aussi utiliser des variables avec des paramètres et des codes de retour.The Lookup and Fuzzy lookup transformations can also use variables with parameters and return codes. Les informations relatives à la source OLE DB s'appliquent également à ces deux transformations.The information about the OLE DB source applies to these two transformations also.

OptionsOptions

Barre d'outilsToolbar
Utilisez la barre d'outils pour gérer les datasets, sélectionner les volets à afficher et contrôler les fonctions de requête.Use the toolbar to manage datasets, select panes to display, and control query functions.

ValueValue DescriptionDescription
Afficher/Masquer le volet DiagrammeShow/Hide Diagram Pane Affiche ou masque le volet Diagramme .Shows or hides the Diagram pane.
Afficher/Masquer le volet GrilleShow/Hide Grid Pane Affiche ou masque le volet Grille .Shows or hides the Grid pane.
Afficher/Masquer le volet SQLShow/Hide SQL Pane Affiche ou masque le volet SQL .Shows or hides the SQL pane.
Afficher/Masquer le volet RésultatsShow/Hide Results Pane Affiche ou masque le volet Résultats .Shows or hides the Results pane.
ExécuterRun Exécute la requête.Runs the query. Les résultats s'affichent dans le volet Résultats.Results are displayed in the result pane.
Vérifier SQLVerify SQL Vérifie que l'instruction SQL est valide.Verifies that the SQL statement is valid.
Tri croissantSort Ascending Trie dans l'ordre croissant les lignes de sortie sur la colonne sélectionnée du volet de la grille.Sorts output rows on the selected column in the grid pane, in ascending order.
Tri décroissantSort Descending Trie dans l'ordre décroissant les lignes de sortie sur la colonne sélectionnée du volet de la grille.Sorts output rows on the selected column in the grid pane, in descending order.
Supprimer le filtreRemove Filter Sélectionnez le nom d'une colonne dans le volet de la grille, puis choisissez Supprimer le filtre pour supprimer les critères de tri de la colonne.Select a column name in the grid pane, and then click Remove Filter to remove sort criteria for the column.
Utiliser GROUP BYUse Group By Ajoute la fonctionnalité GROUP BY à la requête.Adds GROUP BY functionality to the query.
Ajouter une tableAdd Table Ajoute une table à la requête.Adds a new table to the query.

Définition de la requêteQuery Definition
La définition de la requête fournit une barre d'outils et des volets dans lesquels définir et tester la requête.The query definition provides a toolbar and panes in which to define and test the query.

VoletPane DescriptionDescription
VoletDiagramme .Diagram pane Affiche la requête dans un diagramme.Displays the query in a diagram. Le diagramme illustre les tables contenues dans la requête et leur mode de jointure.The diagram shows the tables included in the query, and how they are joined. Activez ou désactivez la case à cocher correspondant à une colonne de la table pour l'ajouter ou la supprimer du résultat de la requête.Select or clear the check box next to a column in a table to add or remove it from the query output.

Lorsque vous ajoutez des tables à la requête, le Générateur de requêtes crée des jointures entre les tables basées sur les tables, en fonction des clés de la table.When you add tables to the query, Query Builder creates joins between tables based on tables, depending on the keys in the table. Pour ajouter une jointure, faites glisser le champ d'une table vers un champ situé dans une autre table.To add a join, drag a field from one table onto a field in another table. Pour gérer une jointure, cliquez dessus avec le bouton droit, puis sélectionnez une option du menu.To manage a join, right-click the join, and then select a menu option.

Cliquez avec le bouton droit sur le volet Diagramme pour ajouter ou supprimer des tables, sélectionner toutes les tables et afficher ou masquer des volets.Right-click the Diagram pane to add or remove tables, select all the tables, and show or hide panes.
VoletGrille Grid pane Affiche la requête dans une grille.Displays the query in a grid. Vous pouvez utiliser ce volet pour ajouter et supprimer des colonnes dans la requête et modifier les paramètres de chaque colonne.You can use this pane to add to and remove columns from the query and change the settings for each column.
VoletSQL SQL pane Affiche la requête sous forme de texte SQL.Displays the query as SQL text. Les modifications effectuées dans le volet Diagramme et le volet Grille sont affichées ici et les modifications apportées ici sont affichées dans les volets Diagramme et Grille .Changes made in the Diagram pane and the Grid pane will appear here, and changes made here will appear in the Diagram pane and the Grid pane.
VoletRésultats Results pane Affiche les résultats de la requête lorsque vous cliquez sur Exécuter dans la barre d'outils.Displays the results of the query when you click Run on the toolbar.