Seeds et données de référence

Les seeds dbt sont des fichiers CSV statiques que dbt charge dans la base de données sous forme de tables ordinaires. nhic_dbt fournit plus de 40 CSV de seeds dans le répertoire seeds/, couvrant les correspondances d’établissements, les classifications administratives, les tables de codes et d’autres données de référence qui évoluent rarement.

À quoi servent les seeds

Les seeds sont le bon choix lorsque :

• Les données sont statiques ou changent rarement (une nouvelle version est nécessaire pour les mettre à jour)
• Les données sont assez petites pour être committées dans git sous forme de CSV
• Les données sont des données de référence faisant autorité — tables de codes, classifications, listes d’établissements approuvés

Les seeds sont le mauvais choix lorsque :

• Les données proviennent d’un système externe et changent fréquemment — utilisez plutôt un modèle de staging
• Les données sont volumineuses (des milliers de lignes ou plus) — envisagez un modèle de staging adossé à une table source

Charger les seeds

# Load all seeds
dbt seed
 
# Load a specific seed by name
dbt seed --select facility_mapping
 
# Full refresh (truncate and reload)
dbt seed --full-refresh

Les seeds sont chargés par défaut dans le schéma staging (configuré dans dbt_project.yml).

Utiliser les seeds dans les modèles

Référencez un seed dans un modèle avec {{ ref() }}, exactement comme n’importe quel autre modèle dbt :

-- models/intermediate/int_visits__enriched.sql
select
    v.visit_id,
    v.facility_code,
    f.facility_name,
    f.district,
    f.province
from {{ ref('stg_cemr__visits') }} v
left join {{ ref('facility_mapping') }} f
    on v.facility_code = f.facility_code

dbt suit cette dépendance dans le DAG, ce qui garantit que les seeds sont chargés avant tout modèle qui les référence.

Ajouter ou mettre à jour un seed

1. Ajoutez ou modifiez le fichier CSV dans seeds/.
2. Si vous ajoutez un nouveau seed, déclarez les types de colonnes dans dbt_project.yml sous seeds: afin d’empêcher dbt d’inférer des types incorrects.
3. Exécutez dbt seed --select <seed_name> en local pour vérifier qu’il se charge correctement.
4. Ouvrez une PR — la CI validera le seed dans le cadre de dbt build.