Cara mendokumentasi sumber data di Azure Data Catalog

  • Artikel

Penting

Azure Data Catalog dihentikan pada 15 Mei 2024.

Akun Azure Data Catalog baru tidak dapat lagi dibuat.

Untuk fitur katalog data, silakan gunakan layanan Microsoft Purview , yang menawarkan tata kelola data terpadu untuk seluruh data estate Anda.

Jika Anda sudah menggunakan Azure Data Catalog, Anda harus membuat rencana migrasi agar organisasi Anda pindah ke Microsoft Purview sebelum 15 Mei 2024.

Pengantar

Microsoft Azure Data Catalog adalah layanan cloud yang dikelola penuh yang berfungsi sebagai sistem pendaftaran dan sistem penemuan untuk sumber data perusahaan. Dengan kata lain, Azure Data Catalog berkaitan dengan membantu orang menemukan, memahami, dan menggunakan sumber data, serta membantu organisasi lebih memaksimalkan manfaat dari data yang sudah ada.

Saat sumber data didaftarkan dengan Azure Data Catalog, metadatanya akan disalin dan diindeks oleh layanan, tetapi bukan hanya itu saja. Azure Data Catalog juga memungkinkan pengguna untuk menyediakan dokumentasi lengkap mereka sendiri yang dapat menggambarkan penggunaan dan skenario umum untuk sumber data.

Dalam artikel cara membuat anotasi sumber data, Anda mempelajari bahwa para ahli yang mengetahui sumber data dapat membuat anotasi dengan tag dan deskripsi. Portal Azure Data Catalog menyertakan editor teks kaya sehingga pengguna dapat sepenuhnya mendokumentasikan aset dan kontainer data. Editor menyertakan pemformatan paragraf, seperti judul, pemformatan teks, daftar berpoin, daftar bernomor, dan tabel.

Tag dan deskripsi sangat bagus untuk anotasi sederhana. Namun, untuk membantu konsumen data lebih memahami penggunaan sumber data, dan skenario bisnis untuk sumber data, seorang ahli dapat memberikan dokumentasi yang lengkap dan terperinci. Sangat mudah untuk mendokumentasikan sumber data. Pilih aset data atau kontainer, dan pilih Dokumentasi.

Aset data dipilih, dengan tab dokumentasi ditampilkan seperti yang dipilih di jendela di bawahnya.

Mendokumentasikan aset data

Dengan dokumentasi Azure Data Catalog, Anda bisa menggunakan Katalog Data sebagai repositori konten untuk membuat narasi lengkap aset data Anda. Anda dapat menjelajahi konten terperinci yang menjelaskan kontainer dan tabel. Jika Anda sudah memiliki konten di penyimpanan konten lain, seperti SharePoint atau berbagi file, Anda bisa menambahkan link dokumentasi aset untuk mereferensikan konten yang sudah ada ini. Fitur ini membuat dokumen Anda yang sudah ada lebih mudah ditemukan.

Catatan

Dokumentasi tidak disertakan dalam indeks pencarian.

Tautan dalam dokumentasi ditampilkan untuk dipilih, dan ketika dipilih, jendela browser baru dibuka untuk menampilkan konten tertaut.

Tingkat dokumentasi dapat berkisar dari menggambarkan karakteristik dan nilai kontainer aset data hingga deskripsi terperinci tentang skema tabel dalam kontainer. Tingkat dokumentasi yang disediakan harus didorong oleh kebutuhan bisnis Anda. Tetapi secara umum, berikut adalah beberapa pro dan kontra dari mendokumentasikan aset data:

  • Dokumen hanya wadah: Semua konten berada di satu tempat, tetapi mungkin tidak memiliki detail yang diperlukan bagi pengguna untuk membuat keputusan berdasarkan informasi.
  • Dokumen hanya tabel: Konten khusus untuk objek tersebut, tetapi pengguna Anda memiliki beberapa tempat untuk dokumen.
  • Wadah dan tabel dokumen: Pendekatan paling komprehensif, tetapi mungkin memperkenalkan lebih banyak pemeliharaan dokumen.

Ringkasan

Mendokumentasikan sumber data dengan Azure Data Catalog dapat membuat narasi tentang aset data Anda secara terperinci sebanyak yang Anda butuhkan. Dengan menggunakan link, Anda dapat menautkan ke konten yang disimpan dalam repositori konten yang sudah ada, yang menyatukan dokumen dan aset data Anda yang sudah ada. Setelah pengguna Menemukan aset data yang sesuai, mereka dapat memiliki serangkaian dokumentasi lengkap.