データコントラクト とは？

提供側が項目名や型を変更すると、そのデータを使う集計や分析が動かなくなることがあるよ。そこで、どんなデータをどの条件で渡すかを両側で共有するんだ。取り決めがあるだけで変更を自動的に防ぐわけではなく、確認や連絡の運用も必要だよ。

項目名や型は大切だけれど、値の意味や品質の条件もあるよ。たとえば「金額の単位は円」「注文IDは欠けない」「更新の頻度は合意した条件に従う」といった内容だね。責任を持つチームや問い合わせ先も共有すると、問題が起きたときに相談しやすい。

取り決めの表現方法はいろいろあるよ。Open Data Contract Standardという仕様では、YAMLでスキーマ、品質、チーム、サービス水準などを記述する形式を定めている。すべてのデータコントラクトがこの仕様に従うわけではないので、利用する形式とツールをそろえよう。

それだけではないよ。ファイルの書式が仕様に合うかの確認と、実際のデータが品質ルールを満たすかの確認は別。実データを検証するには、ルールを実行するツールや接続、実行のタイミングなどを用意する。CIや定期的な処理に組み込む方法もあるけれど、自動で全部そろうわけではないんだ。

使っている側への影響を確認し、必要なら版を分けるなど、移行方法を相談しよう。変更前の検証と、提供中の品質確認も役立つ。データメッシュのように複数のチームがデータを提供する場面でも使えるけれど、それ専用の仕組みではない。書いた取り決めを、実際の運用で使うことが大切だよ。