Overview
VW_DATASET_TESTS provides a comprehensive view of all test definitions in your Validatar environment — standard tests, template tests, and materialized tests. Each row represents one test version and includes its configuration, metadata links, folder hierarchy, overall result status, and quality classification.
Use this view for test inventory reporting, coverage analysis, and understanding which metadata objects are covered by which tests.
Schema
Test Identity
| Column |
Type |
Description |
| TEST_NAME |
VARCHAR |
Name of the test |
| TEST_DESCRIPTION |
VARCHAR |
Test description |
| TEST_ID |
NUMBER |
Unique test identifier |
| TEST_VERSION_ID |
NUMBER |
Unique identifier for this specific version |
| VERSION_NUMBER |
NUMBER |
Sequential version number |
| IS_ACTIVE_VERSION |
BOOLEAN |
Whether this is the current active version |
| VERSION_URL |
VARCHAR |
Relative URL path to this test version in the Validatar UI |
Test Classification
| Column |
Type |
Description |
| TEST_TYPE |
VARCHAR |
"Standard", "Template", "Materialized", or "Materialized then Customized" |
| TEST_TYPE_ID |
NUMBER |
Numeric test type code |
| QUALITY_DIMENSION |
VARCHAR |
Quality dimension (e.g., "Accuracy", "Completeness", "Consistency") |
| SEVERITY_LEVEL |
VARCHAR |
Severity level (e.g., "Critical", "High", "Medium", "Low") |
| CUSTOMIZED_FLAG |
BOOLEAN |
Whether a materialized test has been customized after generation |
Project and Folder
| Column |
Type |
Description |
| PROJECT_ID |
NUMBER |
ID of the containing project |
| PROJECT_NAME |
VARCHAR |
Name of the project |
| FOLDER_ID |
NUMBER |
ID of the test's folder |
| FOLDER_NAME |
VARCHAR |
Name of the immediate folder |
| FOLDER_PATH |
VARCHAR |
Full folder hierarchy path (e.g., "Project Root / Subfolder / Tests") |
Data Source Links
| Column |
Type |
Description |
| TEST_DATA_SOURCE |
VARCHAR |
Name of the test (left/source) data source |
| TEST_DATA_SOURCE_ID |
NUMBER |
ID of the test data source |
| TEST_DATA_TYPE |
VARCHAR |
Data set type for the test side |
| CONTROL_DATA_SOURCE |
VARCHAR |
Name of the control (right/target) data source |
| CONTROL_DATA_SOURCE_ID |
NUMBER |
ID of the control data source |
| CONTROL_DATA_TYPE |
VARCHAR |
Data set type for the control side |
Metadata Links
| Column |
Type |
Description |
| TEST_PRIMARY_METADATA_LINK_OBJECT |
VARCHAR |
Full path of the linked metadata object (e.g., "schema.table.column") |
| TEST_PRIMARY_METADATA_LINK_OBJECT_KEY |
VARCHAR |
Object key for joining (e.g., "t.123" or "c.456") |
| TEST_PRIMARY_METADATA_LINK_URL |
VARCHAR |
Relative URL to the linked metadata object in the Explorer |
| CONTROL_PRIMARY_METADATA_LINK_OBJECT |
VARCHAR |
Full path of the control-side linked object |
| CONTROL_PRIMARY_METADATA_LINK_OBJECT_KEY |
VARCHAR |
Control-side object key |
| CONTROL_PRIMARY_METADATA_LINK_URL |
VARCHAR |
Relative URL to the control-side object |
Audit Fields
| Column |
Type |
Description |
| DATE_CREATED |
TIMESTAMP |
When the test was created |
| DATE_MODIFIED |
TIMESTAMP |
When this version was last modified |
| CREATED_BY |
VARCHAR |
Full name of the creator |
| MODIFIED_BY |
VARCHAR |
Full name of the last modifier |
Overall Result Status
| Column |
Type |
Description |
| OVERALL_RESULT_STATUS_ID |
NUMBER |
Numeric status code |
| OVERALL_RESULT_STATUS |
VARCHAR |
"Passed", "Failed", "Error", or NULL (never executed) |
| MOST_RECENT_PASSED_DATE |
TIMESTAMP |
Last time this test passed |
| MOST_RECENT_FAILED_DATE |
TIMESTAMP |
Last time this test failed |
| MOST_RECENT_ERROR_DATE |
TIMESTAMP |
Last time this test errored |
| PASSED_COUNT |
NUMBER |
Total passed execution count |
| FAILED_COUNT |
NUMBER |
Total failed execution count |
| ERROR_COUNT |
NUMBER |
Total error execution count |
| STATUS_TRACKING_START_DATE |
TIMESTAMP |
When status tracking began for this test |
Relationships
VW_DATASET_TESTS
│
├── TEST_ID → VW_DATASET_TEST_EXECUTIONS.TEST_ID (one-to-many)
├── TEST_PRIMARY_METADATA_LINK_OBJECT_KEY → VW_DATASET_TABLES.TABLE_KEY
├── TEST_PRIMARY_METADATA_LINK_OBJECT_KEY → VW_DATASET_COLUMNS.COLUMN_KEY
├── TEST_PRIMARY_METADATA_LINK_OBJECT_KEY → VW_DATASET_METADATA_OBJECTS.OBJECT_KEY
├── PROJECT_ID → VW_DATASET_JOBS.PROJECT_ID
└── TEST_DATA_SOURCE_ID → VW_DATASET_TABLES.DATA_SOURCE_ID
Example Queries
List All Failing Tests by Quality Dimension
SELECT
QUALITY_DIMENSION,
SEVERITY_LEVEL,
TEST_NAME,
PROJECT_NAME,
FOLDER_PATH,
TEST_PRIMARY_METADATA_LINK_OBJECT,
MOST_RECENT_FAILED_DATE
FROM REPOSITORY.VW_DATASET_TESTS
WHERE OVERALL_RESULT_STATUS = 'Failed'
AND IS_ACTIVE_VERSION = TRUE
ORDER BY
CASE SEVERITY_LEVEL
WHEN 'Critical' THEN 1
WHEN 'High' THEN 2
WHEN 'Medium' THEN 3
WHEN 'Low' THEN 4
END,
QUALITY_DIMENSION;
Tests Linked to a Specific Table
SELECT
TEST_NAME,
TEST_TYPE,
QUALITY_DIMENSION,
OVERALL_RESULT_STATUS,
SEVERITY_LEVEL
FROM REPOSITORY.VW_DATASET_TESTS
WHERE TEST_PRIMARY_METADATA_LINK_OBJECT LIKE 'PUBLIC.DIM_CUSTOMER%'
AND IS_ACTIVE_VERSION = TRUE
ORDER BY TEST_NAME;
Test Count by Type and Project
SELECT
PROJECT_NAME,
TEST_TYPE,
COUNT(*) AS TEST_COUNT,
SUM(CASE WHEN OVERALL_RESULT_STATUS = 'Passed' THEN 1 ELSE 0 END) AS PASSING,
SUM(CASE WHEN OVERALL_RESULT_STATUS = 'Failed' THEN 1 ELSE 0 END) AS FAILING
FROM REPOSITORY.VW_DATASET_TESTS
WHERE IS_ACTIVE_VERSION = TRUE
GROUP BY PROJECT_NAME, TEST_TYPE
ORDER BY PROJECT_NAME, TEST_TYPE;
Coverage Gap: Tables with No Tests
SELECT
t.DATA_SOURCE_NAME,
t.FULL_PATH,
t.TRUST_SCORE,
t.COVERAGE_SCORE
FROM REPOSITORY.VW_DATASET_TABLES t
LEFT JOIN REPOSITORY.VW_DATASET_TESTS tst
ON tst.TEST_PRIMARY_METADATA_LINK_OBJECT_KEY = t.TABLE_KEY
AND tst.IS_ACTIVE_VERSION = TRUE
WHERE tst.TEST_ID IS NULL
ORDER BY t.DATA_SOURCE_NAME, t.FULL_PATH;
VW_DATASET_TEST_PROPERTIES — Extended Property Details
The companion view VW_DATASET_TEST_PROPERTIES provides a vertical (one-row-per-property) representation of detailed test attributes that don't fit cleanly into the flat VW_DATASET_TESTS structure. Each row contains a property name/value pair for a specific test version.
Schema
| Column |
Type |
Description |
| TEST_NAME |
VARCHAR |
Test name |
| PROJECT_ID |
NUMBER |
Project ID |
| PROJECT_NAME |
VARCHAR |
Project name |
| FOLDER_ID |
NUMBER |
Folder ID |
| FOLDER_NAME |
VARCHAR |
Folder name |
| FOLDER_PATH |
VARCHAR |
Full folder path |
| TEST_ID |
NUMBER |
Test ID |
| TEST_TYPE |
VARCHAR |
"Standard", "Template", "Materialized", or "Materialized then Customized" |
| TEST_VERSION_ID |
NUMBER |
Test version ID |
| VERSION_NUMBER |
NUMBER |
Version number |
| VERSION_URL |
VARCHAR |
Relative URL to this version |
| IS_ACTIVE_VERSION |
BOOLEAN |
Whether this is the current active version |
| PROPERTY_CATEGORY |
VARCHAR |
Category grouping (see below) |
| PROPERTY_NAME |
VARCHAR |
Specific property name |
| PROPERTY_NAME_INDEX |
NUMBER |
Sequence/ordering within the property (NULL for single-value properties) |
| PROPERTY_VALUE_TYPE |
VARCHAR |
Data type hint: "String Value", "Numeric Value", "Yes/No", "Step", "Schedule" |
| PROPERTY_VALUE |
VARCHAR |
The property value (always stored as string) |
| DATE_MODIFIED |
TIMESTAMP |
When this property was last changed |
| MODIFIED_BY |
VARCHAR |
Who modified it |
Property Categories
| PROPERTY_CATEGORY |
PROPERTY_NAME Values |
Description |
| Custom Metadata |
(user-defined custom field names) |
Custom field values assigned to the test. Value types include String, Numeric, Dropdown, TagList, and UserGroupList. |
| Discussion Comment |
Discussion Comment |
Comments posted on the test's discussion thread |
| Linked Metadata Object |
Linked Table - Test, Linked Table - Control, Linked Column - Test, Linked Column - Control |
Schema.Table or Schema.Table.Column objects linked to the test's data sets |
| Test Configuration Setting |
Record Success Criteria - Type |
Success condition type (e.g., "Exact Match", "Percent Tolerance", "Value Tolerance", "Custom Calculation") |
|
Record Success Criteria - Percent Tolerance / Value Tolerance / Custom Calculation |
The tolerance value or custom calculation expression |
|
Overall Success Criteria - Type |
Overall success condition type |
|
Overall Success Criteria - Percent Tolerance / Value Tolerance / Custom Calculation |
The overall tolerance value |
|
Results Are Ordered |
"Yes", "No", or "Variable" (template) |
|
Only Keep Failures |
"Yes", "No", or "Variable" (template) |
|
Abort After Failures |
"Yes" or "No" |
|
Abort After Failures Count |
Numeric threshold |
|
Purge Results After Days |
"Yes" or "No" |
|
Purge Results After Days Count |
Number of days |
|
Abort After Rows |
"Yes" or "No" |
|
Abort After Rows Count |
Numeric row threshold |
| Overall Status |
Overall Status |
Current overall result status (e.g., "Passed", "Failed", "Error", "N/A") |
| Standard Field |
Quality Dimension |
The quality dimension assigned to the test |
|
Severity Level |
The severity level assigned to the test |
Joining Tests to Properties
Use TEST_ID as the join key. Filter to IS_ACTIVE_VERSION = TRUE for current properties.
Example: Failing Tests with a Specific Custom Field Value
Find tests in a failing state that have a custom field named "Test Tag" set to "Prioritized by Sales Team":
SELECT
t.TEST_NAME,
t.PROJECT_NAME,
t.FOLDER_PATH,
t.OVERALL_RESULT_STATUS,
p.PROPERTY_VALUE AS TEST_TAG_VALUE
FROM REPOSITORY.VW_DATASET_TESTS t
INNER JOIN REPOSITORY.VW_DATASET_TEST_PROPERTIES p
ON p.TEST_ID = t.TEST_ID
AND p.IS_ACTIVE_VERSION = TRUE
WHERE t.IS_ACTIVE_VERSION = TRUE
AND t.OVERALL_RESULT_STATUS = 'Failed'
AND p.PROPERTY_CATEGORY = 'Custom Metadata'
AND p.PROPERTY_NAME = 'Test Tag'
AND p.PROPERTY_VALUE = 'Prioritized by Sales Team'
ORDER BY t.PROJECT_NAME, t.FOLDER_PATH;
Example: Tests Using Custom Calculation Success Criteria
SELECT
t.TEST_NAME,
t.PROJECT_NAME,
p.PROPERTY_VALUE AS CALCULATION_EXPRESSION
FROM REPOSITORY.VW_DATASET_TESTS t
INNER JOIN REPOSITORY.VW_DATASET_TEST_PROPERTIES p
ON p.TEST_ID = t.TEST_ID
AND p.IS_ACTIVE_VERSION = TRUE
WHERE t.IS_ACTIVE_VERSION = TRUE
AND p.PROPERTY_CATEGORY = 'Test Configuration Setting'
AND p.PROPERTY_NAME = 'Record Success Criteria - Custom Calculation'
ORDER BY t.PROJECT_NAME, t.TEST_NAME;
Example: Tests Where Someone Mentioned "regression" in a Comment
SELECT DISTINCT
t.TEST_NAME,
t.PROJECT_NAME,
p.PROPERTY_VALUE AS COMMENT_TEXT,
p.MODIFIED_BY,
p.DATE_MODIFIED
FROM REPOSITORY.VW_DATASET_TESTS t
INNER JOIN REPOSITORY.VW_DATASET_TEST_PROPERTIES p
ON p.TEST_ID = t.TEST_ID
WHERE t.IS_ACTIVE_VERSION = TRUE
AND p.PROPERTY_CATEGORY = 'Discussion Comment'
AND LOWER(p.PROPERTY_VALUE) LIKE '%regression%'
ORDER BY p.DATE_MODIFIED DESC;
Example: Tests Linked to a Specific Table
SELECT
t.TEST_NAME,
t.PROJECT_NAME,
p.PROPERTY_NAME AS LINK_TYPE,
p.PROPERTY_VALUE AS LINKED_OBJECT
FROM REPOSITORY.VW_DATASET_TESTS t
INNER JOIN REPOSITORY.VW_DATASET_TEST_PROPERTIES p
ON p.TEST_ID = t.TEST_ID
AND p.IS_ACTIVE_VERSION = TRUE
WHERE t.IS_ACTIVE_VERSION = TRUE
AND p.PROPERTY_CATEGORY = 'Linked Metadata Object'
AND p.PROPERTY_VALUE LIKE '%CUSTOMER%'
ORDER BY t.PROJECT_NAME, t.TEST_NAME;
Secure View
VW_SECURE_DATASET_TEST_PROPERTIES adds USER_ID and ACCESS_TYPE columns, filtered by project membership (same security tier as VW_SECURE_DATASET_TESTS).
Databricks Notes
- The
CASE expression for severity ordering works identically in both engines
LIKE pattern matching is the same syntax
- Template tests have NULL values for overall result status columns (they don't execute directly — their materialized children do)