Type de connexion Azure SQL (SSRS)

  • Article

Microsoft Azure SQL Database est une base de données relationnelle hébergée basée sur le cloud qui repose sur les technologies SQL Server. Pour inclure des données de SQL Database dans votre rapport, vous devez avoir un dataset basé sur une source de données de rapport de type SQL Database. Ce type de source de données intégré est basé sur l’extension de données SQL Database . Utilisez ce type de source de données pour vous connecter à et récupérer des données de SQL Database.

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.

SQL Database est semblable à une instance de SQL Server dans vos locaux et l'obtention de données de SQL Database est, à quelques exceptions près, identique à l'obtention de données de SQL Server.

Notes

Quand vous ouvrez une connexion à SQL Database, définissez le délai de connexion à 30 secondes.

Pour plus d’informations, consultez Microsoft Azure SQL Database.

Utilisez les informations de cette rubrique pour générer une source de données. Pour obtenir des instructions détaillées, consultez Ajouter et vérifier une connexion de données (Générateur de rapports et SSRS).

Chaîne de connexion

Lorsque vous vous connectez à SQL Database, vous vous connectez à un objet de base de données dans le cloud. Comme pour les bases de données sur site, la base de données hébergée peut comporter plusieurs schémas qui ont plusieurs tables, vues et procédures stockées. Vous spécifiez l'objet de base de données à utiliser dans le concepteur de requêtes. 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 vous a affectée.

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. L'exemple de chaîne de connexion suivant spécifie un exemple de base de données hébergé nommé AdventureWorks.

Data Source=<host>;Initial Catalog=AdventureWorks; Encrypt=True;

Par ailleurs, vous utilisez la boîte de dialogue Propriétés des sources de données pour fournir des informations d'identification comme le nom d'utilisateur et le mot de passe. Les options User Id et Password sont ajoutées automatiquement à la chaîne de connexion, sans qu’il soit nécessaire de les taper.

Pour obtenir plus d’informations et d’autres exemples sur les chaînes de connexion, consultez Créer des chaînes de connexion de données - Générateur de rapports et SSRS.

Informations d'identification

L'authentification Windows (Sécurité intégrée) n'est pas prise en charge. Si vous essayez de vous connecter à SQL Database à l'aide de l'authentification Windows, une erreur se produit. SQL Database prend en charge uniquement l’authentification SQL Server (nom d’utilisateur et mot de passe) ; en outre, les utilisateurs doivent fournir des informations d’identification (nom de connexion et mot de passe) chaque fois qu’ils se connectent à SQL Database.

Les informations d'identification doivent être suffisantes pour accéder à la base de données. Selon votre requête, vous pouvez avoir besoin d'autres autorisations, par exemple des autorisations suffisantes pour exécuter des procédures stockées et accéder aux tables et aux vues. Le propriétaire de la source de données externe doit configurer des informations d'identification suffisantes pour fournir un accès en lecture seule aux objets de base de données nécessaires.

Sur un client de création de rapports, les options suivantes sont disponibles pour spécifier des informations d'identification :

  • Utiliser un nom d'utilisateur et un mot de passe enregistrés. Pour négocier le double tronçon qui se produit lorsque la base de données qui contient les données de rapport est différente du serveur de rapports, sélectionnez les options permettant d'utiliser les informations d'identification en tant qu'informations d'identification Windows. Vous pouvez également choisir d'emprunter l'identité de l'utilisateur authentifié après connexion à la source de données.

  • Aucune information d'identification n'est requise. Pour utiliser cette option, vous devez avoir configuré le compte d'exécution sans assistance sur le serveur de rapports. Pour plus d’informations, consultez Configurer le compte d’exécution sans assistance (Gestionnaire de configuration du serveur de rapports).

Pour plus d’informations, consultez Créer des chaînes de connexion de données - Générateur de rapports et SSRS ou Spécifier des informations d’identification et de connexion pour les sources de données de rapport.

Requêtes

Une requête spécifie les données à récupérer pour un dataset de rapport. Les colonnes dans le jeu de résultats d'une requête remplissent la collection de champs pour un dataset. Si la requête retourne plusieurs jeux de résultats, le rapport traite uniquement le premier jeu de résultats que la requête récupère. Bien qu'il y ait des différences entre les bases de données SQL Server et SQL Database, notamment les tailles des bases de données prises en charge, l'écriture de requêtes pour des bases de données SQL Databaseest semblable à l'écriture de requêtes pour des bases de données SQL Server . Certaines instructions Transact-SQL comme BACKUP ne sont pas prises en charge dans SQL Database ; cependant, il ne s’agit pas de celles qui sont utilisées dans les requêtes de rapport. Pour plus d’informations, consultez Type de connexion SQL Server (SSRS).

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. Vous pouvez spécifier une requête de plusieurs façons :

  • Générer une requête de manière interactive. Utilisez le concepteur de requêtes relationnelles, qui affiche de manière hiérarchique les tables, vues, procédures stockées et autres éléments de base de données, organisés en fonction du schéma de la base de données. Sélectionnez des colonnes à partir des tables ou des vues, ou spécifiez des procédures stockées ou des fonctions table. Limitez le nombre de lignes de données à récupérer en spécifiant des critères de filtre. Personnalisez le filtre lorsque le rapport s'exécute en définissant l'option de paramètre.

  • Taper ou coller une requête. Utilisez le concepteur de requêtes textuel pour entrer directement du texte Transact-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.

  • Importe une requête existante à partir d'un fichier ou d'un rapport. 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.

