Metadata mengubah sebuah materialisasi menjadi bukti. Jumlah baris, total, atau pratinjau singkat yang dicatat setiap kali asset berjalan memungkinkan Anda menemukan hari yang bermasalah dalam riwayat asset tanpa membuka datanya.
Ada dua tempat untuk menambahkannya. Metadata runtime berubah di setiap run. Jika asset mengembalikan sebuah nilai untuk disimpan oleh IO manager, panggil context.add_output_metadata({"row_count": len(rows)}) sebelum mengembalikannya. Jika asset menulis datanya sendiri (tabel warehouse, sebuah file), kembalikan dg.MaterializeResult(metadata={...}): Dagster mencatat materialisasi dan metadatanya, dan tidak memanggil IO manager.
Metadata definisi bersifat tetap, ditulis pada dekorator: @dg.asset(metadata={"docs": dg.MetadataValue.url("...")}). Metadata ini mendeskripsikan asset, bukan satu run.
Nilai Python biasa bisa dipakai (int, float, string, dict). dg.MetadataValue membuat tipenya eksplisit: .int, .float, .text, .md untuk pratinjau Markdown, .url, .path, dan .json.
Nilainya disimpan oleh IO manager, dan jumlah baris dicatat bersama materialisasi ini.