Connector Catalog
Sources
CockroachDB

The CockroachDB source supports both Full Refresh and Incremental syncs. You can choose if this connector will copy only the new or updated data, or all rows in the tables and columns you set up for replication, every time a sync is run.

The CockroachDb source does not alter the schema present in your database. Depending on the destination connected to this source, however, the schema may be altered. See the destination's documentation for more details.

CockroachDb data types are mapped to the following data types when synchronizing data:
CockroachDb Type
Resulting Type
Notes
bigint
integer
bit
boolean
boolean
boolean
character
string
character varying
string
date
string
double precision
string
enum
number
inet
string
int
integer
json
string
jsonb
string
numeric
number
smallint
integer
text
string
time with timezone
string
may be written as a native date type depending on the destination
time without timezone
string
may be written as a native date type depending on the destination
timestamp with timezone
string
may be written as a native date type depending on the destination
timestamp without timezone
string
may be written as a native date type depending on the destination
uuid
string
Note: arrays for all the above types as well as custom types are supported, although they may be de-nested depending on the destination.

Feature
Supported
Notes
Full Refresh Sync
Yes
Incremental Sync
Yes
Change Data Capture
No
SSL Support
Yes

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

This is dependent on your networking setup. The easiest way to verify if Airbyte is able to connect to your CockroachDb instance is via the check connection tool in the UI.
This step is optional but highly recommended to allow for better permission control and auditing. Alternatively, you can use Airbyte with an existing user in your database.
To create a dedicated database user, run the following commands against your database:
CREATE USER airbyte PASSWORD 'your_password_here';
Then give it access to the relevant schema:
GRANT USAGE ON SCHEMA <schema_name> TO airbyte
Note that to replicate data from multiple CockroachDb schemas, you can re-run the command above to grant access to all the relevant schemas, but you'll need to set up multiple sources connecting to the same db on multiple schemas.
Next, grant the user read-only access to the relevant tables. The simplest way is to grant read access to all tables in the schema as follows:
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;

Your database user should now be ready for use with Airbyte.

Version
Date
Pull Request
Subject
0.1.10
2022-02-24
10235
Fix Replication Failure due Multiple portal opens
0.1.9
2022-02-21
10242
Fixed cursor for old connectors that use non-microsecond format. Now connectors work with both formats
0.1.8
2022-02-18
10242
Updated timestamp transformation with microseconds
0.1.7
2022-02-14
10256
Add -XX:+ExitOnOutOfMemoryError JVM option
0.1.6
2022-02-08
10173
Improved discovering tables in case if user does not have permissions to any table
0.1.5
2021-12-24
9004
User can see only permmited tables during discovery
0.1.4
2021-12-24
8958
Add support for JdbcType.ARRAY
0.1.3
2021-10-10
7819
Fixed Datatype errors during Cockroach DB parsing
0.1.2
2021-08-13
4699
Added json config validator

Version
Date
Pull Request
Subject
0.1.6
2022-02-21
10242
Fixed cursor for old connectors that use non-microsecond format. Now connectors work with both formats
0.1.5
2022-02-18
10242
Updated timestamp transformation with microseconds
0.1.4
2022-02-14
10256
Add -XX:+ExitOnOutOfMemoryError JVM option
0.1.3
2022-02-08
10173
Improved discovering tables in case if user does not have permissions to any table
0.1.2
2021-12-24
9004
User can see only permmited tables during discovery
0.1.1
2021-12-24
8958
Add support for JdbcType.ARRAY
0.1.0
2021-11-23
7457
CockroachDb source: Add only encrypted version for the connector
Last modified 7mo ago
Copy link
On this page
Overview
Resulting schema
Data type mapping
Features
Getting started
Requirements
Setup guide
Changelog
Changelog source-cockroachdb-strict-encrypt