Se connecter à une base de données SQL à partir de workflows dans Azure Logic Apps

  • Article

S’applique à : Azure Logic Apps (Consommation + Standard)

Ce guide pratique montre comment accéder à votre base de données SQL à partir d’un flux de travail dans Azure Logic Apps avec le connecteur SQL Server. Vous pouvez ensuite créer des workflows automatisés qui s’exécutent quand ils sont déclenchés par des événements dans votre base de données SQL ou dans d’autres systèmes, et exécuter des actions pour gérer vos données et ressources SQL.

Par exemple, votre workflow peut exécuter des actions qui obtiennent, insèrent et suppriment des données ou qui peuvent exécuter des requêtes et procédures stockées SQL. Votre workflow peut rechercher de nouveaux enregistrements dans une base de données non SQL, effectuer un traitement, utiliser les résultats pour créer de nouveaux enregistrements dans votre base de données SQL, et envoyer des alertes par e-mail concernant les nouveaux enregistrements.

Si vous débutez avec Azure Logic Apps, consultez la documentation de prise en main suivante :

Éditions de SQL prises en charge

Le connecteur SQL Server prend en charge les éditions SQL suivantes :

Référence technique du connecteur

Le connecteur SQL Server a différentes versions, en fonction du type d’application logique et de l’environnement hôte.

Application logique Environnement Version du connecteur
Consommation Azure Logic Apps multilocataire Connecteur managé, qui apparaît dans le concepteur sous l’étiquette Standard. Pour plus d’informations, consultez la documentation suivante :

- Référence du connecteur managé SQL Server
- Connecteurs managés dans Azure Logic Apps
Consommation Environnement de service d’intégration (ISE) Connecteur managé, qui apparaît dans le concepteur sous l’étiquette Standard, et la version ISE, qui a des limites de message différentes de celles de la classe Standard. Pour plus d’informations, consultez la documentation suivante :

- Référence du connecteur managé SQL Server
- Limites de messages ISE
- Connecteurs managés dans Azure Logic Apps
Standard Azure Logic Apps monolocataire et App Service Environment v3 (plans Windows uniquement) Le connecteur managé apparaissant dans la galerie de connecteurs sous Runtime>partagé, ainsi que le connecteur intégré qui apparaît dans la galerie de connecteurs sous Runtime>In-App et est basé sur le fournisseur de services. Le connecteur intégré diffère de la manière suivante :

- Le connecteur intégré peut se connecter directement à une base de données SQL et accéder à des réseaux virtuels Azure à l’aide d’un chaîne de connexion sans passerelle de données locale.

Pour plus d’informations, consultez la documentation suivante :

- Référence du connecteur managé SQL Server
- Informations de référence du connecteur intégré SQL Server
- Connecteurs intégrés dans Azure Logic Apps

Limites

Pour plus d’informations, consultez la référence du connecteur managé SQL Server ou la référence du connecteur intégré SQL Server.

