dbt logo

Adapters

There are two major adapter types: base and sql.

`base`

BaseAdapter defines the base functionality an adapter is required to implement in order to function with dbt-core. There are several methods which have default implementations as well as methods that require the concrete adapter to implement them.

`sql`

SQLAdapter inherits from BaseAdapter, updates default implementations to work with SQL-based platforms, and defines additional required methods to support those defaults.

Components

An adapter is composed of several components.

connections
dialect
relation caching
integration with dbt-core

The first two are platform-specific and require significant implementation in a concrete adapter. The last two are largely implemented in dbt-adapters with minor adjustments in a concrete adapter.

Connections

This component is responsible for creating and managing connections to storage and compute.

Files

dbt/adapters/{base|sql}/connections.py

Dialect

This component is responsible for translating a request from dbt-core into a specific set of actions on the platform.

Files

dbt/adapters/base/column.py
dbt/adapters/base/query_headers.py
dbt/adapters/base/relation.py
dbt/adapters/relation_configs/*
dbt/adapters/clients/jinja.py
dbt/include/global_project/*

Relation caching

This component is responsible for managing a local cache of relations, relation metadata, and dependencies between relations.

Files

dbt/adapters/cache.py

Integration with `dbt-core`

This component is responsible for managing the interface between dbt-core and a concrete adapter.

Files

dbt/adapters/{base|sql}/impl.py
dbt/adapters/base/meta.py
dbt/adapters/base/plugin.py
dbt/adapters/capability.py
dbt/adapters/factory.py
dbt/adapters/protocol.py
dbt/adapters/contracts/*
dbt/adapters/events/*
dbt/adapters/exceptions/*

Metadata

Release files for dbt-adapters 1.24.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dbt-adapters 1.24.5
File	Size	Uploaded
dbt_adapters-1.24.5.tar.gz	146.5 kB	Jul 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dbt-adapters 1.24.5
File	Interpreter	ABI	Platform	Reset
dbt_adapters-1.24.5-py3-none-any.whl 177.3 kB Jul 15, 2026	Python 3	none	any	Details

Total release size: 323.8 kB

Release files / dbt_adapters-1.24.5.tar.gz

Download URL	dbt_adapters-1.24.5.tar.gz
Size	146.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`87de096a0d5b219905f1079b002f13e3447ffb63558f4f3c5b7278670d198acb`
BLAKE2b-256 checksum How to use checksums	`b3d4bea32dd730def5b875a76c05d281d397ed720b9184d936cc4cedac605948`
Upload date	Jul 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dbt-labs/dbt-adapters
Publishing commit: github.com/dbt-labs/dbt-adapters/tree/ca8289fb9b287cdac3a52b2ad3542adfadefa108

Workflow

Publishing configuration: github.com/dbt-labs/dbt-adapters/blob/ca8289fb9b287cdac3a52b2ad3542adfadefa108/.github/workflows/publish-oss.yml
Publishing logs: github.com/dbt-labs/dbt-adapters/actions/runs/29396623450/attempts/1

Artifact

Subject: dbt_adapters-1.24.5.tar.gz
SHA-256 checksum: 87de096a0d5b219905f1079b002f13e3447ffb63558f4f3c5b7278670d198acb Verifying attestations

Release files / dbt_adapters-1.24.5-py3-none-any.whl

Download URL	dbt_adapters-1.24.5-py3-none-any.whl
Size	177.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`32345118b921160722a13f12c3e369b9d59a0fb8fb9b3297e29d8cd53f973411`
BLAKE2b-256 checksum How to use checksums	`9cc007f0e315458128c6ef246ba9698dc0f5e9333394ab8844508adac468c617`
Upload date	Jul 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dbt-labs/dbt-adapters
Publishing commit: github.com/dbt-labs/dbt-adapters/tree/ca8289fb9b287cdac3a52b2ad3542adfadefa108

Workflow

Publishing configuration: github.com/dbt-labs/dbt-adapters/blob/ca8289fb9b287cdac3a52b2ad3542adfadefa108/.github/workflows/publish-oss.yml
Publishing logs: github.com/dbt-labs/dbt-adapters/actions/runs/29396623450/attempts/1

Artifact

Subject: dbt_adapters-1.24.5-py3-none-any.whl
SHA-256 checksum: 32345118b921160722a13f12c3e369b9d59a0fb8fb9b3297e29d8cd53f973411 Verifying attestations