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

# PlanetScale

> PlanetScale is a MySQL-compatible serverless database that brings you scale, performance, and reliability — without sacrificing developer experience. With PlanetScale, you get the power of horizontal sharding, non-blocking schema changes, and many more powerful database features without the pain of implementing them.

## Overview

Hightouch lets you pull data stored in PlanetScale and push it to downstream destinations. Most of the setup occurs in the Hightouch UI, but you need access to PlanetScale for information like your hostname, database, and credentials.

> [!NOTE]
>
> You may need to allowlist Hightouch's IP addresses to let our systems connect to your warehouse. Reference our [networking docs](https://docs.hightouch.com/security/networking#ip-addresses) to determine which IP addresses you need to allowlist.

## Connection configuration

To get started, go to the [**Sources** overview page](https://app.hightouch.com/sources?from=docs) and click the **Add source** button. Select **PlanetScale** and follow the steps below.

### Configure your source

Enter the following required fields into Hightouch:

* **Host**: The hostname or IP address of your PlanetScale.
* **Port**: The port number of your PlanetScale. The default is 3306, but yours may be different.
* **Database**: The name of the database in your PlanetScale.

### Provide your credentials

Enter the following fields into Hightouch:

* **User**: This can be your personal PlanetScale login or a dedicated user for Hightouch.
* (Optional) **Password**: The password for the user specified above.

## Test your connection

When setting up PlanetScale as a source for the first time, Hightouch validates your credentials and access to your database. Once the test passes, click **Continue** to finish setup.

## Create models

Once your source configuration has passed the necessary validation, you've completed setting up PlanetScale as a source. Next, you can set up [models](https://docs.hightouch.com/getting-started/concepts.md#models) to define which data you want to pull from PlanetScale.

The PlanetScale source supports these modeling methods:

* writing a query in [the SQL editor](https://docs.hightouch.com/models/sql-editor.md)
* using the visual [table selector](https://docs.hightouch.com/models/table-selector.md)
* leveraging existing [dbt models](https://docs.hightouch.com/extensions/dbt-models.md)

## Tips and troubleshooting

If you run into an issue this page doesn't cover, [contact support](#pylon-chat).