INFO.ANNOTATIONS

Syntaxe

Paramètres

Description

Cette fonction permet de retourner la liste de toutes les annotations présentes dans le modèle actuel, avec des colonnes correspondant au schéma des objets d'annotation.

Remarques

• Concept et objectif de INFO.ANNOTATIONS : La fonction INFO.ANNOTATIONS est utilisée pour accéder aux annotations présentes dans un modèle de données. Les annotations sont des métadonnées ou des informations supplémentaires associées aux objets du modèle, comme des mesures, des colonnes ou des tables. Cette fonction permet de lister toutes ces annotations, offrant ainsi une vue complète des informations supplémentaires qui ont été ajoutées pour documenter ou contrôler le modèle.
• Rôle des paramètres Restriction name et Restriction value : Les paramètres Restriction name et Restriction value permettent de filtrer les annotations retournées selon des critères spécifiques. Par exemple, on peut demander uniquement les annotations correspondant à un certain type ou à une valeur particulière. Ces filtres facultatifs sont utiles pour cibler des informations précises dans des modèles complexes comportant de nombreuses annotations.
• Type de valeur retournée : INFO.ANNOTATIONS retourne une table structurée contenant les annotations. Chaque ligne représente une annotation, et les colonnes correspondent aux attributs ou au schéma de l'objet d'annotation, tels que le nom de l'objet, le type de restriction et la valeur associée. Cette sortie facilite l'analyse et la documentation du modèle de données.
• Applications pratiques dans le développement : Cette fonction est particulièrement utile pour les développeurs et administrateurs de modèles Power BI ou Analysis Services souhaitant documenter le modèle ou vérifier les métadonnées. Elle permet de s'assurer que toutes les annotations sont correctement appliquées et de détecter les annotations manquantes, obsolètes ou redondantes dans le modèle.
• Comparaison avec d'autres fonctions INFO : INFO.ANNOTATIONS appartient à la famille des fonctions INFO qui fournissent des informations sur le modèle plutôt que de calculer des valeurs de données. Contrairement à d'autres fonctions INFO qui donnent des informations sur les formats ou le contexte de calcul, INFO.ANNOTATIONS se concentre sur les métadonnées et les informations documentaires des objets du modèle.
• Bonnes pratiques pour l'utilisation : Il est recommandé d'utiliser INFO.ANNOTATIONS pour auditer ou documenter le modèle plutôt que dans des mesures de production. L'usage de filtres via Restriction name et Restriction value est conseillé pour limiter le volume de données retourné et rendre l'analyse plus lisible. Cette fonction est particulièrement efficace pour vérifier la conformité des annotations dans des modèles collaboratifs ou complexes.
• Impact sur les performances : INFO.ANNOTATIONS a un impact minimal sur les performances, car elle retourne uniquement des métadonnées et non des calculs sur des données volumineuses. Toutefois, sur des modèles très grands comportant de nombreuses annotations, le résultat peut être volumineux et nécessiter un filtrage ou un traitement supplémentaire pour en faciliter l'exploitation.
• Limitations et portée : INFO.ANNOTATIONS ne modifie pas les annotations et ne crée pas de nouvelles informations. Elle se limite à fournir une vue sur les annotations existantes dans le modèle. Si aucun objet annoté n'existe ou si les restrictions spécifiées ne correspondent à aucun critère, la fonction retourne une table vide. Elle sert exclusivement à l'audit, à la documentation et à l'analyse des métadonnées du modèle.