Skip to content

better data diff docs in crash course #4437

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 20, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs/examples/sqlmesh_cli_crash_course.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,8 +161,12 @@ Note: If you run this without making any changes, SQLMesh will prompt you to mak

### Run Data Diff Against Prod

<div style="position: relative; padding-bottom: 56.25%; height: 0;"><iframe src="https://www.loom.com/embed/a3c8beffe46840f38487180f401f0a1c?sid=941a7283-38c8-4527-b5b9-49e68c5b9f0c" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

Run data diff against prod. This is a good way to verify the changes are behaving as expected **after** applying them to `dev`.

To make this easier and faster, you can run data diff against all models in the environment impacted by plan changes applied using the `-m '*'` flag example below. No need to specify the model name! Read more about options [here](../guides/tablediff.md).

=== "SQLMesh"

```bash
Expand All @@ -173,6 +177,10 @@ Run data diff against prod. This is a good way to verify the changes are behavin
sqlmesh table_diff <environment>:<environment> <model_name> --show-sample
```

```bash
sqlmesh table_diff prod:dev -m '*' --show-sample
```

=== "Tobiko Cloud"

```bash
Expand All @@ -183,6 +191,10 @@ Run data diff against prod. This is a good way to verify the changes are behavin
tcloud sqlmesh table_diff <environment>:<environment> <model_name> --show-sample
```

```bash
tcloud sqlmesh table_diff prod:dev -m '*' --show-sample
```

??? "Example Output"
I compare the `prod` and `dev` environments for `sqlmesh_example.full_model`.

Expand Down