Overview
Hightouch lets you pull data stored in your Materialize database and push it to downstream destinations. Most of the setup occurs in the Hightouch UI, but you need access to your Materialize instance for information like your host, port, database name, cluster, and credentials.You may need to allowlist Hightouch’s IP addresses to let our systems connect to your warehouse. Reference our networking docs to determine which IP addresses you need to allowlist.
Connection configuration
To get started, go to the Sources overview page and click the Add source button. Select Materialize and follow the steps below.Configure your source
Enter the following required fields into Hightouch:- Host: The hostname or IP address of your Materialize server.
- Port: The port number of your Materialize server. The default port number is 6875, but yours may be different.
- Database: This specifies the database to use when Hightouch executes queries in Materialize.
Provide credentials
Enter the following fields into Hightouch:- User: This can be your personal Materialize login or a dedicated user for Hightouch. At minimum, this user must have read access to the data you wish to sync.
- Password: The password for the user specified above.
Test your connection
When setting up a source for the first time, Hightouch validates the following:- Network connectivity
- Materialize credentials
- Permission to list schemas and tables
- Permission to write to
hightouch_plannerschema - Permission to write to
hightouch_auditschema
Create models
Once your source configuration has passed the necessary validation, your source setup is complete. Next, you can set up models to define which data you want to pull from Materialize. The Materialize source supports these modeling methods:- writing a query in the SQL editor
- using the visual table selector
- leveraging existing dbt models
- leveraging existing Looker Looks
- leveraging existing Sigma workbooks
You must enable the Lightning sync engine to store sync logs in your warehouse.