dbt unter Windows 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

Öffne PowerShell und prüfe py --version. Fehlt der Befehl, installiere eine für den gewählten dbt-Stand geeignete Python-Version über den vorgesehenen Softwareweg. Öffne PowerShell danach neu. Der Python-Einstieg für Windows erklärt Launcher und Installation.

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
Set-Location dbt-lab
py -m venv .venv
.\.venv\Scripts\python.exe -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\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install dbt
.\.venv\Scripts\dbt.exe --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

.\.venv\Scripts\Activate.ps1
Get-Command dbt

Wenn Activate.ps1 gesperrt ist, arbeite mit den oben gezeigten vollständigen Pfaden weiter. Dafür ist keine globale Änderung der Execution Policy nötig. Get-Command dbt zeigt nach Aktivierung, ob tatsächlich der neue Befehl verwendet wird.

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:

$env:DBT_ACCOUNT = 'YOUR_ACCOUNT_IDENTIFIER'
$env:DBT_USER = 'YOUR_USER'

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

.\.venv\Scripts\dbt.exe debug --profiles-dir "C:\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 Windows

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.