Documentare le origini datiDocument data sources

IntroduzioneIntroduction

Microsoft Azure Data Catalog è un servizio cloud completamente gestito che funge da sistema di registrazione e di individuazione per origini dati aziendali.Microsoft Azure Data Catalog is a fully managed cloud service that serves as a system of registration and system of discovery for enterprise data sources. In altre parole, Azure Data Catalog permette agli utenti di trovare, comprenderee usare le origini dati e consente alle organizzazioni di ottenere maggior valore dai dati esistenti.In other words, Azure Data Catalog is all about helping people discover, understand, and use data sources, and helping organizations to get more value from their existing data.

Quando un'origine dati viene registrata con Azure Data Catalog, i relativi metadati vengono copiati e indicizzati dal servizio, ma non è tutto.When a data source is registered with Azure Data Catalog, its metadata is copied and indexed by the service, but the story doesn’t end there. Azure Data Catalog consente agli utenti di fornire una documentazione completa per descrivere l'utilizzo e scenari comuni per l'origine dati.Azure Data Catalog also allows users to provide their own complete documentation that can describe the usage and common scenarios for the data source.

L'articolo Come annotare le origini datimostra come gli esperti che conoscono l'origine dati possono annotarla con tag e descrizioni.In How to annotate data sources, you learn that experts who know the data source can annotate it with tags and a description. Il portale di Azure Data Catalog include un editor di testo RTF per permettere agli utenti di documentare in modo esauriente gli asset di dati e i contenitori.The Azure Data Catalog portal includes a rich text editor so that users can fully document data assets and containers. L'editor include la formattazione paragrafo, con intestazioni, formattazione del testo, elenchi puntati, elenchi numerati e tabelle.The editor includes paragraph formatting, such as headings, text formatting, bulleted lists, numbered lists, and tables.

Tag e descrizioni sono utili per inserire semplici annotazioni.Tags and descriptions are great for simple annotations. Tuttavia, per avere una migliore comprensione di un'origine dati e dei relativi scenari di business gli utilizzatori di dati possono rivolgersi a un esperto per una documentazione completa e dettagliata.However, to help data consumers better understand the use of a data source, and business scenarios for a data source, an expert can provide complete, detailed documentation. È facile documentare un'origine dati.It's easy to document a data source. Selezionare un contenitore o un asset di dati e scegliere Documentazione.Select a data asset or container, and choose Documentation.

Documentare gli asset di datiDocumenting data assets

La documentazione permette di usare Azure Data Catalog come un repository per creare un resoconto completo degli asset di dati.The benefit of Azure Data Catalog documentation allows you to use your Data Catalog as a content repository to create a complete narrative of your data assets. È possibile esplorare contenuti dettagliati che descrivono i contenitori e le tabelle.You can explore detailed content that describes containers and tables. Se sono già presenti contenuti in un altro repository, ad esempio SharePoint o una condivisione file, è possibile aggiungere alla documentazione degli asset collegamenti che fanno riferimento al contenuto esistente.If you already have content in another content repository, such as SharePoint or a file share, you can add to the asset documentation links to reference this existing content. Questa funzione rende i documenti esistenti più facilmente individuabili.This feature makes your existing documents more discoverable.

Nota

La documentazione non è inclusa nell'indice di ricerca.Documentation is not included in search index.

Il livello di documentazione va dalla descrizione delle caratteristiche e del valore di un contenitore di asset di dati alla descrizione dettagliata dello schema di tabella all'interno di un contenitore.The level of documentation can range from describing the characteristics and value of a data asset container to a detailed description of table schema within a container. Il livello di documentazione fornito deve essere proporzionato alle esigenze aziendali.The level of documentation provided should be driven by your business needs. In linea generale, ecco alcuni vantaggi e svantaggi legati alla documentazione degli asset di dati:But in general, here are a few pros and cons of documenting data assets:

  • Documentare solo un contenitore: tutto il contenuto è in un'unica posizione, ma potrebbe non fornire agli utenti tutti i dettagli necessari per prendere decisioni basate su informazioni aggiornate.Document just a container: All the content is in one place, but might lack necessary details for users to make an informed decision.
  • Documentare solo le tabelle: il contenuto è specifico dell'oggetto, ma i documenti degli utenti non si trovano in un'unica posizione.Document just the tables: Content is specific to that object, but your users have multiple places for documents.
  • Documentare contenitori e tabelle: è l'approccio più completo, ma potrebbe richiedere una maggiore manutenzione dei documenti.Document containers and tables: Most comprehensive approach, but might introduce more maintenance of the documents.

SummarySummary

La documentazione delle origini dati con Azure Data Catalog permette di creare un resoconto sugli asset di dati con un livello di dettaglio basato sulle esigenze.Documenting data sources with Azure Data Catalog can create a narrative about your data assets in as much detail as you need. È possibile creare collegamenti a contenuti archiviati in un repository esistente che riunisce i documenti e gli asset di dati esistenti.By using links, you can link to content stored in an existing content repository, which brings your existing docs and data assets together. Dopo aver trovato gli asset di dati appropriati, gli utenti hanno a disposizione un set di documentazione completo.Once your users discover appropriate data assets, they can have a complete set of documentation.