> ## 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. > État de l'adaptateur ClickHouse dans dbt OSS, dbt v2 et la plateforme dbt # dbt OSS, v2 et Platform (bêta) export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return Beta ; } return Fonctionnalité en bêta ; }; export const ClickHouseSupportedBadge = () => { return

Compatible avec ClickHouse

; }; dbt est en cours de refonte sur un nouveau moteur, et ClickHouse en fait partie dès le départ. ClickHouse fonctionne désormais avec le nouveau moteur dbt écrit en Rust, aussi bien dans dbt OSS que dans dbt v2, et vous pouvez pour la première fois vous connecter à ClickHouse depuis la plateforme dbt. Votre projet ne change pas : les mêmes modèles, tests et profils qui s'exécutent aujourd'hui sur dbt Core 1.x s'exécutent sur le nouveau moteur ; seul le binaire diffère. ClickHouse est le premier adaptateur communautaire disponible sur dbt OSS, dbt v2 et la plateforme dbt. Les adaptateurs propriétaires de dbt sont lancés en même temps que le nôtre ; nous sommes les premiers en dehors de dbt Labs. L'adaptateur Python pour dbt Core 1.x, `dbt-clickhouse`, ne disparaît pas : nous le maintenons à jour au fil des releases dbt 1.x et assurons la maintenance des deux adaptateurs in parallel. **Pas prêt pour la production.** L'adaptateur ClickHouse pour dbt OSS et dbt v2, ainsi que la connexion à la plateforme dbt, ne sont pas encore generally available (GA). Ne les utilisez que dans des projets de development ou de staging. **La documentation dbt Core 1.x s'applique également à dbt OSS et dbt v2.** L'adaptateur se comporte de la même manière sur les deux moteurs : les profils, configurations de modèles, materialization et macros décrits dans les autres pages dbt fonctionnent sans modification sur dbt OSS, dbt v2 et la plateforme dbt. Les exceptions sont documentées dans le tableau [parity v1 vs v2](#parity) ci-dessous. **dbt OSS** est le build open-source (Apache 2.0) du moteur v2. Consultez [terminologie et availability](#terminology) pour comprendre son lien avec dbt v2 et la plateforme dbt. L'état en temps réel est suivi dans [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660) (parity de la v2 avec la v1, un sous-issue par domaine) et [ClickHouse/dbt-clickhouse#555](https://github.com/ClickHouse/dbt-clickhouse/issues/555) (dbt v2).

Essayer ClickHouse dans la plateforme dbt

Si vous souhaitez tester la bêta privée, inscrivez-vous via le [formulaire de bêta privée de dbt Labs](https://docs.google.com/forms/d/e/1FAIpQLScjHwRchnKarq_RpNM7hATjphNFxqBEePmAwRtSpMWG1snGHA/viewform). Ce formulaire appartient à dbt Labs : les informations que vous transmettez sont donc envoyées à dbt Labs, et non à ClickHouse. Une fois l'accès activé, suivez la page [Connect ClickHouse](https://docs.getdbt.com/docs/platform/connect-data-platform/connect-clickhouse) de la documentation dbt pour configurer la connexion.

Terminologie et disponibilité

dbt existe sous plusieurs formes, et un même adapter peut fonctionner dans plusieurs d'entre elles. Ce tableau présente chaque nom ainsi que le niveau actuel de prise en charge de ClickHouse. | Terme | De quoi il s'agit | Statut ClickHouse et comment l'obtenir | | - | - | - | | **dbt Core 1.x** | Le moteur dbt écrit en Python, open source (Apache 2.0). Notre adapter est `dbt-clickhouse`, maintenu au sein de l'[organisation GitHub ClickHouse](https://github.com/ClickHouse/dbt-clickhouse) et installé aux côtés de `dbt-core`. | **GA, maintenu.** Continue de recevoir des releases en parallèle de dbt v2. | | **dbt OSS** | Réécriture complète du moteur dbt en Rust, open source (Apache 2.0). Cette nouvelle version reprend toutes les fonctionnalités de la v1 et y ajoute plusieurs améliorations de performance. | **Bêta.** Consultez le [guide de mise à niveau vers dbt v2](https://docs.getdbt.com/docs/dbt-versions/core-upgrade/upgrading-to-v2) et la [page de configuration ClickHouse pour la v2](https://docs.getdbt.com/docs/local/connect-data-platform/clickhouse-setup?version=2) dans la documentation dbt. L'adapter ClickHouse est intégré au binary dbt ; aucun paquet distinct n'est à installer. | | **dbt v2** | dbt OSS auquel s'ajoutent des fonctionnalités supplémentaires de dbt Labs : compréhension du SQL, analyse statique, LSP, une extension VS Code et la column awareness. Code source fermé, sous licence [dbt Product Licensing Agreement](https://www.getdbt.com/dbt-fusion-engine-license-agreement). | **Bêta.** L'adapter fonctionne avec le binary v2, mais les nouvelles fonctionnalités SQL ne sont pas encore disponibles pour ClickHouse. | | **plateforme dbt** | dbt hébergé, anciennement dbt Cloud : IDE Studio, jobs planifiés, environnements, Catalog, Semantic Layer. La plateforme n'exécute que dbt v2 : utiliser ClickHouse sur la plateforme revient donc à utiliser l'adapter v2. | **Bêta privée.** Voir [comment demander l'access](#request-access). Configuration : [Connect ClickHouse](https://docs.getdbt.com/docs/platform/connect-data-platform/connect-clickhouse) dans la documentation dbt. |

Statut bêta

Nous évaluons l'adaptateur dbt v2 à l'aide de la test suite d'intégration dbt Core 1.x de `dbt-clickhouse`. Le statut bêta signifie que les workflows dbt essentiels et l'ensemble des fonctionnalités de ClickHouse Cloud fonctionnent dans les limites documentées ; la parité complète avec la v1 et la prise en charge des clusters self-managed viendront ensuite. **À ce jour,** l'adapter réussit plus de 81 % de la suite v1 complète et 92 % des tests applicables à ClickHouse Cloud. Toutes les materializations sont à parité (`view`, `table`, `incremental`, `materialized_view`, `dictionary`, `snapshot`, `seed`, `ephemeral`), avec l'ensemble complet des configs de table, des contrats de model, des tests de données et unit tests, la persistance de la documentation, `clickhouse_s3source()` et les settings de connection de dbt Core 1.x. Les échecs restants sont liés aux travaux sur les clusters self-managed listés ci-dessous, ainsi qu'à quelques différences côté engine. Consultez [parité v1 vs v2](#parity) pour un aperçu fonctionnalité par fonctionnalité. **Prochaines étapes** : le DDL `ON CLUSTER` et les Distributed materializations pour les clusters self-managed, les grants, `dbt clone`, `dbt source freshness` à partir des metadata de table, la correction des bogues restants et la réussite de l'intégralité de la test suite v1 afin de garantir une parité complète. L'avancement de ces travaux est suivi dans [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660), avec une sous-issue par domaine. La GA figure dans notre roadmap et arrivera prochainement. Nous mettrons la documentation à jour dès qu'elle sera disponible.

Hors périmètre pour la bêta

Outre les écarts de parité avec la v1 listés ci-dessous, quelques fonctionnalités propres à la v2 sortent du périmètre actuel, mais arriveront prochainement : * **Semantic Layer / MetricFlow.** La prise en charge de ClickHouse n'a pas encore été ajoutée. Suivi dans [dbt-labs/metricflow#2124](https://github.com/dbt-labs/metricflow/pull/2124). * **L'intelligence ClickHouse SQL dans dbt v2** (validation tenant compte du dialecte, analyse statique, LSP, prise en compte des colonnes dans l'extension VS Code). L'adapter fonctionne aujourd'hui avec le binary dbt v2, mais n'intègre pas encore ces fonctionnalités. D'ici là, l'analyse statique est forcée à `off` pour les projets ClickHouse et l'engine n'écrit aucune traçabilité au niveau des colonnes. Suivi dans [#736](https://github.com/ClickHouse/dbt-clickhouse/issues/736). * **Des méthodes d'authentification supplémentaires**, au-delà du username et du password, dans la plateforme dbt.

Parité v1 / v2