メタデータは、マテリアライズを根拠に変えます。アセットが実行されるたびに行の数、合計、短いプレビューを記録しておくと、データを開かずにアセットの履歴の中で悪い日を見つけられます。
付ける場所は2つあります。実行時のメタデータは、実行のたびに変わります。アセットがIOマネージャーに保存させる値を返す場合は、返す前にcontext.add_output_metadata({"row_count": len(rows)})を呼び出してください。アセットが自分でデータ(データウェアハウスのテーブル、ファイル)を書き込む場合は、dg.MaterializeResult(metadata={...})を返してください:Dagsterはマテリアライズとメタデータを記録し、IOマネージャーは呼び出しません。
定義のメタデータは固定で、デコレーターに書きます:@dg.asset(metadata={"docs": dg.MetadataValue.url("...")}). 1回の実行ではなく、アセットそのものを説明します。
Pythonのそのままの値(int、float、文字列、dict)が使えます。dg.MetadataValueで型を明示できます:.int、.float、.text、Markdownのプレビューのための.md、.url、.path、.jsonです。