Synchronisation des métadonnées du point de terminaison SQL Analytics

Cet article décrit ce qu’est le point de terminaison d’analyse SQL, comment il reste synchronisé avec votre lakehouse, et les contrôles dont vous disposez pour gérer cette synchronisation. Le point de terminaison d’analyse SQL détecte automatiquement la modification et met à jour ses métadonnées SQL via un processus en arrière-plan. Vous pouvez également actualiser manuellement les métadonnées du point de terminaison d’analytique SQL via le portail Fabric, l’API REST ou la procédure stockée T-SQL.

Le processus en arrière-plan de synchronisation des métadonnées lit les journaux Delta dans le dossier /Tables de OneLake et maintient le schéma SQL à jour.

Microsoft Fabric maintient automatiquement le point de terminaison d’analyse SQL synchronisé avec le lakehouse sous-jacent. Il n’existe aucune infrastructure à configurer et, dans la plupart des cas, aucune action de l’utilisateur n’est requise. La plateforme est responsable des opérations suivantes :

Découverte de tables : détection des tables Delta nouvellement créées ou supprimées dans le lakehouse et création ou suppression des tables SQL correspondantes dans le point de terminaison.
Actualisation des données : détection des modifications (insertions, mises à jour, suppressions) apportées aux données dans les tables existantes et garantie que les requêtes retournent des résultats up-to-date.
Détection des modifications de schéma : détection des ajouts de colonnes, suppressions ou modifications de type dans les tables Delta existantes et actualisation de la définition de table SQL correspondante.

Pour plus d’informations sur le fonctionnement de cette synchronisation et les facteurs qui affectent la latence de synchronisation, consultez les considérations relatives aux performances des points de terminaison d’analyse SQL.

Détection des modifications de schéma et synchronisation des métadonnées

Chaque base de données Lakehouse, entrepôt, base de données et mise en miroir dans Fabric est automatiquement approvisionnée avec son propre point de terminaison d’analytique SQL. Vous pouvez donc interroger des tables Delta avec T-SQL et le protocole TDS, sans déplacer ni copier des données.

Chaque lakehouse, entrepôt de données, base de données et base de données en miroir dispose d’exactement un point de terminaison d’analytique SQL.
Chaque table Delta de l’élément sous-jacent s’affiche automatiquement en tant que table SQL dans le point de terminaison.
Le point de terminaison est en lecture seule sur les tables générées automatiquement. Vous pouvez étendre le modèle avec vos propres schémas, vues, procédures stockées et fonctions SQL.
Le point de terminaison est alimenté par le même moteur de calcul que Fabric Data Warehouse. Il fournit donc des requêtes SQL hautes performances à faible latence sur les fichiers Delta ouverts.

Nouvelle synchronisation des métadonnées (préversion)

Important

Cette fonctionnalité est en version préliminaire.

En mai 2026, la nouvelle synchronisation des métadonnées pour le point de terminaison d’analytique SQL a été annoncée en tant que fonctionnalité en préversion. Vous pouvez activer le nouveau processus de synchronisation des métadonnées, qui s’applique uniquement aux nouveaux points de terminaison d’analytique SQL. La nouvelle option de synchronisation des métadonnées fonctionne pour conserver les données disponibles pour l’interrogation en quelques secondes après son atterrissage dans le lakehouse.

Le nouveau processus de synchronisation des métadonnées comprend les fonctionnalités suivantes :

Nouvelle architecture basée sur des tables externes pour analyser les journaux Delta et créer le catalogue.
Architecture découplée qui détecte les modifications de schéma et de données séparément et actualise le catalogue en conséquence.
Actualisation en arrière-plan qui vérifie régulièrement les mises à jour des données.
Actualisation à la demande des données lorsqu’une requête de lecture entrante se produit et que le système détecte que les données ne sont pas fraîches.

Activer la nouvelle synchronisation des métadonnées

Vous pouvez activer la nouvelle synchronisation des métadonnées sur les espaces de travail en accédant aux paramètres de l’entrepôt sous Paramètres de l’espace de travail.

Lorsque vous activez la nouvelle synchronisation des métadonnées, les nouveaux points de terminaison d’analytique SQL dans l’espace de travail se synchronisent plus rapidement lors de l’actualisation des modifications apportées aux tables sous-jacentes. Les points de terminaison d’analytique SQL existants ne sont pas affectés.

Rechercher quand les métadonnées ont été mises à jour pour la dernière fois

Si vous utilisez la nouvelle version de la synchronisation des métadonnées, vous pouvez utiliser des vues de gestion dynamique (DMV) pour obtenir des détails sur la mise à jour la plus récente vers le point de terminaison d’analyse SQL. Utilisez la vue DMV sys.dm_db_external_tables_log_status pour obtenir des détails sur la dernière synchronisation des métadonnées :

last_update_time_utc: Horodatage pour la dernière fois que la table a été mise à jour avec de nouvelles données.
latest_log_version: version du journal des transactions Delta la plus élevée de la table mise à jour.
latest_checkpoint_version : la dernière version du point de contrôle Delta qui a été traitée.
is_blocked: indique si la dernière tentative de la mise à jour de la table a été bloquée (1) ou réussie (0).

Pour plus d’informations, consultez sys.dm_db_external_tables_log_status.

Limitations de la nouvelle synchronisation des métadonnées

La nouvelle synchronisation de métadonnées ne prend pas en charge le point de contrôle multipart, une fonctionnalité delta déconseillée. Si vos tables lakehouse contiennent des points de contrôle en plusieurs parties, elles ne parviennent pas à être mises à jour dans la nouvelle synchronisation des métadonnées.

Actualisation manuelle

Outre les processus en arrière-plan qui mettent automatiquement à jour les données, vous pouvez actualiser manuellement les métadonnées :

Refresh à partir du portail : dans l’éditeur de point de terminaison SQL Analytics du portail Fabric, sélectionnez l’icône Refresh dans la barre d’outils Explorer pour forcer la synchronisation des métadonnées à la demande. Accédez à Query votre point de terminaison d’analytique SQL et recherchez le bouton Actualiser dans la barre d’outils.
Actualiser avec l’API REST : utilisez l’API REST Actualiser les métadonnées de point de terminaison SQL pour actualiser par programmation les métadonnées d’un point de terminaison d’analyse SQL.
Actualiser par le biais d’une procédure stockée : utilisez la procédure stockée système sys.sp_dw_refresh_ext_table pour actualiser les données d’une table spécifique au sein d’un point de terminaison d’analyse SQL. Cette méthode T-SQL est disponible uniquement si le point de terminaison d’analytique SQL a été créé après l’activation de la nouvelle synchronisation des métadonnées (préversion) . Par exemple:
```
EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";
```

Utilisez l’API uniquement si vous avez des modifications de schéma, telles que l’ajout ou la suppression de tables ou de colonnes, ou si vous modifiez des types de colonnes, et que vous devez actualiser l’élément entier. Pour les modifications portant uniquement sur les données dans un point de terminaison analytique SQL, utilisez la procédure stockée système sys.sp_dw_refresh_ext_table pour mettre à jour une table spécifique.

Pour optimiser les tables Delta sous-jacentes pour obtenir les meilleures performances de synchronisation et de requête des métadonnées, consultez les considérations relatives aux performances des points de terminaison d’analyse SQL.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-05-26