Comment documenter les sources de données dans Azure Data Catalog

Introduction

Microsoft Azure Data Catalog est un service cloud entièrement géré qui sert de système d'inscription et de détection des sources de données d'entreprise. En d’autres termes, Microsoft Azure Data Catalog vise essentiellement à aider les utilisateurs à détecter, comprendreet utiliser des sources de données, et permet aux organisations de mieux exploiter leurs données.

Lorsqu’une source de données est inscrite dans Azure Data Catalog, ses métadonnées sont copiées et indexées par le service. Mais ce n’est pas tout. Azure Data Catalog permet également aux utilisateurs de fournir leur propre documentation complète pour décrire l’utilisation et les scénarios courants de la source de données.

Dans l’article annotation de sources de données, vous apprenez que les experts ayant une bonne connaissance de la source de données peuvent l’annoter avec des balises et une description. Le portail Azure Data Catalog inclut un éditeur de texte qui permet aux utilisateurs de documenter entièrement les ressources de données et les conteneurs. L’éditeur inclut une mise en forme des paragraphes, avec notamment des en-têtes, la mise en forme du texte, des listes à puces, des listes numérotées et des tableaux.

Les balises et descriptions sont idéales pour ajouter des annotations simples. Toutefois, pour aider les consommateurs de données à mieux comprendre l’utilisation d’une source de données et les scénarios commerciaux d’une source de données, un expert peut fournir une documentation complète et détaillée. Il est facile de documenter une source de données. Il suffit de sélectionner une ressource de données ou un conteneur et de choisir l’option Documentation.

Documentation de ressources de données

La documentation Azure Data Catalog vous permet d’utiliser votre catalogue de données comme référentiel de contenu pour créer une narration complète de vos ressources de données. Vous pouvez explorer le contenu détaillé décrivant les conteneurs et tables. Si vous utilisez déjà un autre référentiel de contenu, tel que SharePoint ou un partage de fichiers, vous pouvez ajouter des liens de documentation à votre ressource pour référencer ce contenu existant. Vos documents existants seront ainsi mieux exposés.

Le niveau de documentation peut aller d’une simple description des caractéristiques et de la valeur d’un conteneur de ressources de données à une description détaillée du schéma de table dans un conteneur. Le niveau de documentation fourni doit être dicté par vos besoins métiers. De façon générale, voici cependant quelques avantages et inconvénients associés à la documentation de ressources de données :

• Documenter uniquement un conteneur : tout le contenu se trouve dans un même emplacement, mais ne comporte sans doute pas les informations nécessaires pour permettre aux utilisateurs de prendre une décision informée.
• Documenter uniquement les tables : le contenu se rapporte à l’objet en question, mais les documents sont disséminés à plusieurs emplacements.
• Documenter les conteneurs et les tables : l’approche la plus complète, qui peut toutefois impliquer un effort supplémentaire pour la gestion des documents.

Résumé

La documentation des sources de données avec Azure Data Catalog peut créer une narration sur vos ressources de données avec le degré de détail dont vous avez besoin. À l’aide de liens, vous pouvez référencer du contenu stocké dans un référentiel de contenu existant qui rassemble vos documents et vos ressources de données existants. Une fois que vos utilisateurs accèdent aux ressources de données appropriées, ils peuvent bénéficier d’un ensemble de documentation complet.