leo-claude-mktplace/plugins/data-platform/commands/dbt-test.md

/dbt-test - Run dbt Tests

Execute dbt tests with formatted pass/fail results.

Usage

/dbt-test [selection] [--warn-only]

Workflow

1. Pre-validation (MANDATORY):

   • Use dbt_parse to validate project first
   • If validation fails, show errors and STOP

2. Execute tests:

   • Use dbt_test with provided selection
   • Capture all test results

3. Format results:

   • Group by test type (schema vs. data)
   • Show pass/fail status with counts
   • Display failure details

Report Format

=== dbt Test Results ===
Project: my_project
Selection: tag:critical

--- Summary ---
Total: 24 tests
PASS:  22 (92%)
FAIL:  1  (4%)
WARN:  1  (4%)
SKIP:  0  (0%)

--- Schema Tests (18) ---
[PASS] unique_dim_customers_customer_id
[PASS] not_null_dim_customers_customer_id
[PASS] not_null_dim_customers_email
[PASS] accepted_values_dim_customers_status
[FAIL] relationships_fct_orders_customer_id

--- Data Tests (6) ---
[PASS] assert_positive_order_amounts
[PASS] assert_valid_dates
[WARN] assert_recent_orders (threshold: 7 days)

--- Failure Details ---
Test: relationships_fct_orders_customer_id
Type: schema (relationships)
Model: fct_orders
Message: 15 records failed referential integrity check
Query: SELECT * FROM fct_orders WHERE customer_id NOT IN (SELECT customer_id FROM dim_customers)

--- Warning Details ---
Test: assert_recent_orders
Type: data
Message: No orders in last 7 days (expected for dev environment)
Severity: warn

Selection Syntax

Pattern	Meaning
(none)	Run all tests
model_name	Tests for specific model
+model_name	Tests for model and upstream
tag:critical	Tests with tag
test_type:schema	Only schema tests
test_type:data	Only data tests

Options

Flag	Description
--warn-only	Treat failures as warnings (don't fail CI)

Examples

/dbt-test                          # Run all tests
/dbt-test dim_customers            # Tests for specific model
/dbt-test tag:critical             # Run critical tests only
/dbt-test +fct_orders              # Test model and its upstream

Test Types

Schema Tests

Built-in tests defined in schema.yml:

• unique - No duplicate values
• not_null - No null values
• accepted_values - Value in allowed list
• relationships - Foreign key integrity

Data Tests

Custom SQL tests in tests/ directory:

• Return rows that fail the assertion
• Zero rows = pass, any rows = fail

Exit Codes

Code	Meaning
0	All tests passed
1	One or more tests failed
2	dbt error (parse failure, etc.)

Available Tools

Use these MCP tools:

• dbt_parse - Pre-validation (ALWAYS RUN FIRST)
• dbt_test - Execute tests (REQUIRED)
• dbt_build - Alternative: run + test together