# Decodable

This page describes how to integrate WarpStream with Decodable, ingest data into Decodable from WarpStream, and query the data in Decodable.

A video walkthrough can be found below:

<figure class="video">
<iframe src="https://www.youtube-nocookie.com/embed/hgSFpKwIZGQ" title="Video" loading="lazy" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe>
</figure>

## Prerequisites

1. WarpStream account - get access to WarpStream by registering [here](https://console.warpstream.com/signup).
2. Decodable account - get access to Decodable by registering [here](https://www.decodable.co/).
3. WarpStream cluster is up and running.

## Step 1: Create a topic in your WarpStream cluster

Obtain the Bootstrap Broker from the WarpStream console by navigating to your cluster and clicking the Connect tab. If you don't have SASL credentials yet, you can also [create a set of credentials](/warpstream/kafka/manage-security/sasl-authentication#creating-credentials) from the console.

Store these values as environment variables for easy reference:

```bash
export BOOTSTRAP_HOST=<YOUR_BOOTSTRAP_BROKER> \
SASL_USERNAME=<YOUR_SASL_USERNAME> \
SASL_PASSWORD=<YOUR_SASL_PASSWORD>;
```

Then, create a topic using the WarpStream CLI:

```bash wrap
warpstream kcmd -bootstrap-host $BOOTSTRAP_HOST -tls -username $SASL_USERNAME -password $SASL_PASSWORD -type create-topic -topic decodable_demo
```

You should see the following output in your Terminal:

`Created topic decodable_demo.`

## Step 2: Produce some records

Using the WarpStream CLI, produce several messages to your topic:

```bash wrap
warpstream kcmd -bootstrap-host $BOOTSTRAP_HOST -tls -username $SASL_USERNAME -password $SASL_PASSWORD -type produce -topic decodable_demo --records '{"action": "click", "user_id": "user_0", "page_id": "home"},,{"action": "hover", "user_id": "user_0", "page_id": "home"},,{"action": "scroll", "user_id": "user_0", "page_id": "home"},,{"action": "click", "user_id": "user_1", "page_id": "home"},,{"action": "click", "user_id": "user_1", "page_id": "home"},,{"action": "click", "user_id": "user_2", "page_id": "home"}'
```

Note that the WarpStream CLI uses double commas (`,,)` as a delimiter between JSON records.

## Step 3: Connect Decodable to WarpStream

In the Decodable Web Console, under the Start Building heading, click "**Connect to a source**". Select "**Apache Kafka**", and configure Decodable to read from your WarpStream topic.

![](../../../../assets/docs/screenshot-2023-12-22-at-3-01-20-pm.png)

Click **Next.**

Create a new stream named `decodable_demo`:

![](../../../../assets/docs/screenshot-2023-12-22-at-3-02-31-pm.png)

Specify the schema of our data:

![](../../../../assets/docs/screenshot-2023-12-22-at-3-06-14-pm.png)

And finally, finish creating the Connection:

![](../../../../assets/docs/screenshot-2023-12-22-at-3-05-48-pm.png)

## Step 4: Start the Connection and verify that Decodable is ingesting data from WarpStream

In the upper right corner of the Connection overview screen, click "**Start**", then start the connection with the default settings:

![](../../../../assets/docs/image-2-1-1.png)

After a few moments, the Decodable Connection should transition from **Starting** to **Running**, and the Output Metrics will show that Decodable is consuming from WarpStream:

![](../../../../assets/docs/screenshot-2023-12-22-at-3-11-26-pm.png)

Navigate to **Streams > decodable\_demo** to view a sample of your data in Decodable.

![](../../../../assets/docs/screenshot-2023-12-22-at-3-13-42-pm.png)

## Step 5: Create a Pipeline

In the Decodable Web Console, navigate to **Pipelines > Create your first Pipeline** and select `decodable_demo` from the list of Streams.

![](../../../../assets/docs/screenshot-2023-12-22-at-3-19-08-pm.png)

This query creates a new Stream and inserts only the records that have a `user_id` of `user_0`.

Click **Next**.

Click **Create Stream**, then click **Next.**

![](../../../../assets/docs/screenshot-2023-12-22-at-3-21-02-pm.png)

Name your Pipeline and click **Create Pipeline**.

![](../../../../assets/docs/screenshot-2023-12-22-at-3-22-18-pm.png)

Produce some more records to WarpStream from your Terminal (you can add more records if you want; just remember to use the `,,` delimiter in the WarpStream CLI):

```bash wrap
warpstream kcmd -bootstrap-host $BOOTSTRAP_HOST -tls -username $SASL_USERNAME -password $SASL_PASSWORD -type produce -topic decodable_demo --records '{"action": "click", "user_id": "user_0", "page_id": "home"},,{"action": "hover", "user_id": "user_1", "page_id": "home"},,{"action": "scroll", "user_id": "user_1", "page_id": "home"},,{"action": "click", "user_id": "", "page_id": "home"},,{"action": "click", "user_id": "", "page_id": "home"},,{"action": "click", "user_id": "user_0", "page_id": "home"}'
```

And then **Start** your Pipeline, configuring it to read from the earliest offset:

![](../../../../assets/docs/screenshot-2023-12-22-at-3-26-21-pm.png)

After a few moments, you should be able to observe the Input and Output Metrics, confirming that the Pipeline is working as expected!

![](../../../../assets/docs/screenshot-2023-12-22-at-3-28-43-pm.png)

## Next Steps

Congratulations! You've set up a stream processing pipeline between WarpStream and Decodable and created a simple Pipeline that filters data out of a firehose of events.

Next, check out the WarpStream docs for configuring the [WarpStream Agent](/warpstream/agent-setup/deploy), or review the [Decodable docs](https://docs.decodable.co/docs) to learn more about what is possible with WarpStream and Decodable!