Prérequis

  • Un compte et un abonnement Azure. Si vous n’avez pas encore d’abonnement, vous pouvez vous inscrire pour obtenir un compte Azure gratuitement.

  • base de données SQL Server, Azure SQL Database ou SQL Managed Instance.

    Le connecteur SQL Server nécessite que vos tables contiennent des données afin que les opérations de connecteur puissent retourner des résultats lorsqu’elles sont appelées. Par exemple, si vous utilisez Azure SQL Database, vous pouvez utiliser les exemples de bases de données inclus pour essayer les opérations de connecteur SQL Server.

  • Informations requises pour créer une connexion de base de données SQL, comme vos noms de serveur et de base de données SQL. Si vous utilisez l’authentification Windows ou l’authentification SQL Server pour authentifier l’accès, vous avez également besoin de votre nom d’utilisateur et de votre mot de passe. Ces informations se trouvent généralement dans votre chaîne de connexion.

    Important

    Si vous utilisez une chaîne de connexion SQL Server que vous avez copiée directement à partir du portail Azure, vous devez ajouter manuellement votre mot de passe à la chaîne de connexion.

    • Pour une base de données SQL dans Azure, la chaîne de connexion a le format suivant :

      Server=tcp:{your-server-name}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

      1. Pour trouver cette chaîne dans le portail Azure, ouvrez votre base de données.

      2. Dans le menu de la base de données, sous Propriétés, sélectionnez Chaînes de connexion.

    • Pour un serveur SQL local, la chaîne de connexion a le format suivant :

      Server={your-server-address};Database={your-database-name};User Id={your-user-name};Password={your-password};

  • Dans les flux de travail Standard, pour utiliser les déclencheurs intégrés SQL, vous devez activer le suivi des modifications dans la table où vous souhaitez utiliser le déclencheur. Pour plus d’informations, consultez Activer et désactiver le suivi des modifications.

  • Le workflow d’application logique où vous souhaitez accéder à votre base de données SQL. Pour démarrer votre flux de travail avec un déclencheur SQL Server, vous devez commencer par un flux de travail vide. Pour utiliser une action SQL Server, démarrez votre flux de travail avec n’importe quel déclencheur.

  • Pour vous connecter à un serveur SQL local, les exigences supplémentaires suivantes s’appliquent, selon que vous disposez d’un workflow d’application logique Consommation ou Standard.

    • Workflow Consommation

    • Workflow Standard

      Vous pouvez utiliser le connecteur intégré SQL Server ou le connecteur managé.

      • Pour utiliser l’authentification Microsoft Entra ou l’authentification d’identité managée avec votre application logique, vous devez configurer votre serveur SQL Server pour qu’il fonctionne avec ces types d’authentification. Pour plus d’informations, consultez Authentification - Informations de référence du connecteur managé SQL Server.

      • Pour utiliser le connecteur intégré, vous pouvez authentifier votre connexion avec une identité managée, un ID Microsoft Entra ou un chaîne de connexion. Vous pouvez ajuster le regroupement de connexions en spécifiant des paramètres dans la chaîne de connexion. Pour plus d’informations, consultez Regroupement de connexions.

      • Pour utiliser le connecteur managé SQL Server, vous devez satisfaire aux mêmes exigences que pour un workflow d’application logique de consommation dans un environnement Azure Logic Apps multilocataire. Pour les autres exigences du connecteur, consultez la référence du connecteur managé SQL Server.

Ajouter un déclencheur SQL Server

Les étapes suivantes utilisent le portail Azure, mais avec l’extension Azure Logic Apps appropriée, vous pouvez également utiliser les outils suivants pour créer des flux de travail d’application logique :

  1. Sur le portail Azure, ouvrez votre workflow d’application logique Consommation et un workflow vide dans le concepteur.

  2. Dans le concepteur, sous la zone de recherche, sélectionnez Standard. Suivez ensuite ces étapes générales pour ajouter le déclencheur managé SQL Server souhaité.

    Cet exemple continue avec le déclencheur nommé Lors de la création d’un élément.

  3. Si vous y êtes invité, fournissez les informations de votre connexion. Sélectionnez Créer lorsque vous avez terminé.

  4. Une fois la zone d’informations du déclencheur affichée, fournissez les informations nécessaires requises par votre déclencheur sélectionné.

    Pour cet exemple, dans le déclencheur nommé Lorsqu’un élément est créé, fournissez les valeurs du nom du serveur SQL et du nom de la base de données, si vous ne les avez pas précédemment fournis. Sinon, dans la liste Noms de table, sélectionnez la table que vous souhaitez utiliser. Sélectionnez la fréquence et l’intervalle pour définir la planification du déclencheur sur case activée pour les nouveaux éléments.

    Screenshot shows Consumption workflow designer and managed action named When an item is created.

  5. Si d’autres propriétés sont disponibles pour ce déclencheur, ouvrez la liste ajouter de nouveaux paramètres et sélectionnez ces propriétés pertinentes pour votre scénario.

    Ce déclencheur ne renvoie qu’une seule ligne de la table sélectionnée. Pour effectuer d’autres tâches, continuez en ajoutant une action de connecteur SQL Server ou une autre action qui effectue la tâche suivante souhaitée dans votre flux de travail d’application logique.

    Par exemple, pour afficher les données de cette ligne, vous pouvez ajouter d’autres actions qui créent un fichier qui comprend les champs de la ligne retournée, puis envoient des alertes par e-mail. Pour en savoir plus sur les autres actions disponibles pour ce connecteur, consultez la référence du connecteur managé SQL Server.

  6. Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Lorsque vous enregistrez votre flux de travail, cette étape publie automatiquement vos mises à jour dans votre application logique déployée, qui est en direct dans Azure. Avec un seul déclencheur, votre flux de travail vérifie simplement la base de données SQL en fonction de votre planification spécifiée. Vous devez ajouter une action de réaction à votre déclencheur.

Ajouter une action SQL Server

