Installation

Test de fumée

🎉 Il est temps de lancer la machine! 🎉

Le virtualenv / poetry env à utiliser pour exécuter l'ETL devrait généralement être celui du dossier core.dashboards_store. Si vous voulez utiliser un ensemble de dépendances personnalisé, vous devez configurer cssXX.dashboards_store/pyproject.toml selon vos besoins.

Nous supposons que vous avez un terminal ouvert dans le dossier <working dir>.

  1. Activer l'environnement Python

    L'environnement Python doit être activé pour que dbt puisse s'exécuter. Si vous obtenez une erreur indiquant que la commande dbt est introuvable, vous avez probablement oublié de l'activer.

cd core.dashboards_store
eval $(poetry env activate)
L'environnement Poetry doit être activé chaque fois que vous voulez exécuter dbt, et dans chaque terminal ou fenêtre bash depuis laquelle vous voulez l'utiliser.
  1. Revenir dans le dossier cssXX.dashboards_store

    Comme votre projet cssXX.dashboards_store peut remplacer certains modèles du Core, et puisqu'il implémente les contrats définis par le Store, vous devriez toujours exécuter l'ETL depuis le dossier cssXX.dashboards_store.

cd ../cssXX.dashboards_store
  1. Exécuter la commande de diagnostic pour tester la connexion:
dbt debug

La sortie devrait ressembler à ceci:

15:29:16  Running with dbt=1.4.7
dbt version: 1.4.7
python version: 3.8.10
python path: /home/<store_user>/.cache/pypoetry/virtualenvs/core.dashboards_store-pQVMzw-y-py3.8/bin/python
os info: Linux-5.10.16.3-microsoft-standard-WSL2-x86_64-with-glibc2.29
Using profiles.yml file at /home/<store_user>/<working_directory>/<cssXX>.dashboards_store/profiles.yml
Using dbt_project.yml file at /home/<store_user>/<working_directory>/<cssXX>.dashboards_store/dbt_project.yml

Configuration:
  profiles.yml file [OK found and valid]
  dbt_project.yml file [OK found and valid]

Required dependencies:
 - git [OK found]

Connection:
  server: <store\'s server IP>
  database: <store_dev>
  schema: <store_user> -- the default schema should be your name
  port: <store\'s server port>
  UID: <store_user>
  client_id: None
  authentication: sql
  encrypt: True
  trust_cert: True
  retries: 1
  login_timeout: 0
  query_timeout: 0
  Connection test: [OK connection ok]

All checks passed!
Yé! Vous êtes maintenant prêt à alimenter, configurer et exécuter l'ETL!

Qu'est-ce que je viens de faire?

  • Si vous obtenez le magnifique All checks passed!, votre projet est bien configuré. Vous n'avez encore rien matérialisé, mais vous savez au moins que la base de données est joignable depuis votre ordinateur. Il vous reste à alimenter les différentes seeds et les modèles, puis à configurer cssXX.dashboards_store/dbt_project.yml pour matérialiser les modèles sous-jacents aux dashboards.
  • Si vous obtenez une erreur, quelque chose ne fonctionne pas:
    • Vérifiez que les identifiants de la base de données sont corrects, par exemple en essayant de vous connecter à la base avec les mêmes identifiants dans SSMS.
    • Vérifiez que la base de données est bien joignable depuis votre ordinateur avec telnet <ip_de_la_base> <port_de_la_base>.
    • Recherchez le message d'erreur; il s'agit peut-être d'un problème courant. Que la première page de Google vous soit favorable.
Copyright © 2026