Databricks

Overview

This destination syncs data to Databricks cluster. Each stream is written to its own table.
This connector requires a JDBC driver to connect to Databricks cluster. The driver is developed by Simba. Before using the driver and the connector, you must agree to the JDBC ODBC driver license. This means that you can only use this connector to connector third party applications to Apache Spark SQL within a Databricks offering using the ODBC and/or JDBC protocols.
Due to legal reasons, this is currently a private connector that is only available in Airbyte Cloud. We are working on publicizing it. Please follow this issue for progress.

Sync Mode

Feature
Support
Notes
Full Refresh Sync
Warning: this mode deletes all previously synced data in the configured bucket path.
Incremental - Append Sync
Incremental - Deduped History
Namespaces

Data Source

Databricks supports various cloud storage as the data source. Currently, only Amazon S3 is supported.

Configuration

Category
Parameter
Type
Notes
Databricks
Server Hostname
string
Required. See documentation.
HTTP Path
string
Required. See documentation.
Port
string
Optional. Default to "443". See documentation.
Personal Access Token
string
Required. See documentation.
General
Database schema
string
Optional. Default to "public". Each data stream will be written to a table under this database schema.
Purge Staging Data
boolean
The connector creates staging files and tables on S3. By default they will be purged when the data sync is complete. Set it to false for debugging purpose.
Data Source - S3
Bucket Name
string
Name of the bucket to sync data into.
Bucket Path
string
Subdirectory under the above bucket to sync the data into.
Region
string
See documentation for all region codes.
Access Key ID
string
AWS/Minio credential.
Secret Access Key
string
AWS/Minio credential.
⚠️ Please note that under "Full Refresh Sync" mode, data in the configured bucket and path will be wiped out before each sync. We recommend you to provision a dedicated S3 resource for this sync to prevent unexpected data deletion from misconfiguration. ⚠️

Staging Parquet Files

Data streams are first written as staging Parquet files on S3, and then loaded into Databricks tables. All the staging files will be deleted after the sync is done. For debugging purposes, here is the full path for a staging file:
1
s3://<bucket-name>/<bucket-path>/<uuid>/<stream-name>
Copied!
For example:
1
s3://testing_bucket/data_output_path/98c450be-5b1c-422d-b8b5-6ca9903727d9/users
2
↑ ↑ ↑ ↑
3
| | | stream name
4
| | database schema
5
| bucket path
6
bucket name
Copied!

Unmanaged Spark SQL Table

Currently, all streams are synced into unmanaged Spark SQL tables. See documentation for details. In summary, you have full control of the location of the data underlying an unmanaged table. The full path of each data stream is:
1
s3://<bucket-name>/<bucket-path>/<database-schema>/<stream-name>
Copied!
For example:
1
s3://testing_bucket/data_output_path/public/users
2
↑ ↑ ↑ ↑
3
| | | stream name
4
| | database schema
5
| bucket path
6
bucket name
Copied!
Please keep these data directories on S3. Otherwise, the corresponding tables will have no data in Databricks.

Output Schema

Each table will have the following columns:
Column
Type
Notes
_airbyte_ab_id
string
UUID.
_airbyte_emitted_at
timestamp
Data emission timestamp.
Data fields from the source stream
various
All fields in the staging Parquet files will be expanded in the table.
Under the hood, an Airbyte data stream in Json schema is first converted to an Avro schema, then the Json object is converted to an Avro record, and finally the Avro record is outputted to the Parquet format. Because the data stream can come from any data source, the Json to Avro conversion process has arbitrary rules and limitations. Learn more about how source data is converted to Avro and the current limitations here.

Getting started

Requirements

  1. 1.
    Credentials for a Databricks cluster. See documentation.
  2. 2.
    Credentials for an S3 bucket. See documentation.
  3. 3.
    Grant the Databricks cluster full access to the S3 bucket. Or mount it as Databricks File System (DBFS). See documentation.

CHANGELOG

Version
Date
Pull Request
Subject
0.1.3
2022-01-06
#7622 #9153
Upgrade Spark JDBC driver to 2.6.21 to patch Log4j vulnerability; update connector fields title/description.
0.1.2
2021-11-03
#7288
Support Json additionalProperties.
0.1.1
2021-10-05
#6792
Require users to accept Databricks JDBC Driver Terms & Conditions.
0.1.0
2021-09-14
#5998
Initial private release.
Last modified 12d ago