Les étapes suivantes utilisent le portail Azure, mais avec l’extension Azure Logic Apps appropriée, vous pouvez également utiliser Visual Studio pour modifier les flux de travail d’application logique de consommation ou Visual Studio Code aux outils suivants pour modifier les flux de travail d’application logique :

Dans cet exemple, le flux de travail de l’application logique commence par le déclencheur de périodicité et appelle une action qui reçoit une ligne d’une base de données SQL.

  1. Sur le portail Azure, ouvrez votre workflow d’application logique Consommation dans le concepteur.

  2. Dans le concepteur, suivez ces étapes générales pour ajouter l’action managée SQL Server souhaitée.

    Cet exemple continue avec l’action Nommée Get row, qui obtient un enregistrement unique.

  3. Si vous y êtes invité, fournissez les informations de votre connexion. Sélectionnez Créer lorsque vous avez terminé.

  4. Une fois la zone d’informations d’action affichée, dans la liste des noms de table, sélectionnez la table que vous souhaitez utiliser. Dans la propriété ID de ligne, entrez l’ID de l’enregistrement souhaité.

    Pour cet exemple, le nom de la table est SalesLT.Customer.

    Screenshot shows Consumption workflow designer and action named Get row with the example table name and empty row ID.

    Cette action ne renvoie qu’une seule ligne de la table sélectionnée. Pour afficher les données de cette ligne, ajoutez d’autres actions. Par exemple, ces actions peuvent créer un fichier, inclure les champs de la ligne retournée et stocker le fichier dans un compte de stockage cloud. Pour en savoir plus sur les autres actions disponibles pour ce connecteur, consultez la page de référence du connecteur.

  5. Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Se connecter à votre base de données

Lorsque vous ajoutez un déclencheur ou une action qui se connecte à un service ou à un système et que vous n’avez pas de connexion existante ou active, Azure Logic Apps vous invite à fournir les informations de connexion, qui varient selon le type de connexion, par exemple :

  • Vos informations d’identification de votre compte
  • Un nom à utiliser pour la connexion
  • Le nom pour le serveur ou le système
  • Type d’authentification à utiliser
  • Une chaîne de connexion

Après avoir fourni ces informations, suivez les étapes suivantes en fonction de votre base de données cible :

Se connecter à Azure SQL Database ou à SQL Database Managed Instance

Pour accéder à SQL Managed Instance sans utiliser la passerelle de données locale ou l’environnement de service d’intégration, vous devez configurer le point de terminaison public sur SQL Managed Instance. Le point de terminaison public utilise le port 3342. Assurez-vous de spécifier ce numéro de port lorsque vous créez la connexion à partir de votre application logique.

