dbt unter macOS installieren und mit Snowflake verbinden

Du richtest eine lokale dbt-Laufzeit ein. Snowflake bleibt ein Cloud-Dienst; es wird nicht auf deinem Rechner installiert. Der hier gewählte Paketweg folgt der aktuellen dbt-v2-Anleitung. Bestehende Python-v1-Projekte bleiben ein getrennter Weg.

1. Zugang und Python vorbereiten

Prüfe in Terminal python3 --version und command -v python3. Verwende eine geeignete Python-Installation für deinen Mac. Apple Silicon und Intel dürfen nicht unbemerkt in verschiedenen Python-Umgebungen vermischt werden. Der Python-Leitfaden für macOS erklärt die Installationswege.

Snowflake-Account und dbt-Plattformkonto sind verschiedene Zugänge. Trial, Demo und lizenzierte Nutzung werden im Einstieg erklärt. Für einen reinen CLI-Versionscheck muss noch keine Snowflake-Abfrage möglich sein.

2. Eigene Umgebung anlegen

Wähle ein neues Arbeitsverzeichnis. Existiert dbt-lab bereits, verwende einen anderen Namen, statt bestehende Dateien zu ersetzen. Führe die folgenden Befehle in derselben Sitzung aus:

mkdir dbt-lab
cd dbt-lab
python3 -m venv .venv
.venv/bin/python -m pip --version

Der letzte Befehl muss pip aus deiner neuen Umgebung anzeigen. Verweist er auf eine andere Installation, kläre den Pfad vor dem Paketdownload.

3. dbt installieren und Version prüfen

.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install dbt
.venv/bin/dbt --version

Die aktuelle Installationshilfe nennt das Paket dbt. Es ist nicht automatisch derselbe Installationsweg wie das ältere Paar dbt-core und dbt-snowflake. Installiere beide Linien nicht in dieselbe Umgebung. Prüfe die gemeldete Version, bevor du ein vorhandenes Projekt öffnest.

4. Den tatsächlich verwendeten Befehl verstehen

source .venv/bin/activate
command -v dbt

Das Beispiel verwendet eine eigene Python-Umgebung. Installiere nicht zusätzlich parallel per Homebrew oder einem Shell-Installer denselben dbt-Befehl. Gibt es bereits eine andere Installation, vergleiche zuerst den mit command -v dbt angezeigten Pfad.

5. Profil und erste Verbindung einrichten

Der gemeinsame Einrichtungsteil zeigt das Snowflake-Profil und ein minimales Projekt. Lege das Profil außerhalb des Repositorys ab und ersetze Beispielpfade durch deinen tatsächlichen Pfad. Account, Nutzer, Rolle, Datenbank, Warehouse und Schema müssen zur eingerichteten Testumgebung passen.

Die Variablen im Beispielprofil müssen in derselben Sitzung gesetzt sein. Ersetze die folgenden Werte durch deinen Account und Nutzer:

export DBT_ACCOUNT='YOUR_ACCOUNT_IDENTIFIER'
export DBT_USER='YOUR_USER'

Nach dem Anlegen von Profil und Projekt führst du aus dessen Verzeichnis aus:

.venv/bin/dbt debug --profiles-dir "/Pfad/zum/Profilordner"

dbt debug prüft Konfiguration und Verbindung; es ersetzt noch keinen erfolgreichen Modelllauf. Danach folgen die im gemeinsamen Teil gezeigten Modell- und Testbefehle. Bei externalbrowser muss der vorgesehene Browserlogin tatsächlich abgeschlossen werden.

Typische Probleme unter macOS

Grenze Installation und Verbindung ein: Funktioniert dbt --version, liegt ein Rollen- oder Profilfehler nicht automatisch am installierten Paket. Verwende für die Diagnose dieselbe Shell und dieselbe Laufzeit.

Einrichtung abschließen

Der lokale Befehl meldet die erwartete Version, das Profil wird gefunden und die erste Verbindung funktioniert. Ein kleines Modell mit bekanntem Soll bestätigt anschließend die Einrichtung. Installationsnotizen sind optional. dbt Cloud hat einen eigenen Einrichtungspfad.