> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > dbt OSS、dbt v2、dbt platform における ClickHouse アダプターのステータス # dbt OSS、v2、Platform（ベータ） export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return ベータ ; } return ベータ機能 ; }; export const ClickHouseSupportedBadge = () => { return

ClickHouse対応

; }; dbt は新しいエンジン上で再構築されており、ClickHouse は当初からその一部です。ClickHouse は dbt OSS と dbt v2 の両方で、新しい Rust ベースの dbt エンジンに対応しました。さらに、dbt プラットフォームから ClickHouse に接続できるようにもなりました。プロジェクト側の変更は不要です。現在 dbt Core 1.x で動作しているモデル、テスト、profiles はそのまま新しいエンジンでも動作し、異なるのはバイナリだけです。 ClickHouse は、dbt OSS、dbt v2、および dbt プラットフォームにおける最初のコミュニティアダプターです。dbt 自身のファーストパーティアダプターも同時に提供が始まりますが、dbt Labs 以外からの提供としては当社が最初です。dbt Core 1.x 向けの Python アダプター `dbt-clickhouse` が廃止されることはありません。dbt 1.x のリリースに追随して最新の状態を保ち、両方のアダプターを並列に保守していきます。 **production での利用には適していません。** dbt OSS および dbt v2 向けの ClickHouse アダプター、ならびに dbt プラットフォーム接続は、まだ generally available (GA) ではありません。development または staging のプロジェクトでのみ使用してください。 **dbt Core 1.x のドキュメントは dbt OSS および dbt v2 にも当てはまります。** アダプターの挙動は両方のエンジンで同じです。他の dbt ページで説明されている profiles、model configs、materializations、macros は、dbt OSS、dbt v2、dbt プラットフォームでもそのまま動作します。例外については、以下の [v1 と v2 の互換性](#parity) の表に記載しています。 **dbt OSS** は、v2 エンジンの open-source (Apache 2.0) build です。dbt v2 および dbt プラットフォームとの関係については、[用語と availability](#terminology) を参照してください。最新の状況は [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660) (v1 に対する v2 の互換性。領域ごとに 1 つのサブ issue) および [ClickHouse/dbt-clickhouse#555](https://github.com/ClickHouse/dbt-clickhouse/issues/555) (dbt v2) で追跡しています。

dbt プラットフォームで ClickHouse を試す

プライベートベータを試してみたい場合は、[dbt Labs のプライベートベータ申込フォーム](https://docs.google.com/forms/d/e/1FAIpQLScjHwRchnKarq_RpNM7hATjphNFxqBEePmAwRtSpMWG1snGHA/viewform)から登録してください。このフォームは dbt Labs が管理しているため、送信された情報は ClickHouse ではなく dbt Labs に送られます。利用が有効化されたら、dbt ドキュメントの [Connect ClickHouse](https://docs.getdbt.com/docs/platform/connect-data-platform/connect-clickhouse) に従って接続を設定してください。

用語と提供状況

dbt にはいくつかの形態があり、同じアダプターが複数の形態で動作する場合もあります。次の表では、それぞれの名称と現時点での ClickHouse のサポート状況を説明します。 | 用語 | 概要 | ClickHouse のステータスと入手方法 | | - | - | - | | **dbt Core 1.x** | Python ベースの dbt エンジンで、open source(Apache 2.0)。ClickHouse が提供するアダプターは `dbt-clickhouse` で、[ClickHouse GitHub 組織](https://github.com/ClickHouse/dbt-clickhouse)でメンテナンスされており、`dbt-core` と併せてインストールします。 | **GA、メンテナンス中。** dbt v2 と並列にリリースが継続されています。 | | **dbt OSS** | dbt エンジンを Rust で全面的に書き換えたもので、open source(Apache 2.0)。この新バージョンには、v1 のすべての機能に加えていくつかのパフォーマンス改善が含まれます。 | **ベータ。** dbt ドキュメントの [dbt v2 upgrade guide](https://docs.getdbt.com/docs/dbt-versions/core-upgrade/upgrading-to-v2) および [ClickHouse setup page for v2](https://docs.getdbt.com/docs/local/connect-data-platform/clickhouse-setup?version=2) を参照してください。ClickHouse アダプターは dbt のバイナリに同梱されているため、個別にインストールする package はありません。 | | **dbt v2** | dbt OSS に、dbt Labs による追加機能(SQL の解釈、静的解析、LSP、VS Code 拡張機能、カラム認識)を加えたもの。クローズドソースであり、[dbt Product Licensing Agreement](https://www.getdbt.com/dbt-fusion-engine-license-agreement) に基づいてライセンスされます。 | **ベータ。** アダプターは v2 のバイナリ上で動作しますが、新しい SQL 機能は ClickHouse ではまだ利用できません。 | | **dbt platform** | ホスト型の dbt(旧 dbt Cloud)。Studio IDE、スケジュール実行される job、環境、Catalog、Semantic Layer を提供します。このプラットフォームで動作するのは dbt v2 のみであるため、プラットフォーム上の ClickHouse は v2 アダプターを指します。 | **プライベートベータ。** [アクセスをリクエストする方法](#request-access)を参照してください。セットアップについては、dbt ドキュメントの [Connect ClickHouse](https://docs.getdbt.com/docs/platform/connect-data-platform/connect-clickhouse) を参照してください。 |

ベータ状態

dbt v2 アダプターは、`dbt-clickhouse` の dbt Core 1.x インテグレーションテストスイートを基準に評価しています。ベータとは、主要な dbt ワークフローと ClickHouse Cloud の機能セットが、文書化された制約の範囲内で動作することを意味します。v1 との完全な互換性とセルフマネージドクラスターのサポートは、その後の対応となります。 \*\*現時点で、\*\*アダプターは v1 スイート全体の 81% 以上、ClickHouse Cloud に該当するテストの 92% に合格しています。すべての materialization (`view`、`table`、`incremental`、`materialized_view`、`dictionary`、`snapshot`、`seed`、`ephemeral`) が同等の水準に達しており、テーブル設定の全セット、model contracts、データテストおよび単体テスト、ドキュメントの永続化、`clickhouse_s3source()`、dbt Core 1.x の接続設定にも対応しています。残る不合格項目は、以下に挙げるセルフマネージドクラスター関連の作業と、わずかな engine 側の差異に起因するものです。機能ごとの状況については [v1 と v2 の互換性](#parity) を参照してください。 **次のステップ**: セルフマネージドクラスター向けの `ON CLUSTER` DDL と Distributed materializations、grants、`dbt clone`、テーブルの metadata に基づく `dbt source freshness`、残存するバグの修正、そして完全な互換性を確保するための v1 テストスイート全体の合格です。これらの進捗はすべて [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660) で追跡しており、領域ごとにサブ issue を設けています。 GA はロードマップに含まれており、近日中に対応予定です。準備が整い次第、ドキュメントを更新します。

ベータの対象外

以下に挙げる v1 とのパリティギャップに加えて、v2 固有の機能のうちいくつかは現時点ではスコープ外ですが、近日対応予定です。 * **Semantic Layer / MetricFlow**: ClickHouse のサポートはまだ追加されていません。[dbt-labs/metricflow#2124](https://github.com/dbt-labs/metricflow/pull/2124) で追跡されています。 * **dbt v2 における ClickHouse SQL インテリジェンス** (ダイアレクトを認識したバリデーション、静的解析、LSP、VS Code 拡張機能でのカラム認識) 。現時点でアダプターは dbt v2 のバイナリ上で動作しますが、これらの機能はまだ含まれていません。それまでの間、ClickHouse プロジェクトでは静的解析は強制的に `off` となり、エンジンはカラムレベルのリネージを書き出しません。[#736](https://github.com/ClickHouse/dbt-clickhouse/issues/736) で追跡されています。 * dbt プラットフォームにおける、ユーザー名とパスワード以外の**追加の認証方式**。

v1 と v2 の互換性