Dans la zone d’informations de la connexion, procédez comme suit :

  1. Pour Nom de la connexion, donnez un nom à utiliser pour votre connexion.

  2. Pour le Type d’authentification, sélectionnez l’authentification requise et activée sur votre base de données dans Azure SQL Database ou SQL Managed Instance :

    Authentification Description
    Chaîne de connexion - Pris en charge uniquement dans les workflows Standard avec le connecteur intégré SQL Server.

    - Nécessite la chaîne de connexion à votre serveur et base de données SQL.
    OAuth Active Directory - Pris en charge uniquement dans les workflows Standard avec le connecteur intégré SQL Server. Pour plus d’informations, consultez la documentation suivante :

    - Authentification pour le connecteur SQL Server
    - Activer l’authentification ouverte de l’ID Microsoft Entra (Microsoft Entra ID OAuth)
    - Microsoft Entra ID Open Authentication
    Identités managées par applications logiques - Pris en charge avec le connecteur managé SQL Server et le connecteur versionné ISE. Dans les workflows Standard, ce type d’authentification est disponible pour le connecteur intégré SQL Server, mais l’option est nommée Identité managée à la place.

    - Nécessite les éléments suivants :

    --- Une identité managée valide activée sur votre ressource d’application logique et qui a accès à votre base de données.

    --- Accès au rôle Contributeur de base de données SQL à la ressource SQL Server

    --- Accès du rôle Contributeur au groupe de ressources qui contient la ressource SQL Server.

    Pour plus d’informations, consultez la documentation suivante :

    - Authentification de l’identité managée pour le connecteur SQL Server
    - SQL - Rôles de niveau serveur
    Principal du service (application Microsoft Entra) - Pris en charge avec le connecteur managé SQL Server.

    - Nécessite une application Microsoft Entra et un principal de service. Pour plus d’informations, consultez Créer une application Microsoft Entra et un principal de service qui peuvent accéder aux ressources à l’aide du Portail Azure.
    Microsoft Entra intégré - Pris en charge avec le connecteur managé SQL Server et le connecteur versionné ISE.

    - Nécessite une identité managée valide dans Microsoft Entra qui est activée sur votre ressource d’application logique et a accès à votre base de données. Pour plus d’informations, consultez les rubriques suivantes :

    - Vue d’ensemble de la sécurité Azure SQL : authentification
    - Autoriser l’accès à la base de données Azure SQL : authentification et autorisation
    - Azure SQL - Authentification intégrée Microsoft Entra
    Authentification SQL Server - Pris en charge avec le connecteur managé SQL Server et le connecteur versionné ISE.

    - Nécessite les éléments suivants :

    --- une ressource de passerelle de données créée précédemment dans Azure pour votre connexion, que votre application logique soit dans des Azure Logic Apps multilocataires ou un ISE.

    - Un nom d’utilisateur et un mot de passe sécurisé valides qui sont créés et stockés dans votre base de données SQL Server. Pour plus d'informations, voir les rubriques suivantes :

    - Vue d’ensemble de la sécurité Azure SQL : authentification
    - Autoriser l’accès à la base de données Azure SQL : authentification et autorisation

    Les exemples suivants montrent comment la zone d’informations de connexion peut apparaître si vous utilisez le connecteur managé SQL Server et sélectionnez l’authentification intégrée Microsoft Entra :

    Workflows Consommation

    Screenshot shows Azure portal, Consumption workflow, and SQL Server cloud connection information with selected authentication type.

    Workflows Standard

    Screenshot shows Azure portal, Standard workflow, and SQL Server cloud connection information with selected authentication type.

  3. Après avoir sélectionné Microsoft Entra intégré, sélectionnez Se connecter. Selon que vous utilisez Azure SQL Database ou SQL Managed Instance, sélectionnez vos informations d’identification d’utilisateur pour l’authentification.

  4. Sélectionnez ces valeurs pour votre base de données :

    Propriété Obligatoire Description
    Nom du serveur Oui Adresse de votre serveur SQL, par exemple, Fabrikam-Azure-SQL.database.windows.net
    Nom de la base de données Oui Nom de votre base de données SQL, par exemple, Fabrikam-Azure-SQL-DB
    Nom de la table Oui La table que vous souhaitez utiliser, par exemple, SalesLT.Customer

    Conseil

    Pour fournir vos informations de base de données et de table, vous disposez des options suivantes :

    • Trouvez ces informations dans la chaîne de connexion de votre base de données. Par exemple, Dans le Portail Azure, recherchez et ouvrez votre base de données. Dans le menu de la base de données, sélectionnez Chaînes de connexion ou Propriétés, dans lesquelles vous pouvez trouver la chaîne suivante :

      Server=tcp:{your-server-address}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

    • Par défaut, les tables des bases de données système sont filtrées, elles peuvent donc ne pas s’afficher automatiquement lorsque vous sélectionnez une base de données système. Vous pouvez également indiquer manuellement le nom de la table une fois que vous avez sélectionné Entrer une valeur personnalisée dans la liste de base de données.

    Cette zone d’informations de base de données ressemble à l’exemple suivant :

    Workflows Consommation

    Screenshot shows SQL cloud database cloud information with sample values for Consumption.

    Workflows Standard

    Screenshot shows SQL cloud database information with sample values for Standard.

  5. Maintenant, poursuivez avec les étapes que vous n’avez pas encore effectuées dans Ajouter un déclencheur SQL ou Ajouter une action SQL.

Se connecter à un SQL Server local

