Test technique Data Contracts : implémenter avec dbt et OpenAPI

Les data contracts formalisent les engagements entre producteurs et consommateurs de données. En 2025, c est un sujet d entretien Senior qui différencie les profils avec une vraie culture de gouvernance.

Data Builder·Juin 2025·6 min de lecture·Analytics Engineer · Data Engineer

Sommaire

Qu est-ce qu un data contract
Composants d un contract
Implémenter avec dbt
Schema versioning
Processus organisationnel
Outils et frameworks
Grille

1Définition et valeur ajoutée

Question discriminante

Qu est-ce qu un data contract ? Quel problème concret résout-il ?

Data contract — accord formel entre le producteur d un dataset et ses consommateurs, spécifiant le schéma, la qualité, la fraîcheur et les SLA
Problème résolu — sans contract, un Data Engineer peut renommer une colonne sans savoir que 5 dashboards en dépendent. Avec un contract, le changement doit être negocié et communiqué
Analogie — comme un contrat d API REST (OpenAPI), mais pour les données
Popularisé par — Chad Sanderson (Data Products), Andrew Jones (Data Contracts book)

2Les 4 composants d un data contract

Question discriminante

Quels éléments doit contenir un data contract complet ?

# data-contract.yaml (format standard emergent)
apiVersion: v2.0.0
kind: DataContract
id: orders-v2
info:
  title: Orders Dataset
  version: 2.1.0
  owner: equipe-commerce
  contact: data-commerce@entreprise.com

schema:
  type: dbt
  path: models/marts/commerce/fct_orders.sql
  fields:
    - name: order_id
      type: string
      required: true
      unique: true
    - name: amount
      type: float
      minimum: 0
    - name: status
      type: string
      enum: [completed, pending, cancelled]

quality:
  freshness: 1h          # données fraîches dans l heure
  completeness: 99.9%    # moins de 0.1% de nulls sur order_id

terms:
  usage: Données internes uniquement
  noticePeriod: 30 jours avant breaking change

3Implémenter avec dbt

Question discriminante

Comment utilisez-vous dbt pour enforcer un data contract ?

sources.yml — définir le contrat sur les données sources : fraîcheur, schéma attendu
Tests YAML — not_null, unique, accepted_values, relationships : les tests dbt sont la forme la plus simple de contract enforcement
dbt-contracts (package) — package qui formate les tests dbt comme des contrats explicites avec des SLA
schema.yml — la documentation dbt + les tests = un contract vivant et exécutable

sources:
  - name: commerce
    freshness:
      warn_after: {count: 12, period: hour}
      error_after: {count: 24, period: hour}
    tables:
      - name: orders
        loaded_at_field: updated_at
        columns:
          - name: order_id
            tests: [not_null, unique]
          - name: status
            tests:
              - accepted_values:
                  values: [completed, pending, cancelled]

4Schema versioning : gérer les breaking changes

Question discriminante

Comment gérez-vous une breaking change sur un dataset qui a des consommateurs ?

Semantic versioning — MAJOR.MINOR.PATCH : breaking change = incrémentation MAJOR
Backward compatible changes — ajouter une colonne nullable : MINOR. Supprimer ou renommer une colonne : MAJOR
Dépréciation progressive — maintenir l ancienne colonne avec un flag deprecated pendant 30 jours, documenter la migration
Communication — notifier tous les consommateurs enregistrés avant toute breaking change
Consumers registry — tenir un registre des consommateurs de chaque dataset (exposures dbt)

5Processus organisationnel

Question discriminante

Comment convainquez-vous une équipe de mettre en place des data contracts ?

Commencer par les datasets critiques — les 5-10 tables les plus consommées, pas toute la stack d un coup
Outiller le producteur — le contract doit être facile à créer et à maintenir. Si c est une corvée, personne ne le fera
Automatiser la validation — les tests de contract doivent tourner automatiquement en CI à chaque PR
Data stewards — désigner des responsables par domaine pour valider et maintenir les contracts

6Outils et frameworks en 2025

Data Contract CLI — outil open source pour créer, valider et publier des data contracts (format YAML standard)
dbt + tests YAML — la forme la plus répandue et la plus pratique de data contract pour les équipes dbt
Soda — framework de qualité qui supporte les data contracts avec des SLA explicites
DataHub / OpenMetadata — catalogues qui peuvent stocker et publier les contracts

7Grille par niveau

Niveau	Maitrise	Signal GO	NO-GO
Confirmé	Comprend le concept, sait qu un test dbt est une forme de contract	Peut expliquer pourquoi les data contracts existent, a mis des tests dbt en place	N a jamais entendu parler de data contracts
Senior	A formalisé des contracts YAML, gère le versioning, communique les breaking changes	A mis en place des contracts sur des datasets critiques, gère la dépréciation	Ne sait pas comment gérer une breaking change sans casser les consommateurs

Vous recrutez un Analytics Engineer Senior ?

Premier entretien gratuit. Rapport GO/NO-GO sous 48h.

Tester gratuitement Reserver un appel