Partager via

Actualiser l’activité de l'endpoint SQL

L’activité Actualiser le point de terminaison SQL dans les pipelines Microsoft Fabric vous permet d’actualiser par programmation un point de terminaison SQL Lakehouse dans le cadre d’un flux de travail orchestré. Cette approche garantit que les consommateurs en aval, tels que les rapports Power BI, les notebooks ou les clients SQL externes, voient les données les plus récentes après la préparation des données ou les étapes de maintenance terminées.

Utilisez cette activité pour que les points de terminaison SQL reflètent immédiatement les mises à jour récentes sans compter sur les actualisations manuelles ou les processus ad hoc. Utilisez cette activité lorsque votre pipeline :

  • Met à jour ou gère les données du Lakehouse (par exemple, après les travaux de copie, l’exécution du Notebook ou les activités de maintenance du Lakehouse).
  • Le point de terminaison SQL du Lakehouse doit refléter les dernières métadonnées ainsi que les modifications des données.
  • Nécessite un minutage d’actualisation déterministe avant les étapes en aval telles que la création de rapports, l’analytique ou les exportations.

Prerequisites

Avant d’utiliser cette activité, assurez-vous que :

Ajoutez une activité d'actualisation du point de terminaison SQL à votre pipeline dans l'interface utilisateur.

  1. Créez un pipeline dans votre espace de travail.  

  2. Recherchez Actualiser le point de terminaison SQL dans le volet Activités du pipeline et sélectionnez-le pour l’ajouter au canevas du pipeline.  

    Capture d’écran de l’activité Actualiser le point de terminaison SQL dans le volet Activités.

  3. Sélectionnez la nouvelle activité Actualiser le point de terminaison SQL sur le canevas s’il n’est pas déjà sélectionné.  

    Capture d’écran de l’activité Actualiser le point de terminaison SQL sur le canevas du pipeline.

  4. Reportez-vous aux instructions relatives aux paramètres Général pour configurer l’onglet Paramètres Général .

Actualiser les paramètres d’activité du point de terminaison SQL

  1. Sélectionnez l’onglet Paramètres pour configurer l’activité.  

  2. Configurez la connexion en sélectionnant une connexion existante dans la liste déroulante Connexion , ou en créant une connexion et en spécifiant ses détails de configuration.

  3. Spécifiez l’espace de travail qui contient le Lakehouse.

  4. Spécifiez le point de terminaison SQL qui contient la vue lake matérialisée à actualiser. Ce point de terminaison SQL est le Lakehouse pour lequel vous souhaitez actualiser le point de terminaison SQL. Point de terminaison SQL associé au Lakehouse sélectionné.

    Capture d’écran des paramètres d’activité Actualiser le point de terminaison SQL.

Comportement de l’activité

Une fois l’exécution de l’activité terminée :

  • Si la fenêtre contextuelle Sortie affiche l’état Réussite , la requête synchronise correctement les données non synchronisées.

    Capture d’écran d’un état de réussite dans la fenêtre contextuelle Sortie de l’activité.

  • Un état NotRun dans la fenêtre contextuelle Sortie signifie que l’actualisation du point de terminaison SQL n’a pas été exécutée. Cette condition signifie généralement que vous n’avez pas ajouté de nouvelles données depuis la dernière synchronisation. Vous n’avez donc pas besoin de l’exécuter.

    Capture d’écran d’un état NotRun dans la fenêtre contextuelle Sortie de l’activité.

  • Si la fenêtre contextuelle Sortie affiche l’état Échec , un problème s’est produit.

Note

L'exécution de l'activité définit ces états dans la fenêtre contextuelle de sortie. Ne confondez pas ces états avec l’état d’activité lui-même.

Scénarios courants

  • Actualisation du point de terminaison SQL après qu’un notebook écrit des données transformées dans un Lakehouse.
  • Déclenchement d’une actualisation du point de terminaison SQL une fois les opérations d’optimisation ou de vide terminées.
  • S'assurer que les rapports et les tableaux de bord interrogent l'état le plus récent de la Lakehouse à des points bien définis dans un pipeline.

Pourquoi mon actualisation du point de terminaison SQL échoue-t-elle lorsque les données sous-jacentes sont verrouillées ?

L’activité Actualiser le point de terminaison SQL peut échouer par intermittence lorsque d’autres processus mettent activement à jour les données Lakehouse sous-jacentes. Ces processus incluent des pipelines d’ingestion, des notebooks ou des opérations d’écriture simultanées.

Cet échec se produit, car le point de terminaison SQL doit acquérir des verrous internes pour terminer l’actualisation. Si une autre opération verrouille les données, la requête expire ou retourne une erreur.

Ce comportement est attendu en fonction de la façon dont les points de terminaison SQL gèrent les opérations d’actualisation des métadonnées.

Symptoms

  • L’activité échoue par intermittence, pas de manière cohérente.
  • Les messages d’erreur indiquent des conflits d’actualisation ou des conflits de verrouillage.
  • Les pipelines avec plusieurs activités de point de terminaison SQL d’actualisation séquentielle affichent des taux d’échec plus élevés.

Origine

Les points de terminaison SQL nécessitent un accès exclusif à certaines structures de métadonnées pendant l’actualisation. Si un autre processus de calcul écrit dans le Lakehouse en même temps, il y a une contention de verrouillage.

Ce comportement n’est pas un défaut dans l’activité Actualiser le point de terminaison SQL. Il s’agit du résultat naturel des opérations de lecture et d’écriture simultanées sur les données sous-jacentes.

Solutions de contournement

Deux approches pratiques peuvent atténuer ce problème :

Utiliser une seule activité d’actualisation du point de terminaison SQL à la fin du traitement

Pour réduire la probabilité de conflits de verrous, consolidez votre pipeline afin que :

  • Toutes les activités d’ingestion, de transformation et de mise à jour s’exécutent en premier,
  • À la fin, une seule activité de rafraîchissement du point de terminaison SQL s’exécute.
  • Cette approche n’élimine pas complètement les défaillances, mais réduit considérablement la fréquence à laquelle elles se produisent.

Implémenter une planification d’actualisation périodique

Si votre scénario ne nécessite pas de cohérence transactionnelle stricte à un moment spécifique, adoptez un modèle d’actualisation périodique :

  • Planifiez une actualisation toutes les 15 minutes, en continu. Certaines tentatives d’actualisation peuvent échouer en raison du verrouillage, mais suffisamment de réussite pour maintenir votre point de terminaison SQL relativement à jour.

Capture d’écran d’une configuration périodique de planification de l’actualisation du point de terminaison SQL.

Cette approche est pratique et robuste pour de nombreuses charges de travail d’analytique.

Enregistrer et exécuter ou planifier le pipeline

Basculez vers l’onglet Accueil en haut de l’éditeur de pipeline et sélectionnez le bouton Enregistrer pour enregistrer votre pipeline. Sélectionnez Exécuter pour l’exécuter directement ou planifier des exécutions à des moments ou intervalles spécifiques. Pour plus d’informations sur les exécutions de pipeline, consultez : planifier des exécutions de pipeline.

Capture d'écran montrant l'onglet Accueil dans l'éditeur de pipeline avec le nom de l'onglet, les boutons Enregistrer, Exécuter et Planifier en surbrillance.

Après l’exécution, vous pouvez surveiller l’exécution du pipeline et afficher l’historique des exécutions à partir de l’onglet Sortie sous le canevas.

Problèmes connus

Contenu connexe

  • Last updated on