Start Free with Recce Cloud

Launch Recce in under 2 minutes. Each following feature provides additional value. The progressive features help you get more value from Recce over time.

👉 Start Free →

Model Changes and Impact Analysis

Recce shows what changed between base and current environments and helps assess potential impact. The most common case is comparing your development branch against your production or main branch to see what your changes will impact.

You can:

Explore with the pre-loaded Jaffle Shop data
Upload your metadata (see below)
Skip manual upload go directly to CI/CD automation

Upload Metadata

Web interface: Click "Update" on the session you want to update in Recce Cloud.
1. Click "Update" in base session to upload baseline metadata
2. Click "Update" in current session to upload comparison metadata
3. Click "Launch" to compare current against base
CLI command:
```
recce upload-session --session-id <your_session_id>
```
Find your session ID in Recce Cloud web interface when clicking "Update" on any session.

Required Files

Recce needs manifest.json and catalog.json from both base and current environments for comparison.

Base Metadata

Production environment is commonly used as the baseline, but any environment can serve as the base.

Choose one method:

Method 1: Generate locally

dbt docs generate --target-path target-base --target <your_prod_target>

Method 2: dbt Cloud
Deploy → Jobs → Production job → Recent run → Download artifacts

Method 3: dbt Docs server
Download the artifacts directly from dbt docs server:

<dbt_docs_url>/manifest.json
<dbt_docs_url>/catalog.json

Current Metadata

Use development environment or PR branch as current to compare against the base.

Choose one method:

Method 1: Generate locally

dbt docs generate --target <your_dev_target>

Method 2: dbt Cloud
Deploy → Jobs → CI job → Recent run → Download artifacts

Data Warehouse Diffing

Go beyond metadata to see how changes affect your actual data. Configure your data warehouse connection to compare query results and catch issues before they impact production.

Setup Requirements

Data warehouse credentials with read access
Network connectivity to your warehouse
Base and current environments configured in previous step

Supported Warehouses

Snowflake
others are on upcoming future

Warehouse Connection

Configure connection to your data warehouse to enable query result comparisons.

Connection setup:

Navigate to settings
Add Connection

Your connection credentials are secure. See our security practices for details.

How to Use Data Diffing

Recce supports several data diffing methods. See Data Diffing sections for details:

GitHub Integration

Connect your GitHub repo to see all PRs in one place and validate changes before they hit production.

Setup Requirements

GitHub repository with dbt project
Repository admin access for initial setup
Active PRs with model changes

Note

You'll need administrative access to the GitHub organization you want to connect. Please ensure you have the necessary permissions for GitHub App installations.

GitHub Connection

Connect your repository to track pull requests and validate changes.

Connection setup:

Navigate to settings
Connect GitHub repository
Authorize Recce access
Select repository

How to Use PR Tracking

Once connected, Recce displays all open and draft PRs in your dashboard.

PR Validation Workflow

View open/draft PRs in dashboard
Select PR to validate
Upload PR metadata (until CI/CD is configured)
Launch Recce to analyze changes

CI/CD Automation

Set up CI/CD to automatically upload metadata and run validation checks on every PR.

Note

Available with Team plan (free trial included).

Setup Requirements

See the CI/CD sections for complete setup guides:

Setup CD
Setup CI
GitHub integration configured
Team plan subscription or free trial

Automation Benefits

Automatic metadata upload on every PR
Consistent validation across all PRs
Reduced manual setup steps
Integrated PR status checks
Validation results directly in PR