Créer des chaînes de connexion de données dans le Générateur de rapports

S’applique à : SQL Server 2016 (13.x) Reporting Services et versions ultérieures Power BI Report Server SharePoint

Pour inclure les données dans des rapports paginés du Générateur de rapports et Reporting Services, vous devez commencer par créer une chaîne de connexion vers votre source de données. Cet article explique comment créer les chaînes de connexion de données et fournit les informations importantes liées aux informations d'identification de la source de données. Une source de données inclut le type de source de données, les informations de connexion et le type d'informations d'identification nécessaire. Pour plus d’informations, consultez Présentation des données des rapports dans SQL Server Reporting Services (SSRS).

Extensions de données intégrées

Les extensions de données par défaut dans Reporting Services incluent Microsoft SQL Server, Microsoft Azure SQL Database et Microsoft SQL Server Analysis Services. Pour obtenir la liste complète des sources de données et des versions prises en charge par Reporting Services, consultez Sources de données prises en charge par Reporting Services (SSRS).

Exemples de chaîne de connexion courante

Les chaînes de connexion constituent la représentation textuelle des propriétés de connexion pour un fournisseur de données. Le tableau suivant présente des exemples de chaînes de connexion pour différents types de connexion de données.

Notes

ConnectionStrings.com est une autre ressource permettant d’obtenir des exemples de chaînes de connexion.

Source de données Exemple Description
Base de données SQL Server sur le serveur local Data Source="(local)"; Initial Catalog=AdventureWorks Définissez Microsoft SQL Servercomme type de source de données. Pour plus d’informations, consultez Type de connexion SQL Server (SSRS).
Instance nommée SQL Server Data Source=<host>\MSSQL13.<InstanceName>; Initial Catalog=AdventureWorks Définissez Microsoft SQL Servercomme type de source de données. Pour plus d’informations, consultez Type de connexion SQL Server (SSRS).
Azure SQL Database Data Source=<host>.database.windows.net; Initial Catalog=AdventureWorks; Encrypt=True Définissez Microsoft Azure SQL Database comme type de source de données. Pour plus d’informations, consultez Type de connexion Azure SQL (SSRS).
SQL Server Parallel Data Warehouse HOST=<IP address>; database=AdventureWorks; port=<port> Définissez Microsoft SQL Server Parallel Data Warehousecomme type de source de données. Pour plus d’informations, consultez Type de connexion SQL Server Parallel Data Warehouse (SSRS).
Base de données Analysis Services sur le serveur local Data Source=localhost; Initial Catalog=Adventure Works DW Définissez Microsoft SQL Server Analysis Servicescomme type de source de données. Pour plus d’informations, consultez Type de connexion Analysis Services pour MDX (SSRS) ou Type de connexion Analysis Services pour DMX (SSRS).
Base de données de modèles tabulaires Analysis Services avec une perspective Ventes Data Source=<servername>; Initial Catalog=Adventure Works DW; cube='Sales' Définissez Microsoft SQL Server Analysis Servicescomme type de source de données. Spécifiez le nom de la perspective dans le paramètre cube=. Pour plus d’informations, consultez Perspectives dans les modèles tabulaires.
Azure Analysis Services Data Source=asazure://aspaaseastus2.asazure.windows.net/<server name>; Initial Catalog=AdventureWorks Définissez Microsoft SQL Server Analysis Servicescomme type de source de données. Pour plus d’informations, consultez Extension pour le traitement des données Microsoft SQL Server Analysis Services.
Serveur Oracle Data Source=<host> Définissez Oraclecomme type de source de données. Les outils clients Oracle doivent être installés sur l'ordinateur hébergeant le Concepteur de rapports et sur le serveur de rapports. Pour plus d’informations, consultez Type de connexion Oracle (SSRS et Générateur de rapports Power BI).
Source de données SAP NetWeaver BI Data Source=https://mySAPNetWeaverBIServer:8000/sap/bw/xml/soap/xmla Définissez SAP NetWeaver BIcomme type de source de données. Pour plus d’informations, consultez Type de connexion SAP NetWeaver BI (SSRS).
Source de données Hyperion Essbase Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample Définissez Hyperion Essbasecomme type de source de données. Pour plus d’informations, consultez Type de connexion Hyperion Essbase (SSRS).
Source de données Teradata Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Définissez Teradatacomme type de source de données. La chaîne de connexion est une adresse IP se présentant sous la forme de quatre champs, chaque champ pouvant comporter de un à trois chiffres. Pour plus d’informations, consultez Type de connexion Teradata (SSRS).
Source de données Teradata Database=<database name>; Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Use X Views=False; Restrict to Default Database=True Définissez Teradata, comme type de source de données, comme dans l'exemple précédent. Utilisez uniquement la base de données par défaut spécifiée dans la balise Database, et ne découvrez pas automatiquement les relations entre les données.
Source de données XML, service Web data source=https://adventure-works.com/results.aspx Définissez XMLcomme type de source de données. La chaîne de connexion est une URL pour un service Web prenant en charge le langage de définition de services Web (WSDL, Web Services Definition Language). Pour plus d’informations, consultez Type de connexion XML (SSRS).
Source de données XML, document XML https://localhost/XML/Customers.xml Définissez XMLcomme type de source de données. La chaîne de connexion est une URL vers le document XML.
Source de données XML, document XML incorporé Vide Définissez XMLcomme type de source de données. Les données XML sont incorporées dans la définition de rapport.
Liste SharePoint Data Source=https://MySharePointWeb/MySharePointSite/ Définissez SharePoint Listcomme type de source de données.
Jeu de données Power BI Premium (à compter de Reporting Services 2019 et Power BI Report Server janvier 2020) Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspacename>; Initial Catalog=<datasetname> Définissez Microsoft SQL Server Analysis Servicescomme type de source de données.

Si vous ne réussissez pas à vous connecter à un serveur de rapports en utilisant localhost, assurez-vous que le protocole réseau du protocole TCP/IP est activé. Pour plus d’informations, consultez Configurer des protocoles clients.

Pour plus d’informations sur les configurations nécessaires pour se connecter à ces types de sources de données, consultez l’article propre aux connexions de données sous Ajouter des données à partir de sources de données externes (SSRS) ou Sources de données prises en charge par Reporting Services (SSRS).

Caractères spéciaux dans un mot de passe

Si vous configurez votre source de données ODBC ou SQL avec un mot de passe, vous pouvez rencontrer des erreurs avec des caractères spéciaux. Si un utilisateur saisit le mot de passe avec des caractères spéciaux tels que des signes de ponctuation, certains pilotes de sources de données sous-jacentes ne peuvent pas valider ces caractères spéciaux. Lors du traitement du rapport, le message « Mot de passe non valide » peut s'afficher et signaler ce problème. Si le changement du mot de passe s'avère impossible, vous pouvez demander à votre administrateur de base de données de stocker les informations d'identification appropriées sur le serveur en tant que nom de sources de données (DSN) ODBC. Pour plus d’informations, consultez OdbcConnection.ConnectionString » dans la documentation du .NET Framework.

Chaînes de connexion basées sur des expressions

Les chaînes de connexion basées sur des expressions sont évaluées au moment de l'exécution. Par exemple, vous pouvez spécifier la source de données comme paramètre, inclure la référence de paramètre dans la chaîne de connexion et permettre à l'utilisateur de choisir une source de données pour le rapport. Imaginons par exemple qu’une multinationale dispose de serveurs de données dans plusieurs pays ou régions. Grâce à une chaîne de connexion basée sur une expression, un utilisateur peut sélectionner une source de données pour une région ou un pays particulier avant d’exécuter un rapport de ventes.

L’exemple suivant illustre l’utilisation d’une expression de source de données dans une chaîne de connexion SQL Server. Cet exemple repose sur l'hypothèse que vous avez créé un paramètre de rapport nommé ServerName:

="Data Source=" & Parameters!ServerName.Value & "; Initial Catalog=AdventureWorks"  

Les expressions de source de données sont traitées au moment de l'exécution ou lors de l'affichage de l'aperçu d'un rapport. L’expression doit être écrite en Visual Basic. Suivez les règles suivantes lorsque vous définissez une expression de source de données :

  • Créez le rapport à l'aide d'une chaîne de connexion statique. Une chaîne de connexion statique est une chaîne de connexion qui n’est pas définie par le biais d’une expression. Par exemple, lorsque vous suivez les étapes de création d’une source de données spécifique au rapport ou partagée, vous définissez une chaîne de connexion statique. L'utilisation d'une chaîne de connexion statique vous permet de vous connecter à la source de données dans le Concepteur de rapports afin d'obtenir les résultats de requête nécessaires à la création du rapport.

  • Lorsque vous définissez la connexion de source de données, n'utilisez pas une source de données partagée. Vous ne pouvez pas utiliser une expression de source de données dans une source de données partagée. Vous devez définir une source de données incorporée pour le rapport.

  • Spécifiez les informations d'identification indépendamment de la chaîne de connexion. Vous pouvez utiliser des informations d'identification stockées, des informations d'identification saisies ou la sécurité intégrée.

  • Ajoutez un paramètre de rapport pour spécifier une source de données. Pour les valeurs du paramètre, vous pouvez fournir une liste statique de valeurs disponibles, ou définir une requête qui extrait une liste de sources de données au moment de l'exécution. Dans ce cas, la liste statique des valeurs disponibles doit être des sources de données que vous pouvez utiliser avec le rapport.

  • Vérifiez que la liste de sources de données partage le même schéma de base de données. Toute conception de rapport commence par les informations relatives au schéma. Si le schéma permettant de définir le rapport ne correspond pas au schéma effectivement utilisé par le rapport au moment de l'exécution, celle-ci peut échouer.

  • Avant de publier le rapport, remplacez la chaîne de connexion statique par une expression. N'effectuez cette opération qu'une fois la création du rapport achevée. Dès que vous utilisez une expression, vous ne pouvez pas exécuter la requête dans le Concepteur de rapports. De plus, la liste de champs du volet des Données de rapport et la liste Paramètres ne sont pas automatiquement mises à jour.