Le concepteur de requêtes textuel prend en charge les deux modes suivants :

  • Texte Tapez des commandes Transact-SQL qui sélectionnent des données à partir de la source de données.

  • Procédure stockée Faites votre choix parmi une liste de procédures stockées.

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 textuel (Générateur de rapports).

Le concepteur de requêtes graphique utilisé par SQL Database fournit une prise en charge intégrée du regroupement et des agrégats pour vous aider à écrire des requêtes qui récupèrent uniquement les données de synthèse. Les fonctionnalités du langage Transact-SQL sont les suivantes : clause GROUP BY, mot clé DISTINCT et agrégats tels que SUM et COUNT. Le concepteur de requêtes textuel fournit une prise en charge complète du langage Transact-SQL, notamment en matière de regroupement et d’agrégats. Pour plus d’informations sur Transact-SQL, consultez Référence Transact-SQL (moteur de base de données).

Utilisation du type de requête Texte

Dans le concepteur de requêtes textuel, vous tapez des commandes Transact-SQL pour définir les données d’un dataset. Par exemple, la requête Transact-SQL suivante sélectionne les noms de tous les employés qui occupent la fonction d’assistants marketing :

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.

Pour paramétrer cette requête, ajoutez un paramètre de requête. Par exemple, modifiez la clause WHERE comme suit :

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. Pour plus d'informations, consultez Paramètres de requête plus loin dans cette rubrique.

Utilisation du type de requête 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 :

  • Dans la boîte de dialogue Propriétés du dataset , définissez l'option Procédure stockée . Effectuez un choix dans la zone de liste déroulante de procédures stockées et de fonctions table.

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

  • Dans le Concepteur de requêtes textuel, sélectionnez StoredProcedure dans la barre d’outils.

Après avoir sélectionné une procédure stockée ou une fonction table, vous pouvez exécuter la requête. Il vous est alors demandé d’indiquer les valeurs des paramètres d'entrée. Lorsque vous exécutez la requête, les paramètres de rapport qui correspondent aux paramètres d'entrée sont créés automatiquement. Pour plus d'informations, consultez Paramètres de requête plus loin dans cette rubrique.

Seul le premier jeu de résultats extrait pour une procédure stockée est pris en charge. Si une procédure stockée retourne plusieurs jeux de résultats, seul le premier est utilisé.

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

Pour plus d’informations sur les procédures stockées, consultez Procédures stockées (moteur de base de données).

Paramètres

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. Le texte de requête ne doit pas inclure l'instruction DECLARE pour chaque variable de requête.

Par exemple, la requête SQL suivante crée un paramètre de rapport nommé EmpID:

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

Par défaut, chaque paramètre de rapport a le type de données Texte ; en outre, un dataset est créé automatiquement pour fournir une liste déroulante de valeurs disponibles. Après avoir créé les paramètres de rapport, vous devrez peut-être modifier les valeurs par défaut. Pour plus d’informations, consultez Paramètres de rapport (Générateur de rapports et Concepteur de rapports).

Remarques

Autres extensions de données

Vous pouvez également récupérer des données à partir d'une base de données SQL Server à l'aide d'un type de source de données ODBC. La connexion à SQL Database avec OLE DB n'est pas prise en charge.

Pour plus d’informations, consultez Type de connexion ODBC (SSRS).

Informations sur les plateformes et les versions

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

Base de données Azure SQL et Microsoft Entra ID

Vous pouvez utiliser la base de données Azure SQL avec Microsoft Entra ID (anciennement Azure Active Directory).

Ce scénario est pris en charge à condition que les éléments suivants soient correctement configurés :

Rubriques de procédures

Cette section contient des instructions pas à pas sur l'utilisation des connexions de données, des sources de données et des datasets.

Ajouter et vérifier une connexion de données (Générateur de rapports et SSRS)

Créer un dataset partagé ou incorporé (Générateur de rapports et SSRS)

Ajouter un filtre à un dataset (Générateur de rapports et 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.

Jeux de données du rapport (SSRS)
Fournit une vue d'ensemble de l'accès aux données pour votre rapport.

Créer des chaînes de connexion de données - Générateur de rapports et SSRS
Fournit des informations sur les connexions de données et les sources de données.

Datasets incorporés dans le rapport et datasets partagés (Générateur de rapports et SSRS)
Fournit des informations sur les datasets incorporés et partagés.

Collection de champs de dataset (Générateur de rapports et SSRS)
Fournit des informations sur la collection de champs de dataset générée par la requête.

Sources de données prises en charge par Reporting Services (SSRS).
Fournit des informations détaillées sur la prise en charge des plateformes et des versions pour chaque extension de données.

Voir aussi

Microsoft Azure SQL Database
Paramètres de rapport (Générateur de rapports et Concepteur de rapports)
Filtrer, regrouper et trier des données (Générateur de rapports et SSRS)
Expressions (Générateur de rapports et SSRS)