Unterstützte dbt Core-Versionen für dbt Projects on Snowflake¶

Snowflake bietet verwaltete Laufzeiten für dbt-Projekte, um eine sichere und vorhersehbare Ausführungsumgebung zu gewährleisten. Da Releases von dbt Core zu grundlegenden Änderungen oder Sicherheitslücken führen können, folgt Snowflake einem strukturierten Lebenszyklus für jede Version. Diese Richtlinie ermöglicht es Benutzenden, bestimmte Versionen für Governance und Reproduzierbarkeit festzulegen und gleichzeitig einen klaren Zeitplan für die erforderlichen Migrationen zu erstellen.

Unterstützte Versionen für dbt-Projekte¶
Unterstützte dbt Core-Version	Snowflake-Support-Level	dbt Labs-Unterstützung
1.10.15	Aktive Unterstützung	Wichtige Unterstützung bis 15. Juni 2026
1.9.4	Aktive Unterstützung	Veraltet

Der Parameter DBT_VERSION definiert implizit das Ausführungsmodul basierend auf der Version, wie in der folgenden Tabelle aufgeführt.

Versionsbasierte Engine-Zuordnung¶
Benutzereingabe (DBT_VERSION)	Bedingung	Resultierende Engine
‚1.x‘ (beispielsweise `1.9.4`)	Version `< 2.0`	dbt Core (Python-basiert)

Anzeigen von unterstützten dbt Core-Versionen¶

Um unterstützte dbt Core-Versionen anzuzeigen, führen Sie die Systemfunktion SYSTEM$SUPPORTED_DBT_VERSIONS aus, wie im folgenden Beispiel gezeigt:

SELECT SYSTEM$SUPPORTED_DBT_VERSIONS();

[{"dbt_version":"1.9.4","type":"dbt Core"},{"dbt_version":"1.10.15","type":"dbt Core"}]

Standardversion auf Kontoebene festlegen¶

Kontoadministratoren können mithilfe des Kontoparameters DEFAULT_DBT_VERSION eine Standard-dbt-Version für alle zukünftigen dbt-Projektobjekte festlegen, die im Konto erstellt werden. So können Sie sich für neuere Versionen entscheiden, ohne dass Benutzer DBT_VERSION in jeder CREATE DBT PROJECT-Anweisung angeben müssen.

ALTER ACCOUNT SET DEFAULT_DBT_VERSION = '1.10.15';

Diese Standardversion wird auch von Arbeitsbereichen verwendet, um die erste Laufzeitversion des dbt-Arbeitsbereichs festzulegen.

Einzelne dbt-Projektobjekte können immer noch die Standardeinstellung des Kontos überschreiben, indem sie zum Zeitpunkt der Erstellung DBT_VERSION mithilfe von ALTER DBT PROJECT oder bei jeder Ausführung mit EXECUTE DBT PROJECT angeben.

Ändern der Ausführungsversion von dbt Core¶

Um die dbt Core-Version zu ändern, die das dbt-Projektobjekt ausführt, führen Sie den Befehl ALTER DBT PROJECT aus, wie im folgenden Beispiel gezeigt:

ALTER DBT PROJECT my_dbt_project SET DBT_VERSION = '1.10.15';

Erstellen eines dbt-Projektobjekts, das an eine Version gebunden ist¶

Das folgende Beispiel erstellt ein dbt-Projektobjekt, das an die dbt-Version 1.10.15 gebunden ist:

CREATE OR REPLACE DBT PROJECT my_dbt_project
  FROM '@my_stage/dbt_files'
  DBT_VERSION = '1.10.15';

Bemerkung

Sie können auch die dbt-Version für eine einzelne Ausführung überschreiben, indem Sie DBT_VERSION in der Anweisung EXECUTE DBT PROJECT angeben.

Weitere Informationen und Beispiele dazu finden Sie unter CREATE DBT PROJECT und ALTER DBT PROJECT.

Funktionsweise von Abkündigung und Stilllegung¶

Von Snowflake unterstützte Versionen: Diese Versionen sind für alle neuen und bestehenden Projekte verfügbar. Snowflake bietet vollen technischen Support, einschließlich Sicherheitspatches.
Veraltete Snowflake-Versionen: Diese Versionen haben das Ende ihres aktiven Entwicklungszyklus erreicht. Während sie für bestehende Projekte voll funktionsfähig bleiben, wird den Benutzenden davon abgeraten, neue Projekte mit einer veralteten Version zu starten.
Stillgelegte Snowflake-Versionen: Diese Versionen werden offiziell aus der Snowflake-Umgebung entfernt. In dieser Phase kann jedes Projekt, das an eine stillgelegte Version gebunden ist, erst ausgeführt werden, wenn es auf eine aktuell unterstützte Version aktualisiert wurde.
Support-Level für dbt Core: Selbst wenn eine Version den Status Wichtige Unterstützung, Veraltet oder Ende des Lebenszyklus gemäß dbt Labs erreicht hat, wird sie weiterhin von Snowflake unterstützt. Das bedeutet, dass Sie nicht zu sofortigen Upgrades gezwungen sind und Ihre bestehende Umgebung so lange beibehalten können, wie Sie möchten.