Update data-tests.md (#6961)

dbt-labs · Mar 3, 2025 · 56794f7 · 56794f7
2 parents cbca2eb + 4825c20
commit 56794f7
Showing 1 changed file with 24 additions and 19 deletions.
diff --git a/website/docs/reference/resource-properties/data-tests.md b/website/docs/reference/resource-properties/data-tests.md
@@ -28,16 +28,16 @@ version: 2
 models:
   - name: <model_name>
     tests:
-      - [<test_name>](#test_name):
+      - [<test_name>](#custom-data-test-name):
           <argument_name>: <argument_value>
           [config](/reference/resource-properties/config):
             [<test_config>](/reference/data-test-configs): <config-value>
 
     [columns](/reference/resource-properties/columns):
       - name: <column_name>
         tests:
-          - [<test_name>](#test_name)
-          - [<test_name>](#test_name):
+          - [<test_name>](#custom-data-test-name)
+          - [<test_name>](#custom-data-test-name):
               <argument_name>: <argument_value>
               [config](/reference/resource-properties/config):
                 [<test_config>](/reference/data-test-configs): <config-value>
@@ -59,17 +59,17 @@ sources:
     tables:
     - name: <table_name>
       tests:
-        - [<test_name>](#test_name)
-        - [<test_name>](#test_name):
+        - [<test_name>](#custom-data-test-name)
+        - [<test_name>](#custom-data-test-name):
             <argument_name>: <argument_value>
             [config](/reference/resource-properties/config):
               [<test_config>](/reference/data-test-configs): <config-value>
 
       columns:
         - name: <column_name>
           tests:
-            - [<test_name>](#test_name)
-            - [<test_name>](#test_name):
+            - [<test_name>](#custom-data-test-name)
+            - [<test_name>](#custom-data-test-name):
                 <argument_name>: <argument_value>
                 [config](/reference/resource-properties/config):
                   [<test_config>](/reference/data-test-configs): <config-value>
@@ -90,17 +90,17 @@ version: 2
 seeds:
   - name: <seed_name>
     tests:
-      - [<test_name>](#test_name)
-      - [<test_name>](#test_name):
+      - [<test_name>](#custom-data-test-name)
+      - [<test_name>](#custom-data-test-name):
           <argument_name>: <argument_value>
           [config](/reference/resource-properties/config):
             [<test_config>](/reference/data-test-configs): <config-value>
 
     columns:
       - name: <column_name>
         tests:
-          - [<test_name>](#test_name)
-          - [<test_name>](#test_name):
+          - [<test_name>](#custom-data-test-name)
+          - [<test_name>](#custom-data-test-name):
               <argument_name>: <argument_value>
               [config](/reference/resource-properties/config):
                 [<test_config>](/reference/data-test-configs): <config-value>
@@ -121,17 +121,17 @@ version: 2
 snapshots:
   - name: <snapshot_name>
     tests:
-      - [<test_name>](#test_name)
-      - [<test_name>](#test_name):
+      - [<test_name>](#custom-data-test-name)
+      - [<test_name>](#custom-data-test-name):
           <argument_name>: <argument_value>
           [config](/reference/resource-properties/config):
             [<test_config>](/reference/data-test-configs): <config-value>
 
     columns:
       - name: <column_name>
         tests:
-          - [<test_name>](#test_name)
-          - [<test_name>](#test_name):
+          - [<test_name>](#custom-data-test-name)
+          - [<test_name>](#custom-data-test-name):
               <argument_name>: <argument_value>
               [config](/reference/resource-properties/config):
                 [<test_config>](/reference/data-test-configs): <config-value>
@@ -267,18 +267,23 @@ Some data tests require multiple columns, so it doesn't make sense to nest them
 
 <File name='models/orders.yml'>
 
-```yml
+```yaml
 version: 2
 
 models:
   - name: orders
+    description: 
+        Order overview data mart, offering key details for each order including if it's a customer's first order and a food vs. drink item breakdown. One row per order.
     tests:
-      - unique:
-          column_name: "country_code || '-' || order_id"
+      - dbt_utils.expression_is_true:
+          expression: "order_items_subtotal = subtotal"
+      - dbt_utils.expression_is_true:
+          expression: "order_total = subtotal + tax_paid"
 ```
-
 </File>
 
+This example focuses on testing expressions to ensure that `order_items_subtotal` equals `subtotal` and `order_total` correctly sums `subtotal` and `tax_paid`.
+
 ### Use custom generic test
 
 If you've defined your own custom generic test, you can use that as the `test_name`: