Advanced Analytica Advanced Analytica: IBOM
← All connectors
Cockroachdb logo

Source connector

Cockroachdb

Set up Cockroachdb as a source and move its data into your chosen destination.

Version 0.2.5 community alpha

CockroachDB

Overview

The CockroachDB source supports Full Refresh and Incremental syncs. For each sync, you can copy new or updated data, or every configured row and column.

Resulting schema

The CockroachDb source preserves your database schema. However, the connected destination may alter it. See the destination’s documentation for details.

Data type mapping

CockroachDb data types map to the following data types during synchronisation:

CockroachDb TypeResulting TypeNotes
bigintinteger
bitboolean
booleanboolean
characterstring
character varyingstring
datestring
double precisionstring
enumnumber
inetstring
intinteger
jsonstring
jsonbstring
numericnumber
smallintinteger
textstring
time with timezonestringmay be written as a native date type depending on the destination
time without timezonestringmay be written as a native date type depending on the destination
timestamp with timezonestringmay be written as a native date type depending on the destination
timestamp without timezonestringmay be written as a native date type depending on the destination
uuidstring

Note: arrays support every type above and custom types. Your destination may de-nest them.

Features

FeatureSupportedNotes
Full Refresh SyncYes
Incremental SyncYes
Change Data CaptureNo
SSL SupportYes

Get started

Requirements

  1. CockroachDb v1.15.x or above
  2. Allow connections from Airbyte to your CockroachDb database (if they’re in separate VPCs)
  3. Create a dedicated read-only Airbyte user with access to every table needed for replication

Setup guide

1. Confirm database access from the machine running Airbyte

Access depends on your network setup. Use the check connection tool in the UI to confirm Airbyte can connect to your CockroachDb instance.

For clearer permission control and auditing, create a dedicated read-only user. This step is optional. You can instead use an existing database user with Airbyte.

Run the following commands against your database to create a dedicated user:

CREATE USER airbyte PASSWORD 'your_password_here';

Then grant the user access to the relevant schema:

GRANT USAGE ON SCHEMA <schema_name> TO airbyte

To replicate data from several CockroachDb schemas, rerun the command for every relevant schema. You’ll also need multiple sources connecting to the same db across those schemas.

Next, grant the user read-only access to the relevant tables. The simplest approach grants read access to every table in the schema:

GRANT SELECT ON ALL TABLES IN SCHEMA <schema_name> TO airbyte;

# Allow airbyte user to see tables created in the future
ALTER DEFAULT PRIVILEGES IN SCHEMA <schema_name> GRANT SELECT ON TABLES TO airbyte;

3. Complete the setup

Your database user is now ready to use with Airbyte.

IP allow list

If you use Airbyte Cloud and your network restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.2.52025-07-1062914Convert to new gradle build flow
0.2.42025-01-1051484Use a non root base image
0.2.32024-12-1849915Use a base image: airbyte/java-connector-base:1.0.0
0.2.22024-02-1335234Adopt CDK 0.20.4
0.2.12024-01-2434453bump CDK version
0.2.02023-12-1833485Removed LEGACY state
0.1.222023-03-2220760Removed redundant date-time datatypes formatting
0.1.212023-03-1424000Removed check method call on read.
0.1.202023-03-0623455For network isolation, source connector accepts a list of hosts it is allowed to connect
0.1.192022-12-1420346Consolidate date/time values mapping for JDBC sources
2022-10-1315535Update incremental query to avoid data missing when new data is inserted at the same time as a sync starts under non-CDC incremental mode
0.1.182022-09-0116394Added custom jdbc properties field
0.1.172022-09-0116238Emit state messages more frequently
0.1.162022-08-1814356DB Sources: only show a table can sync incrementally if at least one column can be used as a cursor field
0.1.132022-07-1414574Removed additionalProperties:false from JDBC source connectors
0.1.122022-04-2912480Query tables with adaptive fetch size to optimize JDBC memory consumption
0.1.112022-04-0611729Bump mina-sshd from 2.7.0 to 2.8.0
0.1.102022-02-2410235Fix Replication Failure due Multiple portal opens
0.1.92022-02-2110242Fixed cursor for old connectors that use non-microsecond format. Now connectors work with both formats
0.1.82022-02-1810242Updated timestamp transformation with microseconds
0.1.72022-02-1410256Add -XX:+ExitOnOutOfMemoryError JVM option
0.1.62022-02-0810173Improved discovering tables in case if user does not have permissions to any table
0.1.52021-12-249004User can see only permmited tables during discovery
0.1.42021-12-248958Add support for JdbcType.ARRAY
0.1.32021-10-107819Fixed Datatype errors during Cockroach DB parsing
0.1.22021-08-134699Added json config validator
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.