Skip to main content
CockroachDB’s support of the PostgreSQL wire protocol makes most PostgreSQL drivers, ORM frameworks, and other types of third-party database tools designed for PostgreSQL compatible with CockroachDB. Cockroach Labs guarantees official support for a set of popular PostgreSQL tools, which we list on this page.

Support levels

Cockroach Labs has partnered with open-source projects, vendors, and individuals to offer the following levels of support with third-party tools:
  • Full support indicates that Cockroach Labs is committed to maintaining compatibility with the vast majority of the tool’s features. CockroachDB is regularly tested against the latest version documented in the table below.
  • Partial support indicates that Cockroach Labs is working towards full support for the tool. The primary features of the tool are compatible with CockroachDB (e.g., connecting and basic database operations), but full integration may require additional steps, lack support for all features, or exhibit unexpected behavior.
  • Partner supported indicates that Cockroach Labs has a partnership with a third-party vendor that provides support for the CockroachDB integration with their tool.
Tools, drivers, or frameworks are considered unsupported if:
  • The tool, driver, or framework is not listed on this page.
  • The version of a supported tool, driver, or framework is not listed on this page.
If you encounter issues when using unsupported tools, drivers, or frameworks, contact the maintainer directly.Cockroach Labs provides “best effort” support for tools, drivers, and frameworks that are not officially supported. This means that while we will do our best to assist you, we may not be able to fully troubleshoot errors in your deployment.Customers should contact their account team before moving production workloads to CockroachDB that use unsupported drivers.
Unless explicitly stated, support for a driver or data access framework does not include .
If you encounter problems using CockroachDB with any of the tools listed on this page, please contact Support with details to help us make progress toward better support. For a list of tools supported by the CockroachDB community, see .

Drivers

LanguageDriverLatest tested versionSupport levelCockroachDB adapterTutorial
ClibpqPostgreSQL 13PartialN/AN/A
C# (.NET)Npgsql7.0.2FullN/A
Gopgx pqv5.3.1 (use latest version of CockroachDB adapter)v1.10.5Full Fullcrdbpgx (includes client-side transaction retry handling)N/A
JavaJDBCREL42.7.3FullN/A
JavaScriptpg8.2.1FullN/A
Pythonpsycopg3 psycopg2 asyncpg3.0.16 2.8.6 v0.24.0Full Full PartialN/A N/A N/A
Rubypgv1.4.6FullN/A
Rustrust-postgres0.19.2PartialN/A

Data access frameworks (e.g., ORMs)

LanguageFrameworkLatest tested versionSupport levelCockroachDB adapterTutorial
GoGORM go-pgupper/dbv1.24.1 v10.9.0v4Full FullFullcrdbgorm (includes client-side transaction retry handling)N/AN/A N/A
JavaHibernate (including Hibernate Spatial)jOOQMyBatis6.6.20 (must be at least 5.4.19) 3.13.2 (must be at least 3.13.0)3.5.5Full FullFullN/A N/AN/A
JavaScript/TypeScriptSequelize Knex.jsPrismaTypeORMv6.0.5 (use latest version of CockroachDB adapter) 2.5.1 3.14.0 0.3.17Full FullFullFullsequelize-cockroachdb N/AN/AN/A
RubyActiveRecord RGeo/RGeo-ActiveRecord8.1.0 (use latest version of CockroachDB adapter)Fullactiverecord-cockroachdb-adapter (includes client-side transaction retry handling)
PythonDjango (including GeoDjango)peeweeSQLAlchemy4.1.x (use latest version of CockroachDB adapter) 3.13.30.7.131.4.17 (use latest version of CockroachDB adapter)Full FullFullFulldjango-cockroachdb N/AN/Asqlalchemy-cockroachdb (includes client-side transaction retry handling) N/A (See peewee docs.)

Graphical user interfaces (GUIs)

GUILatest tested versionSupport levelTutorial
DBeaver5.2.3Full

Integrated development environments (IDEs)

IDELatest tested versionSupport levelTutorial
DataGrip2024.1FullN/A
IntelliJ IDEA2024.1Full

Enhanced data security tools

ToolSupport levelIntegration
HashiCorp VaultPartner supported

Schema migration tools

ToolLatest tested versionSupport levelTutorial
Alembic1.7Full
Flyway7.1.0Full
Liquibase4.2.0Full
Prisma3.14.0Full

Data migration tools

ToolLatest tested versionSupport levelDocumentation
AWS DMS3.4.6Full
Qlik ReplicateNovember 2022Full
Striim4.1.2Full
Oracle GoldenGate21.3Partial
Debezium2.4Full

Provisioning tools

ToolLatest tested versionSupport levelDocumentation
Terraform1.3.2PartialTerraform provider for CockroachDB Cloud

Other tools

See also