Zenn
🙆‍♀️

【dbt Docs】Introduction - About dbtCore versions

2022/03/08に公開
dbt
tech

概要

https://docs.getdbt.com/docs/core-versions

dbtCoreバージョンについて

dbt Coreリリースは、セマンティックバージョニングに従います。このページのポリシーと期待は、セマンティックバージョンに精通していることを前提としています。セマンティックバージョンの使用方法の詳細については、「dbtCoreがセマンティックバージョンを使用する方法」を参照してください。

※セマンティックバージョニングとは　
https://semver.org/lang/ja/

「1.23.45」といったように"."で区切った3つの数字で表される。
前から順にメジャーバージョン、マイナーバージョン、パッチバージョンと呼ぶ。
APIの変更に互換性のない場合はメジャーバージョンを、後方互換性があり機能性を追加した場合はマイナーバージョンを、後方互換性を伴うバグ修正をした場合はパッチバージョンを上げる

Further reading

さらに・・・・

（注釈）一部だけ、以前のバージョンで動かしたい・・・ってのもありなんだ

Version support prior to v1.0

  • v1.0より前のマイナーバージョンの新しいパッチはリリースされなくなりました
  • 2022年6月30日以降、dbtCloudはv1.0より古いバージョンのdbtCoreのサポートを削除します。

Version support stgaring with v1.0

Minor version support

マイナーバージョンは、最初のリリース日から1年間（12か月）サポートされます。

Ongoing patches

継続的なサポートの12か月間、修正を含む新しいパッチバージョンをリリースし続けます。

アクティブサポート： マイナーバージョンの最初のリリース後の最初の数か月で、「バグ修正」リリースでパッチを適用します。これらには、マイナーバージョンの元のリリースに存在していたリグレッションとまったく新しいバグの修正が含まれます。

重要なサポート： 新しいマイナーバージョンが利用可能になると、以前のマイナーバージョンを「重要なサポート」に移行します。その古いマイナーバージョンへの後続のパッチは「セキュリティ」リリースのみであり、セキュリティとインストールに関連する重要な修正に限定されます。

マイナーバージョンが重要なサポート期間の終わりに達した後、最初のリリースから1年後、新しいパッチはリリースされません。

Future versions

3ヶ月ごとに新しいマイナーな「機能」をリリースすることを目指しています。

dbtコア 初回リリース 最新のパッチ 積極的なサポート 重要なサポート
1.0.x 2021-12-03 1.0.1 1.1.0リリース 2022-12-03
1.1.x 2022-04 1.2.0リリース 2023-04
1.2.x 2022-07 1.3.0リリース 2023-07
1.3.x 2022-10 1.4.0リリース 2023-10
※1.1.x 以降は将来の予定。あくまで目安

Best practices for uprading

新しいバージョンのプラクティスのために、dbt Coreの新しいバージョンをリリースし続ける際に、dbtユーザーがアップグレードするためのベストプラクティスと期待について概説しました。

Upgraring to new patch versions

パッチが利用可能になり次第、ユーザーがパッチにアップグレードすることを期待しています。dbt Coreの「マイナーバージョン」（v1.0またはv1.0.xと記述されている場合があります）を参照する場合、常にそのマイナーバージョンの最新のパッチリリースを参照しています。の最新のパッチと任意のアダプタプラグインをいつでもインストールできるように、開発環境と本番環境を構築することを強くお勧めしますdbt-core （これらのパッチ番号は異なる場合があることに注意してください）。

Upgrading to new minor versions

公式にサポートされている間は、dbtのマイナーバージョンを引き続き使用できます。ユーザーが新しいマイナーバージョンが利用可能になり次第すぐにアップグレードすることは期待していませんが、最新のマイナーバージョンのユーザーのみが利用できる機能と修正が常にあります。

Trying prereleases

すべてのdbtCoreバージョンは、最終リリースの前にプレリリースとして利用できます。「'RC(リリース候補)'」は、最終リリースの2週間前に、本番環境のような環境でテストできます。マイナーバージョンについては、最終リリースの4週間以上前に、新機能を含み、コミュニティのフィードバックを招待する1つ以上の「'Beta'」をリリースすることも目指しています。プレリリースのテストを支援することはあなたの利益になります—私たちはあなたの助けを必要としています！

（注釈）
プレリリースもするから、みんな協力して動作確認してね！

Hou dbt Core uses semantic versioning

dbtCore がどういうポリシーでセマンティックバージョニングを使っているか

メジャーバージョン： ｖ２.0.0がリリースされると、新機能がリリース、非推奨機能は削除、下位互換がなくなる
マイナーバージョン いわゆる機能リリース
パッチバージョン : バグ修正やセキュリティ対応

How we version adapter plugins

dbtを使用する場合はdbt-core、データベースに固有のアダプタープラグインと一緒に使用します。
dbt-coreとdbtアダプタプラグインはどちらもセマンティックバージョニングに従います。

アダプターのバージョニングとdbtCoreのバージョニングは独立してリリース。

dbt-core==1.0.3例として、を使用している場合がありますdbt-snowflake==1.0.0。最も重要なことは、それぞれに利用可能な最新のパッチ（v1.0.x）を使用していることです。dbtをローカルで実行している場合は、次のdbt --versionコマンドを使用して、インストールしたバージョンを確認できます。

version
$ dbt --version
installed version: 1.0.3
   latest version: 1.0.3

Up to date!

Plugins:
  - snowflake: 1.0.0 - Up to date!

この例では、

  • dbtCoreは、1.0.3
  • db-snowflakeは、1.0.0
    でそれぞれ最新版！

Discussion