> ## Documentation Index
> Fetch the complete documentation index at: https://cockroachlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Third-Party Tools Supported by Cockroach Labs

export const InternalLink = ({version, path = "", children, ...props}) => {
  let detectedVersion = version || "stable";
  if (typeof window !== 'undefined' && !version) {
    const match = window.location.pathname.match(/\/docs\/([^/]+)/);
    if (match) {
      detectedVersion = match[1];
    }
  }
  const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
  return <a href={`/docs/${detectedVersion}/${normalizedPath}`} {...props}>
      {children}
    </a>;
};

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](#support-levels) 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.

<Danger>
  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.
</Danger>

<Note>
  Unless explicitly stated, support for a [driver](#drivers) or [data access framework](#data-access-frameworks-e-g-orms) does not include <InternalLink path="transaction-retry-error-reference#client-side-retry-handling">automatic, client-side transaction retry handling</InternalLink>. For client-side transaction retry handling samples, see <InternalLink path="example-apps">Example Apps</InternalLink>.
</Note>

If you encounter problems using CockroachDB with any of the tools listed on this page, please [contact Support](https://support.cockroachlabs.com) with details to help us make progress toward better support.

For a list of tools supported by the CockroachDB community, see <InternalLink path="community-tooling">Third-Party Tools Supported by the Community</InternalLink>.

## Drivers

| Language   | Driver                                                                                                                                                       | Latest tested version                                     | Support level       | CockroachDB adapter                                                                                                                   | Tutorial                                                                                                                                                                                                                                                                                                                                                                               |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| C          | [libpq](http://www.postgresql.org/docs/13/static/libpq)                                                                                                      | PostgreSQL 13                                             | Partial             | N/A                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                                                                                                    |
| C# (.NET)  | [Npgsql](https://www.nuget.org/packages/Npgsql)                                                                                                              | 7.0.2                                                     | Full                | N/A                                                                                                                                   | <InternalLink path="build-a-csharp-app-with-cockroachdb">Build a C# App with CockroachDB (Npgsql)</InternalLink>                                                                                                                                                                                                                                                                       |
| Go         | [pgx](https://github.com/jackc/pgx/releases)  [pq](https://github.com/lib/pq)                                                                                | v5.3.1 (use latest version of CockroachDB adapter)v1.10.5 | Full  Full          | [`crdbpgx`](https://pkg.go.dev/github.com/cockroachdb/cockroach-go/crdb/crdbpgx) (includes client-side transaction retry handling)N/A | <InternalLink path="build-a-go-app-with-cockroachdb">Build a Go App with CockroachDB (pgx)</InternalLink>  <InternalLink path="build-a-go-app-with-cockroachdb-pq">Build a Go App with CockroachDB (pq)</InternalLink>                                                                                                                                                                 |
| Java       | [JDBC](https://jdbc.postgresql.org/download)                                                                                                                 | REL42.7.3                                                 | Full                | N/A                                                                                                                                   | <InternalLink path="build-a-java-app-with-cockroachdb">Build a Java App with CockroachDB (JDBC)</InternalLink>                                                                                                                                                                                                                                                                         |
| JavaScript | [pg](https://www.npmjs.com/package/pg)                                                                                                                       | 8.2.1                                                     | Full                | N/A                                                                                                                                   | <InternalLink path="build-a-nodejs-app-with-cockroachdb">Build a Node.js App with CockroachDB (pg)</InternalLink>                                                                                                                                                                                                                                                                      |
| Python     | [psycopg3](https://www.psycopg.org/psycopg3/docs)  [psycopg2](https://www.psycopg.org/docs/install)  [asyncpg](https://magicstack.github.io/asyncpg/current) | 3.0.16  2.8.6  v0.24.0                                    | Full  Full  Partial | N/A  N/A  N/A                                                                                                                         | <InternalLink path="build-a-python-app-with-cockroachdb-psycopg3">Build a Python App with CockroachDB (psycopg3)</InternalLink>  <InternalLink path="build-a-python-app-with-cockroachdb">Build a Python App with CockroachDB (psycopg2)</InternalLink>  <InternalLink path="build-a-python-app-with-cockroachdb-asyncpg">Build a Python App with CockroachDB (asyncpg)</InternalLink> |
| Ruby       | [pg](https://rubygems.org/gems/pg)                                                                                                                           | v1.4.6                                                    | Full                | N/A                                                                                                                                   | <InternalLink path="build-a-ruby-app-with-cockroachdb">Build a Ruby App with CockroachDB (pg)</InternalLink>                                                                                                                                                                                                                                                                           |
| Rust       | [rust-postgres](https://github.com/sfackler/rust-postgres)                                                                                                   | 0.19.2                                                    | Partial             | N/A                                                                                                                                   | <InternalLink path="build-a-rust-app-with-cockroachdb">Build a Rust App with CockroachDB</InternalLink>                                                                                                                                                                                                                                                                                |

## Data access frameworks (e.g., ORMs)

| Language              | Framework                                                                                                                                                                                                                                    | Latest tested version                                                                                            | Support level      | CockroachDB adapter                                                                                                                                                                                      | Tutorial                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Go                    | [GORM](https://github.com/jinzhu/gorm/releases)  [go-pg](https://github.com/go-pg/pg)[upper/db](https://github.com/upper/db)                                                                                                                 | v1.24.1  v10.9.0v4                                                                                               | Full  FullFull     | [`crdbgorm`](https://pkg.go.dev/github.com/cockroachdb/cockroach-go/crdb/crdbgorm) (includes client-side transaction retry handling)N/AN/A                                                               | <InternalLink path="build-a-go-app-with-cockroachdb-gorm">Build a Go App with CockroachDB (GORM)</InternalLink>  N/A<InternalLink path="build-a-go-app-with-cockroachdb-upperdb">Build a Go App with CockroachDB (upper/db)</InternalLink>                                                                                                                                                                                                                                                                                 |
| Java                  | [Hibernate](https://hibernate.org/orm) (including [Hibernate Spatial](https://docs.jboss.org/hibernate/orm/current/userguide/html_single/Hibernate_User_Guide#spatial))[jOOQ](https://www.jooq.org/)[MyBatis](https://mybatis.org/mybatis-3) | 6.6.20 (must be at least 5.4.19)  3.13.2 (must be at least 3.13.0)3.5.5                                          | Full  FullFull     | N/A  N/AN/A                                                                                                                                                                                              | <InternalLink path="build-a-java-app-with-cockroachdb-hibernate">Build a Java App with CockroachDB (Hibernate)</InternalLink>  <InternalLink path="build-a-java-app-with-cockroachdb-jooq">Build a Java App with CockroachDB (jOOQ)</InternalLink><InternalLink path="build-a-spring-app-with-cockroachdb-mybatis">Build a Spring App with CockroachDB (MyBatis)</InternalLink>                                                                                                                                            |
| JavaScript/TypeScript | [Sequelize](https://www.npmjs.com/package/sequelize)  [Knex.js](https://knexjs.org/)[Prisma](https://prisma.io/)[TypeORM](https://www.npmjs.com/package/typeorm)                                                                             | v6.0.5 (use latest version of CockroachDB adapter) 2.5.1 3.14.0 0.3.17                                           | Full  FullFullFull | [`sequelize-cockroachdb`](https://www.npmjs.com/package/sequelize-cockroachdb)  N/AN/AN/A                                                                                                                | <InternalLink path="build-a-nodejs-app-with-cockroachdb-sequelize">Build a Node.js App with CockroachDB (Sequelize)</InternalLink>  <InternalLink path="build-a-nodejs-app-with-cockroachdb-knexjs">Build a Node.js App with CockroachDB (Knex.js)</InternalLink><InternalLink path="build-a-nodejs-app-with-cockroachdb-prisma">Build a Node.js App with CockroachDB (Prisma)</InternalLink><InternalLink path="build-a-typescript-app-with-cockroachdb">Build a TypeScript App with CockroachDB (TypeORM)</InternalLink> |
| Ruby                  | [ActiveRecord](https://rubygems.org/gems/activerecord) [RGeo/RGeo-ActiveRecord](https://github.com/cockroachdb/activerecord-cockroachdb-adapter#working-with-spatial-data)                                                                   | 8.1.0 (use latest version of CockroachDB adapter)                                                                | Full               | [`activerecord-cockroachdb-adapter`](https://rubygems.org/gems/activerecord-cockroachdb-adapter) (includes client-side transaction retry handling)                                                       | <InternalLink path="build-a-ruby-app-with-cockroachdb-activerecord">Build a Ruby App with CockroachDB (ActiveRecord)</InternalLink>                                                                                                                                                                                                                                                                                                                                                                                        |
| Python                | [Django](https://pypi.org/project/Django) (including [GeoDjango](https://docs.djangoproject.com/en/3.1/ref/contrib/gis))[peewee](https://github.com/coleifer/peewee)[SQLAlchemy](https://www.sqlalchemy.org/)                                | 4.1.x (use latest version of CockroachDB adapter) 3.13.30.7.131.4.17 (use latest version of CockroachDB adapter) | Full  FullFullFull | [`django-cockroachdb`](https://pypi.org/project/django-cockroachdb)  N/AN/A[`sqlalchemy-cockroachdb`](https://pypi.org/project/sqlalchemy-cockroachdb) (includes client-side transaction retry handling) | <InternalLink path="build-a-python-app-with-cockroachdb-django">Build a Python App with CockroachDB (Django)</InternalLink>  N/A (See [peewee docs](http://docs.peewee-orm.com/en/latest/peewee/playhouse#cockroach-database).)<InternalLink path="build-a-python-app-with-cockroachdb-sqlalchemy">Build a Python App with CockroachDB (SQLAlchemy)</InternalLink>                                                                                                                                                         |

## Application frameworks

| Framework | Data access                                                                                                                                                                                                                                                         | Latest tested version                                                          | Support level                                                                | Tutorial                                                                                                                                                                                                                                                                                                                                                                  |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Spring    | <InternalLink path="build-a-spring-app-with-cockroachdb-jdbc">JDBC</InternalLink><InternalLink path="build-a-spring-app-with-cockroachdb-jpa">JPA (Hibernate)</InternalLink><InternalLink path="build-a-spring-app-with-cockroachdb-mybatis">MyBatis</InternalLink> | See individual Java ORM or [driver](#drivers) for data access version support. | See individual Java ORM or [driver](#drivers) for data access support level. | <InternalLink path="build-a-spring-app-with-cockroachdb-jdbc">Build a Spring App with CockroachDB (JDBC)</InternalLink><InternalLink path="build-a-spring-app-with-cockroachdb-jpa">Build a Spring App with CockroachDB (JPA)</InternalLink><InternalLink path="build-a-spring-app-with-cockroachdb-mybatis">Build a Spring App with CockroachDB (MyBatis)</InternalLink> |

## Graphical user interfaces (GUIs)

| GUI                             | Latest tested version | Support level | Tutorial                                                                               |
| ------------------------------- | --------------------- | ------------- | -------------------------------------------------------------------------------------- |
| [DBeaver](https://dbeaver.com/) | 5.2.3                 | Full          | <InternalLink path="dbeaver">Visualize CockroachDB Schemas with DBeaver</InternalLink> |

## Integrated development environments (IDEs)

| IDE                                             | Latest tested version | Support level | Tutorial                                                                             |
| ----------------------------------------------- | --------------------- | ------------- | ------------------------------------------------------------------------------------ |
| [DataGrip](https://www.jetbrains.com/datagrip)  | 2024.1                | Full          | N/A                                                                                  |
| [IntelliJ IDEA](https://www.jetbrains.com/idea) | 2024.1                | Full          | <InternalLink path="intellij-idea">Use IntelliJ IDEA with CockroachDB</InternalLink> |

## Enhanced data security tools

| Tool                                            | Support level     | Integration                                                                           |
| ----------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------- |
| [Satori](https://satoricyber.com/)              | Partner supported | <InternalLink path="satori-integration">Satori Integration</InternalLink>             |
| [HashiCorp Vault](https://www.vaultproject.io/) | Partner supported | <InternalLink path="hashicorp-integration">HashiCorp Vault Integration</InternalLink> |

## Schema migration tools

| Tool                                                                               | Latest tested version | Support level | Tutorial                                                                                                                     |
| ---------------------------------------------------------------------------------- | --------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| [Alembic](https://alembic.sqlalchemy.org/en/latest)                                | 1.7                   | Full          | <InternalLink path="alembic">Migrate CockroachDB Schemas with Alembic</InternalLink>                                         |
| [Flyway](https://flywaydb.org/documentation/commandline#download-and-installation) | 7.1.0                 | Full          | <InternalLink path="flyway">Migrate CockroachDB Schemas with Flyway</InternalLink>                                           |
| [Liquibase](https://www.liquibase.org/download)                                    | 4.2.0                 | Full          | <InternalLink path="liquibase">Migrate CockroachDB Schemas with Liquibase</InternalLink>                                     |
| [Prisma](https://prisma.io/)                                                       | 3.14.0                | Full          | <InternalLink path="build-a-nodejs-app-with-cockroachdb-prisma">Build a Node.js App with CockroachDB (Prisma)</InternalLink> |

## Data migration tools

| Tool                                                               | Latest tested version | Support level | Documentation                                                                                    |
| ------------------------------------------------------------------ | --------------------- | ------------- | ------------------------------------------------------------------------------------------------ |
| [AWS DMS](https://aws.amazon.com/dms)                              | 3.4.6                 | Full          | <InternalLink path="aws-dms">Migrate with AWS Database Migration Service (DMS)</InternalLink>    |
| [Qlik Replicate](https://www.qlik.com/us/products/qlik-replicate)  | November 2022         | Full          | <InternalLink path="qlik">Migrate and Replicate Data with Qlik Replicate</InternalLink>          |
| [Striim](https://www.striim.com/)                                  | 4.1.2                 | Full          | <InternalLink path="striim">Migrate and Replicate Data with Striim</InternalLink>                |
| [Oracle GoldenGate](https://www.oracle.com/integration/goldengate) | 21.3                  | Partial       | <InternalLink path="goldengate">Migrate and Replicate Data with Oracle GoldenGate</InternalLink> |
| [Debezium](https://debezium.io/)                                   | 2.4                   | Full          | <InternalLink path="debezium">Migrate Data with Debezium</InternalLink>                          |

## Provisioning tools

| Tool                               | Latest tested version | Support level | Documentation                                                                                                       |
| ---------------------------------- | --------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------- |
| [Terraform](https://terraform.io/) | 1.3.2                 | Partial       | [Terraform provider for CockroachDB Cloud](https://github.com/cockroachdb/terraform-provider-cockroach#get-started) |

## Other tools

| Tool                                                    | Latest tested version | Support level     | Tutorial                                                                                                                                       |
| ------------------------------------------------------- | --------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| [Delphix](https://www.delphix.com/)                     | 29.0.0.1              | Partner supported | [Provision, mask, and integrate data with Delphix (external)](https://www.delphix.com/blog/modern-database-meets-modern-devops-data-platform)  |
| [Flowable](https://github.com/flowable/flowable-engine) | 6.4.2                 | Full              | [Getting Started with Flowable and CockroachDB (external)](https://blog.flowable.org/2019/07/11/getting-started-with-flowable-and-cockroachdb) |

## See also

* <InternalLink path="example-apps">Example Apps</InternalLink>
* <InternalLink path="install-client-drivers">Install a Driver or ORM Framework</InternalLink>
* <InternalLink path="community-tooling">Third-Party Tools Supported by the Community</InternalLink>