Jak dokumentować źródła danych w usłudze Azure Data Catalog

  • Artykuł

Ważne

Usługa Azure Data Catalog jest wycofywana 15 maja 2024 r.

Nie można już tworzyć nowych kont usługi Azure Data Catalog.

W przypadku funkcji wykazu danych użyj usługi Microsoft Purview , która oferuje ujednolicony nadzór nad danymi dla całego majątku danych.

Jeśli już używasz usługi Azure Data Catalog, musisz utworzyć plan migracji dla organizacji, aby przejść do usługi Microsoft Purview do 15 maja 2024 r.

Wprowadzenie

Usługa Microsoft Azure Data Catalog to w pełni zarządzana usługa w chmurze, która służy jako system rejestracji i systemu odnajdywania dla źródeł danych przedsiębiorstwa. Innymi słowy, usługa Azure Data Catalog polega na pomaganiu ludziom w odkrywaniu, interpretowaniu i używaniu źródeł danych oraz pomaganiu organizacjom w uzyskiwaniu większej wartości z istniejących danych.

Po zarejestrowaniu źródła danych w usłudze Azure Data Catalog jego metadane są kopiowane i indeksowane przez usługę, ale historia się tam nie kończy. Usługa Azure Data Catalog umożliwia również użytkownikom udostępnianie własnej pełnej dokumentacji, która może opisywać użycie i typowe scenariusze dla źródła danych.

W artykule dotyczącym dodawania adnotacji do źródeł danych dowiesz się, że eksperci, którzy znają źródło danych, mogą dodawać adnotacje do tagów i opisu. Portal usługi Azure Data Catalog zawiera edytor tekstu sformatowanego, dzięki czemu użytkownicy mogą w pełni dokumentować zasoby danych i kontenery. Edytor zawiera formatowanie akapitu, takie jak nagłówki, formatowanie tekstu, listy punktowane, listy numerowane i tabele.

Tagi i opisy doskonale nadają się do prostych adnotacji. Jednak aby pomóc konsumentom danych lepiej zrozumieć użycie źródła danych i scenariuszy biznesowych dla źródła danych, ekspert może zapewnić kompletną, szczegółową dokumentację. Dokumentowanie źródła danych jest łatwe. Wybierz zasób danych lub kontener, a następnie wybierz pozycję Dokumentacja.

Zaznaczono zasób danych z kartą dokumentacji pokazaną w oknie poniżej.

Dokumentowanie zasobów danych

Zaletą dokumentacji usługi Azure Data Catalog jest użycie usługi Data Catalog jako repozytorium zawartości w celu utworzenia pełnej narracji zasobów danych. Możesz zapoznać się ze szczegółową zawartością opisającą kontenery i tabele. Jeśli masz już zawartość w innym repozytorium zawartości, takim jak Program SharePoint lub udział plików, możesz dodać do linków dokumentacji zasobów, aby odwołać się do tej istniejącej zawartości. Ta funkcja sprawia, że istniejące dokumenty są bardziej wykrywalne.

Uwaga

Dokumentacja nie jest uwzględniona w indeksie wyszukiwania.

Zostanie wyświetlony link w dokumentacji, a po wybraniu zostanie otwarte nowe okno przeglądarki w celu wyświetlenia połączonej zawartości.

Poziom dokumentacji może obejmować opis cech i wartości kontenera zasobów danych do szczegółowego opisu schematu tabeli w kontenerze. Podany poziom dokumentacji powinien być napędzany potrzebami biznesowymi. Ogólnie jednak poniżej przedstawiono kilka zalet i wad dokumentowania zasobów danych:

  • Dokument tylko kontener: Cała zawartość znajduje się w jednym miejscu, ale może brakować niezbędnych szczegółów dla użytkowników do podjęcia świadomej decyzji.
  • Dokument tylko tabele: zawartość jest specyficzna dla tego obiektu, ale użytkownicy mają wiele miejsc dla dokumentów.
  • Kontenery i tabele dokumentów: najbardziej kompleksowe podejście, ale może wprowadzać większą konserwację dokumentów.

Podsumowanie

Dokumentowanie źródeł danych za pomocą usługi Azure Data Catalog umożliwia utworzenie narracji dotyczącej zasobów danych w miarę potrzeb. Za pomocą linków możesz połączyć się z zawartością przechowywaną w istniejącym repozytorium zawartości, co łączy istniejące dokumenty i zasoby danych. Gdy użytkownicy odnajdą odpowiednie zasoby danych, mogą mieć pełny zestaw dokumentacji.