Documentation Index

Fetch the complete documentation index at: https://docs.validatar.com/llms.txt

Use this file to discover all available pages before exploring further.

VW_DATASET_TESTS

Prev Next

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)