> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skypoint.ai/llms.txt
> Use this file to discover all available pages before exploring further.

#  

# Integrating Hightouch with Lakehouse SQL

## Overview

Hightouch serves as a Reverse ETL (Extract, Transform, Load) solution, facilitating the extraction of data from a warehouse or database, and subsequently loading it into Sales, Marketing, and analytics tools via SQL, with no need for scripts. By leveraging this technology, you can synchronize your data from skyData Lakehouse SQL with Hightouch, without having to rely on APIs, CSVs, or engineering assistance. skyData is built to accommodate various analytics, machine learning, artificial intelligence, and business intelligence applications.

skyData leverages Databricks SQL to create a connection between the Lakehouse in skyData and the Hightouch client. This connection allows for the seamless loading of data into your Sales, Marketing, or analytics tools.

## Prerequisites

* Lakehouse SQL must be provisioned in your tenant.
* Connection details, such as Server Hostname, Port, and HTTP Path, are required to establish a connection.
* You must also have a personal access token from Lakehouse SQL for your tenant.

Follow the below steps to integrate Hightouch with Lakehouse SQL:

## Connect Hightouch to Lakehouse SQL

1. [Login in](https://app.hightouch.com/login) with a Hightouch account.

<img src="https://mintcdn.com/skypoint/lMthVWHJGJeZskWx/doc_snippets/CreateWorkspace.png?fit=max&auto=format&n=lMthVWHJGJeZskWx&q=85&s=95c4db11b21ad3828383cdad45945821" alt="Alt text" width="804" height="546" data-path="doc_snippets/CreateWorkspace.png" />

2. Click **Create a workspace** to create a new workspace. If you have already created a workspace, then select an existing one.

<img src="https://mintcdn.com/skypoint/4Z0OwIu1cZvSAeC9/doc_snippets/NameWorkspace.png?fit=max&auto=format&n=4Z0OwIu1cZvSAeC9&q=85&s=83741e1810d335834a82d25fb401bee8" alt="Alt text" width="618" height="789" data-path="doc_snippets/NameWorkspace.png" />

3. Enter a name for a new workspace and click **Create workspace**. You can choose **Region** from the drop-down list.

<img src="https://mintcdn.com/skypoint/867s-f5L6ea4TG6I/doc_snippets/AddSource.png?fit=max&auto=format&n=867s-f5L6ea4TG6I&q=85&s=48ec5e47797129a970e13f71446075c5" alt="Alt text" width="1896" height="702" data-path="doc_snippets/AddSource.png" />

4. In the left pane, click **Sources**.
5. Click **Add source**.

<img src="https://mintcdn.com/skypoint/TOvJZvWJvuo-IXU4/doc_snippets/SourceCatalog.png?fit=max&auto=format&n=TOvJZvWJvuo-IXU4&q=85&s=a4e56748ef18ff7346a469fa349165ea" alt="Alt text" width="1606" height="886" data-path="doc_snippets/SourceCatalog.png" />

6. Click **Databricks**, and then click **Continue**.

<img src="https://mintcdn.com/skypoint/nPdgNYOq-2eeVuRI/doc_snippets/ConnectDatabricks.png?fit=max&auto=format&n=nPdgNYOq-2eeVuRI&q=85&s=98f74c019d8582b62b568f203bb96cfe" alt="Alt text" width="1586" height="935" data-path="doc_snippets/ConnectDatabricks.png" />

7. Enter **Server Hostname**, **Port**, **HTTP Path**, and **Access Token**. You can get these deatils from Lakehouse > SQL access in Skypoint studio.

<img src="https://mintcdn.com/skypoint/rlEvQ6KeIp3O4W4W/doc_snippets/LakehouseSQL_Connection.png?fit=max&auto=format&n=rlEvQ6KeIp3O4W4W&q=85&s=47e03aa92811db367b400c0bdf48e96e" alt="Alt text" width="1554" height="1114" data-path="doc_snippets/LakehouseSQL_Connection.png" />

8. For Default Schema, enter the name of the target database.
9. Click **Test Connection**. Make sure that testing the source returns green before continuing to the next step.
10. Once the connection is successful, click **Continue**.

<img src="https://mintcdn.com/skypoint/TOvJZvWJvuo-IXU4/doc_snippets/SourceFinish.png?fit=max&auto=format&n=TOvJZvWJvuo-IXU4&q=85&s=b140bef7cd50eb00ab95ed9910b0b2bb" alt="Alt text" width="1615" height="798" data-path="doc_snippets/SourceFinish.png" />

11. You can enter a name for the connection, and then click **Finish**.

## Connect to your destination

Follow the below steps to set your destination:

1. In the workspace navigation pane, click **Destinations**.

2. Click the **Add destination** button to add your destination. You can also type your destination in the filter box.

<img src="https://mintcdn.com/skypoint/867s-f5L6ea4TG6I/doc_snippets/AddDestination.png?fit=max&auto=format&n=867s-f5L6ea4TG6I&q=85&s=e48970f50a1d4388e7bf4d5cb3299534" alt="Alt text" width="1918" height="535" data-path="doc_snippets/AddDestination.png" />

3. Select your **Destination catalog** and click on **Continue**. For instance, in this section, we create a connection with the SendGrid connector for exporting data.

<img src="https://mintcdn.com/skypoint/OAzQZDbhgP065cI-/doc_snippets/DestinationCatalog.png?fit=max&auto=format&n=OAzQZDbhgP065cI-&q=85&s=ee32ff9f32747f5f2bad02105d955b88" alt="Alt text" width="1593" height="723" data-path="doc_snippets/DestinationCatalog.png" />

4. Enter **API Key** and then click **Continue**.

<img src="https://mintcdn.com/skypoint/867s-f5L6ea4TG6I/doc_snippets/AddNewDestination.png?fit=max&auto=format&n=867s-f5L6ea4TG6I&q=85&s=3835fa95c2e01cdaae4ff59f50c6c92e" alt="Alt text" width="1621" height="720" data-path="doc_snippets/AddNewDestination.png" />

5. Enter a name for the destination, and then click **Finish**.

<img src="https://mintcdn.com/skypoint/4Z0OwIu1cZvSAeC9/doc_snippets/NameDestination.png?fit=max&auto=format&n=4Z0OwIu1cZvSAeC9&q=85&s=2d85ee2e24b25dc903dc7af8d86639bb" alt="Alt text" width="1615" height="476" data-path="doc_snippets/NameDestination.png" />

## Add a model in Hightouch

Follow the below steps to add a model in Hightouch:

1. Select "Add model" and select the datasource for which the model has to be added.

<img src="https://mintcdn.com/skypoint/867s-f5L6ea4TG6I/doc_snippets/Addmodel.png?fit=max&auto=format&n=867s-f5L6ea4TG6I&q=85&s=c272754c46a24783170367b2928c16a9" alt="Alt text" width="1384" height="415" data-path="doc_snippets/Addmodel.png" />

2. Define the model. Hightouch provides 3 options for defining the model: Query with SQL, Create from table or view and import model from Sigma.

<img src="https://mintcdn.com/skypoint/rlEvQ6KeIp3O4W4W/doc_snippets/ModelingMethod.png?fit=max&auto=format&n=rlEvQ6KeIp3O4W4W&q=85&s=6b5dc83d7579d8801d6f3ed922dc2ada" alt="Alt text" width="1511" height="576" data-path="doc_snippets/ModelingMethod.png" />

3. For instance,in this section we select Query with SQL to define a model.

4. After the model definition, provide basic details for the model like name, description and primary key.

<img src="https://mintcdn.com/skypoint/rlEvQ6KeIp3O4W4W/doc_snippets/ModelFinal.png?fit=max&auto=format&n=rlEvQ6KeIp3O4W4W&q=85&s=3fdc08fe4a740b269d1541580083e92d" alt="Alt text" width="1337" height="907" data-path="doc_snippets/ModelFinal.png" />

5. Click on "Finish".

## Add a sync in Hightouch

To add sync for models in Hightouch, follow these steps:

1. Click on "Add sync" and choose the model you want to sync.

<img src="https://mintcdn.com/skypoint/2X7jtvmKL6_-6PTU/doc_snippets/SelectModelForSync.png?fit=max&auto=format&n=2X7jtvmKL6_-6PTU&q=85&s=3e65de0efbba0d07489822500b69ff98" alt="Alt text" width="1488" height="518" data-path="doc_snippets/SelectModelForSync.png" />

2. Select the destination where you want the data to be synced.

<img src="https://mintcdn.com/skypoint/iTA6t1ClmCTwAP1J/doc_snippets/SyncDestination.png?fit=max&auto=format&n=iTA6t1ClmCTwAP1J&q=85&s=e0bdbfa6b9015217feab92a6a0312548" alt="Alt text" width="1381" height="423" data-path="doc_snippets/SyncDestination.png" />

3. Configure the sync to the destination by selecting the primary keys and mapping the necessary fields between the source and destination tables.

<img src="https://mintcdn.com/skypoint/867s-f5L6ea4TG6I/doc_snippets/AddSyncmapping.png?fit=max&auto=format&n=867s-f5L6ea4TG6I&q=85&s=5a2cf19dff7b574f387aed4c46807258" alt="Alt text" width="1358" height="830" data-path="doc_snippets/AddSyncmapping.png" />

4. Set the schedule type for the sync and click "Finish".

5. Run the sync.

## Check the exported data in destination.

To check the exported data in the destination after syncing with Hightouch, follow these steps:

1. Access the destination where the data was synced.

2. Look for the data that was exported from the source table and confirm that it has been successfully transferred to the destination.

3. Verify that the data is accurate and complete.

4. If needed, perform any necessary data cleansing or transformation.

5. The exported data is now available for further usage, such as reporting, analysis, or integration with other systems.
