Type de connexion SQL Server (SSRS)SQL Server Connection Type (SSRS)

Pour inclure des données d'une base de données SQL ServerSQL Server dans votre rapport, vous devez avoir un dataset basé sur une source de données de rapport de type MicrosoftMicrosoft SQL ServerSQL Server.To include data from a SQL ServerSQL Server database in your report, you must have a dataset that is based on a report data source of type MicrosoftMicrosoft SQL ServerSQL Server. Ce type de source de données intégré est basé sur l’extension de données MicrosoftMicrosoft SQL ServerSQL Server .This built-in data source type is based on the MicrosoftMicrosoft SQL ServerSQL Server data extension. Ce type de source de données vous permet de vous connecter et de récupérer des données à partir de la version actuelle et des versions antérieures des bases de données SQL ServerSQL Server .Use this data source type to connect to and retrieve data from the current version and earlier versions of SQL ServerSQL Server databases.

Cette extension de données prend en charge des paramètres à valeurs multiples, agrégats de serveur et informations d'identification gérés séparément de la chaîne de connexion.This data extension supports multivalue parameters, server aggregates, and credentials managed separately from the connection string.

Utilisez les informations de cette rubrique pour générer une source de données.Use the information in this topic to build a data source. Pour obtenir des instructions pas à pas, consultez Ajouter et vérifier une connexion de données (Générateur de rapports et SSRS).For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

Chaîne de connexion Connection String

Lorsque vous vous connectez à une base de données SQL ServerSQL Server , vous vous connectez à l'objet de base de données d'une instance de SQL ServerSQL Server sur un serveur.When you connect to a SQL ServerSQL Server database, you are connecting to the database object in an instance of SQL ServerSQL Server on a server. La base de données peut comporter plusieurs schémas qui ont plusieurs tables, vues et procédures stockées.The database might have multiple schemas that have multiple tables, views, and stored procedures. Vous spécifiez l'objet de base de données à utiliser dans le concepteur de requêtes.You specify the database object to use in the query designer. Si vous ne spécifiez pas de base de données dans la chaîne de connexion, vous vous connectez à la base de données par défaut que l'administrateur de base de données vous a affectée.If you do not specify a database in the connection string, you connect to the default database that the database administrator assigned to you.

Contactez l'administrateur de votre base de données pour connaître les informations de connexion et d'identification à utiliser pour se connecter à la source de données.Contact your database administrator for connection information and for the credentials to use to connect to the data source. L'exemple de chaîne de connexion suivant spécifie un exemple de base de données sur le client local :The following connection string example specifies a sample database on the local client:

Data Source=<server>;Initial Catalog=AdventureWorks  

Pour plus d’informations sur les exemples de chaînes de connexion, consultez Connexions de données, sources de données et chaînes de connexion dans le Générateur de rapports.For more information about connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

Informations d'identification Credentials

Les informations d'identification sont obligatoires pour exécuter des requêtes, afficher l'aperçu du rapport localement et afficher l'aperçu du rapport à partir du serveur de rapports.Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

Après avoir publié votre rapport, vous pouvez devoir modifier les informations d'identification pour la source de données afin que les autorisations soient valides pour récupérer les données lorsque le rapport s'exécute sur le serveur de rapports.After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.

Sur un client de création de rapports, les options suivantes sont disponibles pour spécifier des informations d'identification :From a report authoring client, the following options are available to specify credentials:

Requêtes Queries

Une requête spécifie les données à récupérer pour un dataset de rapport.A query specifies which data to retrieve for a report dataset. Les colonnes dans le jeu de résultats d'une requête remplissent la collection de champs pour un dataset.The columns in the result set for a query populate the field collection for a dataset. Un rapport traite uniquement le premier jeu de résultats récupéré par une requête.A report processes only the first result set that a query retrieves.

Par défaut, si vous créez une requête ou si vous ouvrez une requête existante qui peut être représentée dans le concepteur de requêtes graphique, le concepteur de requêtes relationnelles est disponible.By default, if you create a new query or open an existing query that can be represented in the graphical query designer, the relational query designer is available. Vous pouvez spécifier une requête de plusieurs façons :You can specify a query in the following ways:

  • Générer une requête de manière interactive.Build a query interactively. Utilisez le concepteur de requêtes relationnelles, qui affiche selon un mode hiérarchique les tables, vues, procédures stockées et autres éléments de base de données, organisés par schéma de base de données.Use the relational query designer that displays a hierarchical view of tables, views, stored procedures, and other database items, organized by database schema. Sélectionnez des colonnes à partir des tables ou des vues, ou spécifiez des procédures stockées ou des fonctions table.Select columns from tables or views, or specify stored procedures or table-valued functions. Limitez le nombre de lignes de données à récupérer en spécifiant des critères de filtre.Limit the number of rows of data to retrieve by specifying filter criteria. Personnalisez le filtre lorsque le rapport s'exécute en définissant l'option de paramètre.Customize the filter when the report runs by setting the parameter option.

  • Taper ou coller une requête.Type or paste a query. Utilisez le concepteur de requêtes textuel pour entrer directement du texte Transact-SQLTransact-SQL , coller du texte de requête à partir d’une autre source, entrer des requêtes complexes impossibles à créer à l’aide du concepteur de requêtes relationnelles, ou entrer des expressions basées sur des requêtes.Use the text-based query designer to enter Transact-SQLTransact-SQL text directly, to paste query text from another source, to enter complex queries that cannot be built by using the relational query designer, or to enter query-based expressions.

  • Importe une requête existante à partir d'un fichier ou d'un rapport.Import an existing query from a file or report. Utilisez le bouton Importer une requête à partir de l'un des concepteurs de requêtes afin de naviguer jusqu'à un fichier .sql ou .rdl, et d'importer une requête.Use the Import query button from either query designer to browse to a .sql file or .rdl file and import a query.

    Pour plus d’informations, consultez Interface utilisateur du Concepteur de requêtes relationnelles (Générateur de rapports) et Interface utilisateur du Concepteur de requêtes textuelles (Générateur de rapports).For more information, see Relational Query Designer User Interface (Report Builder) and Text-based Query Designer User Interface (Report Builder).

    Les modes de requête suivants sont pris en charge :The following query modes are supported:

  • Texte Tapez des commandes Transact-SQLTransact-SQL .Text Type in Transact-SQLTransact-SQL commands.

  • Procédure stockée Faites votre choix parmi une liste de procédures stockées.Stored Procedure Choose from a list of stored procedures.

Utilisation du type de requête Texte Using Query Type Text

Dans le concepteur de requêtes textuel, vous pouvez taper des commandes Transact-SQLTransact-SQL pour définir les données d’un dataset.In the text-based query designer, you can type Transact-SQLTransact-SQL commands to define the data in a dataset. Par exemple, la requête Transact-SQLTransact-SQL suivante sélectionne les noms de tous les employés qui occupent la fonction d'assistants marketing :For example, the following Transact-SQLTransact-SQL query selects the names of all employees who are marketing assistants:

SELECT  
  HumanResources.Employee.BusinessEntityID  
  ,HumanResources.Employee.JobTitle  
  ,Person.Person.FirstName  
  ,Person.Person.LastName  
FROM  
  Person.Person  
  INNER JOIN HumanResources.Employee  
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID  
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant'   

Cliquez sur le bouton Exécuter (!) de la barre d’outils pour exécuter la requête et afficher un jeu de résultats.Click the Run button (!) on the toolbar to run the query and display a result set.

Pour paramétrer cette requête, ajoutez un paramètre de requête.To parameterize this query, add a query parameter. Par exemple, modifiez la clause WHERE comme suit :For example, change the WHERE clause to the following:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

