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

# Connect Your Data Warehouse

> Set up a secure connection between ClarityQ and your data warehouse.

The first step to using ClarityQ is connecting your data warehouse. ClarityQ uses **read-only access** to query your data — it never writes to or modifies your database.

## Supported Data Warehouses

<CardGroup cols={3}>
  <Card title="BigQuery" icon="google" href="/data-warehouse/bigquery">
    Google BigQuery
  </Card>

  <Card title="Snowflake" icon="snowflake" href="/data-warehouse/snowflake">
    Snowflake
  </Card>

  <Card title="Redshift" icon="aws" href="/data-warehouse/redshift">
    Amazon Redshift
  </Card>

  <Card title="PostgreSQL" icon="database" href="/data-warehouse/postgres">
    PostgreSQL
  </Card>

  <Card title="Databricks" icon="cube" href="/data-warehouse/databricks">
    Databricks
  </Card>

  <Card title="MaxCompute" icon="cloud" href="/data-warehouse/maxcompute">
    Alibaba Cloud MaxCompute
  </Card>

  <Card title="Athena" icon="aws" href="/data-warehouse/athena">
    Amazon Athena
  </Card>

  <Card title="Trino" icon="server" href="/data-warehouse/trino">
    Trino (incl. Starburst)
  </Card>

  <Card title="ClickHouse" icon="bolt" href="/data-warehouse/clickhouse">
    ClickHouse
  </Card>
</CardGroup>

## Setup Process

You need permission to manage the data warehouse connection, which **Admins** and **Integration Managers** have.

1. **Configure credentials** — Follow the platform-specific guide to create a service account or user with read-only access.
2. **Start the wizard** — It opens on a welcome screen; click **Start**.
3. **Select your data warehouse** — Choose from the supported platforms above.
4. **Enter your connection details**, then click **Test Connection**. The **Finish** button stays disabled until the test passes, so you can't save a connection that doesn't work.

<Tip>
  The setup wizard walks you through each step. Most connections take under 10 minutes to configure.
</Tip>

## What Happens After You Connect

Connecting a warehouse doesn't give ClarityQ your tables — you choose them. The wizard's final screen offers **Add tables now**, which opens the **Add Tables to the Context** wizard in the [Table Catalog](/context-layer/table-catalog/what-is-the-table-catalog).

That wizard runs in four steps: select the tables, add table documentation, define mandatory filters, and review what you added. See [Setting Up Your Table Catalog](/context-layer/table-catalog/setting-up-your-table-catalog) for the full walkthrough.

## What Every Connection Includes

* **Read-only access** — ClarityQ never writes to your database
* **Encrypted data transmission** via SSL/TLS
* **Authentication options** tailored to each platform (service accounts, IAM roles, dedicated users)
* **Connection pooling** for optimal performance
* **Troubleshooting steps** in each platform guide

## Per-User Permissions

By default every query runs as the service account you configure, and ClarityQ's [roles](/admin/user-management-and-roles) decide what people can reach. If your data warehouse already enforces who may see which rows, [Databricks](/data-warehouse/databricks#run-queries-as-the-asking-user-per-user-permissions) and [Trino](/data-warehouse/trino#run-queries-as-the-asking-user-per-user-permissions) connections can instead run each query under the asking user's own identity, so your warehouse's grants, row filters and masks apply to what they ask. Each person then [connects their own account](/ask-anything/connecting-your-data-warehouse-account) once.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.