Using the Couchbase Query component in Matillion ETL for Snowflake

  • Laura Malins, ETL Product Manager
  • June 12, 2018

Matillion uses the Extract-Load-Transform (ELT) approach to delivering quick results for a wide range of data processing purposes: everything from customer behavior analytics, financial analysis, and even reducing the cost of synthesizing DNA.

The Couchbase Query Component presents an easy-to-use graphical interface, enabling you to connect to Couchbase and pull tables from there into Snowflake. Many of our customers are using this service to bring Couchbase data into Snowflake to combine with other data. Couchbase Server, originally known as Membase, is an open-source, distributed multi-model NoSQL, document-oriented database software package optimized for interactive applications. These applications may serve many concurrent users by creating, storing, retrieving, aggregating, manipulating and presenting data.

The connector is completely self-contained: no additional software installation is required. It’s within the scope of an ordinary Matillion license, so there is no additional cost for using the features.


The first step in configuring the Couchbase Query component is to provide your server details to connect into Couchbase. Click on the 3 dots next to the server property, and then enter the Server IP or name into the pop-up box.

User and Password

Next, you will need to supply your Couchbase database User and Password. Once Couch base has authenticated your details, you can access the data. Following this step, you can complete the Data Source and Data Selection properties in Matillion.

Data Source

Once you have access to the data you will be able to choose the data you want to load into Snowflake. The Data Source drop-down is a list of the tables available in your Couchbase database. You can, therefore, use this list to easily identify and select the data you want to load.

Data Selection

After choosing the Data Source, next, choose the required fields from the Data Source in the Data Selection. Within Matillion, the Data Selection property shows the list of the columns available in the Data Source you previously selected. The data you select here will populate a new table you name and create in Snowflake, which will discuss in a subsequent step.

Data Source Filter

If required, you can use a filter to limit or refine the returned data. This filter will run as the WHERE clause in Couchbase.

Running the Couchbase Query component in Matillion ETL for Snowflake

Before you can run the component, you need the name the Target Table for your selected data. This will be the name of a new table you are creating to write the data into in Snowflake. Also, an S3 Staging Area must be specified. This is the S3 bucket that will be used temporarily to store the results of the query before it is loaded into Snowflake.

This component also has a Limit property which can be used to force an upper limit on the number of records returned.

You can run the Orchestration job, either manually or by using the Scheduler, to query your data and bring it into Snowflake.

Advanced mode

The Couchbase Query component offers an “Advanced” mode in addition to the default “Basic” mode. In Advanced mode, you can write a SQL-like query over all the available tables. This is automatically translated into the correct API calls to retrieve the data requested.

Transforming the Data

Once you have brought in the required from Couchbase into Snowflake, you can use it in a Transformation job:

In this way, you can build out the rest of your downstream transformations and analysis, taking advantage of Snowflake’s power and scalability.

Useful Links

Couchbase Query Component in Matillion ETL for Snowflake
Component Data Model
Integration information

[callout-content title=”Want to try the Couchbase Query component in Matillion ETL for Snowflake? Request a free 1-hour demonstration, or start a 14-day free trial.”]

[button title=”Get Free Demo” link=”/get-a-demo/snowflake/”]

[button title=”Get 14-day Free Trial” link=”/free-trials-test-drives/etl-for-snowflake/” style=”ghost”]