ScratchBird Database Drivers

Official drivers, tooling, and application adapters for the ScratchBird Database Engine.

Current State

This repository is in the Beta 1 driver program. The current audited state is:

• 10 application-driver lanes are baseline_complete against the repo's JDBC/.NET-class baseline: cpp, dotnet, go, jdbc, node, pascal, php, python, ruby, rust
• 5 application-driver lanes are still partial: dart, elixir, odbc, r, swift
• 1 driver lane is functionally strong but still has a native-architecture gap: mojo
• 1 tooling lane remains partial: cli
• 7 BI/application adapters are still partial or contract-first: dbeaver, hibernate, metabase, prisma, sqlalchemy, superset, typeorm
• 10 additional lanes are now active Beta 1 authority targets with specification, public docs, benchmark research packets, lane-local gap reports, and deterministic later verification packets in place, but are not implemented yet: r2dbc, dbt, airbyte, powerbi, tableau, looker, adbc, flightsql, julia, perl

Authoritative status sources:

• Driver implementation audit
• Lane authority index
• Beta 1 expansion remaining work
• Server-blocked remaining work

Where To Start

• Getting started
• API reference
• Application adapter reference
• Specifications
• Reference packets
• Audit reports
• Development and verification docs

Driver Lanes

Lane	Current State	Benchmark	Public Docs
cpp	baseline_complete	libpqxx	guide / api
dart	partial	postgres (Dart)	guide / api
dotnet	baseline_complete	Npgsql	guide / api
elixir	partial	Postgrex	guide / api
go	baseline_complete	pgx	guide / api
jdbc	baseline_complete	pgjdbc	guide / api
mojo	hybrid_native_gap	Composite (asyncpg + pgx + PostgresNIO)	guide / api
node	baseline_complete	node-postgres	guide / api
odbc	partial	Microsoft ODBC Driver for SQL Server	guide / api
pascal	baseline_complete	FireDAC	guide / api
php	baseline_complete	PDO_PGSQL	guide / api
python	baseline_complete	psycopg3	guide / api
r	partial	RPostgres	guide / api
ruby	baseline_complete	ruby-pg	guide / api
rust	baseline_complete	tokio-postgres	guide / api
swift	partial	PostgresNIO	guide / api

Planned Beta 1 Expansion Lanes

Lane	Current State	Benchmark	Public Docs
adbc	planned_beta1	Apache Arrow ADBC PostgreSQL driver	guide / api
flightsql	planned_beta1	Apache Arrow Flight SQL client stack	guide / api
julia	planned_beta1	LibPQ.jl	guide / api
perl	planned_beta1	DBD::Pg	guide / api
r2dbc	planned_beta1	PostgreSQL R2DBC driver	guide / api

Tooling And Adapters

Lane	Current State	Benchmark	Public Docs
cli	tooling_partial	psql	guide / api
dbeaver	partial_plugin	DBeaver PostgreSQL extension	guide / api
hibernate	partial_contract_only	Hibernate PostgreSQLDialect	guide / api
metabase	partial_adapter	Metabase PostgreSQL driver	guide / api
prisma	partial_contract_only	Prisma PostgreSQL connector	guide / api
sqlalchemy	partial_adapter	SQLAlchemy PostgreSQL dialect	guide / api
superset	partial_adapter	Superset PostgreSQL engine spec	guide / api
typeorm	partial_contract_only	TypeORM PostgreSQL driver	guide / api
airbyte	planned_beta1	Airbyte PostgreSQL source/destination	guide / api
dbt	planned_beta1	dbt-postgres	guide / api
looker	planned_beta1	Looker PostgreSQL dialect	guide / api
powerbi	planned_beta1	Power BI PostgreSQL / ODBC custom connector surface	guide / api
tableau	planned_beta1	Tableau PostgreSQL / Named Connector SDK	guide / api

Release Evidence And Verification

Every lane is expected to ship with a deterministic evidence pack and a later live verification packet.

• Shared evidence contract: DRIVER_RELEASE_READINESS_EVIDENCE_CONTRACT.md
• Evidence templates: docs/development/release-evidence/README.md
• Later live verification packets: docs/development/server-verification/README.md
• New-lane benchmark research: docs/reference/beta1_expansion_server_independent_2026-04-03/README.md
• New-lane remaining-work split: docs/audit/DRIVER_BETA1_EXPANSION_SERVER_INDEPENDENT_REMAINING_WORK.md

Repository Layout

ScratchBird-driver/
├── docs/
│   ├── api-reference/
│   ├── application-reference/
│   ├── audit/
│   ├── development/
│   ├── getting-started/
│   ├── planning/
│   ├── reference/
│   └── specifications/
├── scripts/
├── tracks/
│   ├── alpha/
│   ├── beta/
│   └── p3/
└── wiki/

Notes

• ScratchBird drivers follow the engine MGA/state-recovery model.
• Driver reconnect logic restores transport/session state; it does not replay or resurrect lost in-flight transactions.
• For current user-facing behavior, prefer the getting-started and API reference pages over older planning artifacts.

Last updated: 2026-04-03