Lorsque vous exécutez la requête, les paramètres de rapport qui correspondent aux paramètres de requête sont créés automatiquement.When you run the query, report parameters that correspond to query parameters are automatically created. Pour plus d'informations, consultez Paramètres de requête plus loin dans cette rubrique.For more information, see Query Parameters later in this topic.

Utilisation du type de requête StoredProcedure Using Query Type StoredProcedure

Vous pouvez spécifier une procédure stockée pour une requête de dataset en procédant de l'une des manières suivantes :You can specify a stored procedure for a dataset query in one of the following ways:

  • Dans la boîte de dialogue Propriétés du dataset , définissez l'option Procédure stockée .In the Dataset Properties dialog box, set the Stored Procedure option. Effectuez un choix dans la zone de liste déroulante de procédures stockées et de fonctions table.Choose from the drop-down list of stored procedures and table-valued functions.

  • Dans le Concepteur de requêtes relationnelles, dans le volet Base de données, sélectionnez une procédure stockée ou une fonction table.In the relational query designer, in the Database view pane, select a stored procedure or table-valued function.

  • Dans le Concepteur de requêtes textuel, sélectionnez StoredProcedure dans la barre d’outils.In the text-based query designer, select StoredProcedure from the toolbar.

    Après avoir sélectionné une procédure stockée ou une fonction table, vous pouvez exécuter la requête.After you select a stored procedure or table-valued function, you can run the query. Vous serez invité à fournir les valeurs des paramètres d'entrée.You will be prompted for input parameter values. Lorsque vous exécutez la requête, les paramètres de rapport qui correspondent aux paramètres d'entrée sont créés automatiquement.When you run the query, report parameters that correspond to input parameters are automatically created. Pour plus d'informations, consultez Paramètres de requête plus loin dans cette rubrique.For more information, see Query Parameters later in this topic.

    Seul le premier jeu de résultats extrait pour une procédure stockée est pris en charge.Only the first result set that is retrieved for a stored procedure is supported. Si une procédure stockée retourne plusieurs jeux de résultats, seul le premier est utilisé.If a stored procedure returns multiple result sets, only the first one is used.

    Si une procédure stockée possède un paramètre doté d'une valeur par défaut, vous pouvez accéder à cette dernière en utilisant le mot clé DEFAULT comme valeur pour le paramètre.If a stored procedure has a parameter that has a default value, you can access that value by using the DEFAULT keyword as a value for the parameter. Si le paramètre de requête est lié à un paramètre de rapport, l'utilisateur peut taper ou sélectionner le mot DEFAULT dans la zone d'entrée pour le paramètre de rapport.If the query parameter is linked to a report parameter, the user can type or select the word DEFAULT in the input box for the report parameter.

    Pour plus d’informations, consultez « Procédures stockées (Moteur de base de données) » dans la documentation en ligne SQL Server sur msdn.microsoft.com.For more information, see "Stored Procedures (Database Engine)" in SQL Server Books Online on msdn.microsoft.com.

Paramètres Parameters

Lorsque le texte de requête contient des variables de requête ou des procédures stockées dotées de paramètres d'entrée, les paramètres de requête correspondants pour le dataset et les paramètres de rapport pour le rapport sont automatiquement générés.When query text contains query variables or stored procedures that have input parameters, the corresponding query parameters for the dataset and report parameters for the report are automatically generated. Le texte de requête ne doit pas inclure l'instruction DECLARE pour chaque variable de requête.The query text must not include the DECLARE statement for each query variable.

Par exemple, la requête SQL suivante crée un paramètre de rapport nommé EmpID:For example, the following SQL query creates a report parameter named EmpID:

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN  
       Person.Contact C ON  E.ContactID=C.ContactID   
WHERE EmployeeID = (@EmpID)  

Les paramètres de rapport sont créés avec des valeurs de propriétés par défaut que vous devrez peut-être modifier.Report parameters are created with default property values that you might need to modify. Par exemple :For example:

  • Par défaut, chaque paramètre de rapport a le type de données Texte.By default, each report parameter is data type Text. Si les données sous-jacentes ont un autre type de données, vous devez modifier le type de données du paramètre.If the underlying data is a different data type, you must change the parameter data type.

  • Si vous sélectionnez l’option pour des paramètres à valeurs multiples, vous devez modifier manuellement la requête pour tester si les valeurs font partie d’un jeu en utilisant l’opérateur IN , par exemple, WHERE EmployeeID IN (@EmpID).If you select the option for multivalued parameters, you must manually change the query to test whether values are part of a set by using the IN operator, for example, WHERE EmployeeID IN (@EmpID).

    Pour plus d’informations, consultez Paramètres de rapport (Générateur de rapports et Concepteur de rapports).For more information, see Report Parameters (Report Builder and Report Designer).

Notes Remarks

Vous pouvez également récupérer des données à partir d'une base de données SQL ServerSQL Server à l'aide d'un type de source de données OLE DB ou ODBC.You can also retrieve data from a SQL ServerSQL Server database by using an OLE DB or ODBC data source type. Pour plus d’informations, consultez Type de connexion OLE DB (SSRS) ou (SSRS).For more information, see OLE DB Connection Type (SSRS) or ODBC Connection Type (SSRS).

Informations sur les plateformes et les versionsPlatform and Version Information

Pour plus d’informations sur la prise en charge des plateformes et des versions, consultez Sources de données prises en charge par Reporting Services (SSRS) dans la section Reporting ServicesReporting Services de la documentation en ligne de SQL ServerSQL Server.For more information about platform and version support, see Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.

Rubriques de procédures How-To Topics

Cette section contient des instructions pas à pas sur l'utilisation des connexions de données, des sources de données et des datasets.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Ajouter et vérifier une connexion de données (Générateur de rapports et SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

Créer un dataset partagé ou incorporé (Générateur de rapports et SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Ajouter un filtre à un dataset (Générateur de rapports et SSRS)Add a Filter to a Dataset (Report Builder and SSRS)

Ces sections de la documentation fournissent des informations de fond d'ordre conceptuel sur les données de rapport, ainsi que des informations sur les procédures de définition, de personnalisation et d'utilisation des parties d'un rapport qui sont liées aux données.These sections of the documentation provide in-depth conceptual information about report data, and procedural information about how to define, customize, and use parts of a report that are related to data.

Datasets de rapport (SSRS)Report Datasets (SSRS)
Fournit une vue d'ensemble de l'accès aux données pour votre rapport.Provides an overview of accessing data for your report.

Connexions de données, sources de données et chaînes de connexion dans le Générateur de rapportsData Connections, Data Sources, and Connection Strings in Report Builder
Fournit des informations sur les connexions de données et les sources de données.Provides information about data connections and data sources.

Datasets incorporés dans les rapports et datasets partagés (Générateur de rapports et SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
Fournit des informations sur les datasets incorporés et partagés.Provides information about embedded and shared datasets.

Collection de champs de dataset (Générateur de rapports et SSRS)Dataset Fields Collection (Report Builder and SSRS)
Fournit des informations sur la collection de champs de dataset générée par la requête.Provides information about the dataset field collection generated by the query.

Sources de données prises en charge par Reporting Services (SSRS) dans la section Reporting ServicesReporting Services de la documentation en ligne SQL ServerSQL Server.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
Fournit des informations détaillées sur la prise en charge des plateformes et des versions pour chaque extension de données.Provides in-depth information about platform and version support for each data extension.

Voir aussiSee Also

Paramètres de rapport (Générateur de rapports et Concepteur de rapports) Report Parameters (Report Builder and Report Designer)
Filtrer, regrouper et trier des données (Générateur de rapports et SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
Expressions (Générateur de rapports et SSRS) Expressions (Report Builder and SSRS)