Dans la zone d’informations de la connexion, procédez comme suit :

  1. Pour les connexions à votre SQL Server local qui nécessitent la passerelle de données locale, assurez-vous que vous avez rempli ces conditions préalables.

    Sinon, votre ressource de passerelle de données n’apparaît pas dans la liste des passerelles d’Connecter ion lorsque vous créez votre connexion.

  2. Pour le Type d’authentification, sélectionnez l’authentification requise et activée sur votre SQL Server :

    Authentification Description
    Authentification SQL Server - Pris en charge avec le connecteur managé SQL Server, le connecteur SQL Server intégré et le connecteur versionné ISE.

    - Nécessite les éléments suivants :

    --- une ressource de passerelle de données créée précédemment dans Azure pour votre connexion, que votre application logique soit dans des Azure Logic Apps multilocataires ou un ISE.

    - Nom d’utilisateur et mot de passe sécurisé valides qui sont créés et stockés dans votre SQL Server.

    Pour plus d’informations, consultez Authentification SQL Server.
    Authentification Windows - Pris en charge avec le connecteur managé SQL Server.

    - Nécessite les éléments suivants :

    --- une ressource de passerelle de données créée précédemment dans Azure pour votre connexion, que votre application logique soit dans des Azure Logic Apps multilocataires ou un ISE.

    --- Nom d’utilisateur et mot de passe Windows valides pour confirmer votre identité par le biais de votre compte Windows.

    Pour plus d'informations, consultez Authentification Windows.

  3. Sélectionnez ou fournissez les valeurs suivantes pour votre base de données SQL :

    Propriété Obligatoire Description
    Nom du serveur SQL Oui L’adresse pour votre SQL Server, par exemple, Fabrikam-Azure-SQL.database.windows.net
    Nom de la base de données SQL Oui Le nom de votre base de données SQL Server, par exemple, Fabrikam-Azure-SQL-DB
    Nom d’utilisateur Oui Votre nom d’utilisateur pour le serveur et la base de données SQL
    Mot de passe Oui Votre mot de passe pour le serveur et la base de données SQL
    Abonnement Oui, pour l’Authentification Windows L’abonnement Azure pour la ressource de passerelle de données que vous avez créée précédemment dans Azure
    Passerelle de connexion Oui, pour l’Authentification Windows Nom de la ressource de passerelle de données que vous avez créée précédemment dans Azure



    Conseil : si votre passerelle n’apparaît pas dans la liste, case activée que vous avez correctement configuré votre passerelle.

    Conseil

    Ces informations se trouvent dans la chaîne de connexion de votre base de données :

    • Server={your-server-address}
    • Database={your-database-name}
    • User ID={your-user-name}
    • Password={your-password}

    Les exemples suivants montrent comment la zone d’informations de connexion peut apparaître si vous sélectionnez l’authentification Windows.

    Workflows Consommation

    Screenshot shows Azure portal, Consumption workflow, and SQL Server on-premises connection information with selected authentication.

    Workflows Standard

    Screenshot shows Azure portal, Standard workflow, and SQL Server on-premises connection information with selected authentication.

  4. Quand vous êtes prêt, sélectionnez Créer.

  5. Maintenant, poursuivez avec les étapes que vous n’avez pas encore effectuées dans Ajouter un déclencheur SQL ou Ajouter une action SQL.

Gérer des données en bloc

Parfois, vous manipulez des jeux de résultats tellement volumineux que le connecteur ne retourne pas tous les résultats en même temps, ou vous souhaitez mieux contrôler la taille et la structure de vos jeux de résultats La liste suivante présente quelques manières de gérer ces grands jeux de résultats :

Gérer les données en bloc dynamiques

Parfois, lorsque vous effectuez un appel à une procédure stockée au moyen du connecteur SQL Server, la sortie retournée est dynamique. Dans ce scénario, procédez comme suit :

  1. Dans le Portail Azure, ouvrez votre application logique et votre flux de travail dans le concepteur.

  2. Affichez le format de sortie en effectuant une série de tests. Copiez et enregistrez votre exemple de sortie.

  3. Dans le concepteur, sous l’action où vous appelez la procédure stockée, ajoutez l’action intégrée nommée Parse JSON.

  4. Dans l’option Analyser JSON, sélectionnez Utiliser l’exemple de charge utile pour générer le schéma.

  5. Dans la zone Entrer ou coller un exemple de charge utile JSON, collez votre exemple de sortie, puis sélectionnez Terminé.

    Remarque

    Si vous recevez une erreur indiquant qu’Azure Logic Apps ne peut pas générer de schéma, vérifiez que la syntaxe de votre exemple de sortie est correctement mise en forme. Si vous ne pouvez toujours pas générer le schéma dans la zone Schéma, entrez manuellement le schéma.

  6. Lorsque vous avez terminé, enregistrez votre flux de travail.

  7. Pour référencer les propriétés de contenu JSON, sélectionnez dans les zones d’édition où vous souhaitez référencer ces propriétés afin que la liste de contenu dynamique s’affiche. Dans la liste, sous l’en-tête Analyser JSON, sélectionnez les jetons de données pour les propriétés de contenu JSON que vous souhaitez.

Étapes suivantes