dbt unter Linux 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 python3 --version, command -v python3 und die Distribution. Diese Anleitung verwendet eine eigene Python-Umgebung. Fehlt unter Ubuntu das venv-Modul, richte das passende python3-venv-Paket über die Paketverwaltung ein. Verwende nicht sudo pip, um einen Fehler der System-Python-Installation zu übergehen.

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 python
command -v dbt

Die Aktivierung gilt für die aktuelle Shell. Nach einer neuen Anmeldung musst du sie wiederholen oder den vollständigen .venv/bin/dbt-Pfad verwenden. Ein Cronjob erbt diese interaktive Shell-Umgebung nicht automatisch; geplante Ausführung ist ein eigener Einrichtungsschritt.

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 Linux

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.