Skip to content

Document reuse_connections profile option for dbt-clickhouse#6378

Open
dlouseiro wants to merge 1 commit into
ClickHouse:mainfrom
dlouseiro:dlouseiro/dbt-reuse-connections
Open

Document reuse_connections profile option for dbt-clickhouse#6378
dlouseiro wants to merge 1 commit into
ClickHouse:mainfrom
dlouseiro:dlouseiro/dbt-reuse-connections

Conversation

@dlouseiro

@dlouseiro dlouseiro commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new reuse_connections option in the dbt-clickhouse adapter's profiles.yml configuration table. Follow-up to ClickHouse/dbt-clickhouse#669 / ClickHouse/dbt-clickhouse#670.

When set to false, dbt closes the underlying connection at the end of each model so the next model opens a fresh TCP connection — useful on multi-replica ClickHouse Cloud services where the load balancer routes by connection and a long-lived pool would otherwise pin a dbt run to a single replica. Default is true, preserving current behaviour.

Single-line addition next to the related tcp_keepalive setting in docs/integrations/data-ingestion/etl-tools/dbt/features-and-configurations.md.

Checklist

  • Delete items not relevant to your PR

Note

Low Risk
Documentation-only change with no runtime or configuration behavior changes in this repo.

Overview
Adds reuse_connections to the dbt ClickHouse profiles.yml reference in features-and-configurations.md, placed after tcp_keepalive.

The entry documents default True (reuse one connection across models) and False (close after each model for a new TCP connection), with guidance for multi-replica ClickHouse Cloud when the load balancer pins traffic by connection.

Reviewed by Cursor Bugbot for commit d298f24. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds the `reuse_connections` option (default `True`) to the dbt
profile.yml configuration table. When set to `False`, dbt closes the
underlying connection at the end of each model so the next model
opens a fresh TCP connection — useful on multi-replica ClickHouse
Cloud services where the load balancer routes by TCP connection and a
long-lived pool would otherwise pin a `dbt run` to a single replica.

Tracks ClickHouse/dbt-clickhouse#669 / ClickHouse/dbt-clickhouse#670.
@dlouseiro dlouseiro requested review from a team as code owners June 12, 2026 13:34
@vercel

vercel Bot commented Jun 12, 2026

Copy link
Copy Markdown

@dlouseiro is attempting to deploy a commit to the ClickHouse Team on Vercel.

A member of the Team first needs to authorize it.

@koletzilla koletzilla self-requested a review June 15, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant