Partilhar via

Como documentar fontes de dados no Catálogo de Dados do Azure

  • Artigo

Importante

O Catálogo de Dados do Azure foi desativado em 15 de maio de 2024.

Para recursos de catálogo de dados, use o serviço Microsoft Purview, que oferece governança de dados unificada para todo o seu conjunto de dados.

Introdução

O Catálogo de Dados do Microsoft Azure é um serviço de nuvem totalmente gerenciado que serve como um sistema de registro e sistema de descoberta para fontes de dados corporativas. Em outras palavras, o Catálogo de Dados do Azure tem tudo a ver com ajudar as pessoas a descobrir, entender e usar fontes de dados e ajudar as organizações a obter mais valor de seus dados existentes.

Quando uma fonte de dados é registrada no Catálogo de Dados do Azure, seus metadados são copiados e indexados pelo serviço, mas a história não termina aí. O Catálogo de Dados do Azure também permite que os usuários forneçam sua própria documentação completa que pode descrever o uso e os cenários comuns da fonte de dados.

No artigo Como anotar fontes de dados, você aprende que os especialistas que conhecem a fonte de dados podem anotá-la com tags e uma descrição. O portal do Catálogo de Dados do Azure inclui um editor de rich text para que os usuários possam documentar totalmente ativos de dados e contêineres. O editor inclui formatação de parágrafo, como cabeçalhos, formatação de texto, listas com marcadores, listas numeradas e tabelas.

Tags e descrições são ótimas para anotações simples. No entanto, para ajudar os consumidores de dados a entender melhor o uso de uma fonte de dados e os cenários de negócios para uma fonte de dados, um especialista pode fornecer documentação completa e detalhada. É fácil documentar uma fonte de dados. Selecione um ativo de dados ou contêiner e escolha Documentação.

Um ativo de dados é selecionado, com a guia Documentação mostrada como selecionada na janela abaixo.

Documentando ativos de dados

O benefício da documentação do Catálogo de Dados do Azure permite que você use seu Catálogo de Dados como um repositório de conteúdo para criar uma narrativa completa de seus ativos de dados. Você pode explorar conteúdo detalhado que descreve contêineres e tabelas. Se você já tiver conteúdo em outro repositório de conteúdo, como o SharePoint ou um compartilhamento de arquivos, poderá adicionar aos links de documentação do ativo para fazer referência a esse conteúdo existente. Esta funcionalidade torna os seus documentos existentes mais detetáveis.

Nota

A documentação não está incluída no índice de pesquisa.

Um link na documentação é mostrado para ser selecionado e, quando selecionado, uma nova janela do navegador é aberta para exibir o conteúdo vinculado.

O nível de documentação pode variar desde a descrição das características e do valor de um contêiner de ativos de dados até uma descrição detalhada do esquema de tabela dentro de um contêiner. O nível de documentação fornecido deve ser determinado pelas necessidades do seu negócio. Mas, em geral, aqui estão alguns prós e contras de documentar ativos de dados:

  • Documente apenas um contêiner: todo o conteúdo está em um só lugar, mas pode faltar os detalhes necessários para que os usuários tomem uma decisão informada.
  • Documente apenas as tabelas: o conteúdo é específico para esse objeto, mas os usuários têm vários locais para documentos.
  • Contentores e tabelas de documentos: abordagem mais abrangente, mas que poderá introduzir uma maior manutenção dos documentos.

Resumo

Documentar fontes de dados com o Catálogo de Dados do Azure pode criar uma narrativa sobre seus ativos de dados com o máximo de detalhes necessário. Usando links, você pode vincular ao conteúdo armazenado em um repositório de conteúdo existente, que reúne seus documentos e ativos de dados existentes. Depois que os usuários descobrirem ativos de dados apropriados, eles poderão ter um conjunto completo de documentação.