how-to-guides

No menu items for this category

Adding Test Suites Through the UI

Test Suites are logical container allowing you to group related Test Cases together from different tables. This is a great way to group related test cases together and set a single alert for test case failure.
Note: you will need to make sure you have the right permission in OpenMetadata to create a test.

From the vertical navigation bar, click on Quality and navigate to the By Test Suites tab. From there click on Add Test Suite button on the top right corner.

Write your first test

Write your first test

On the next page, enter the name and description (optional) of your test suite.

Create test suite

Create test suite

On the next page, you will be able to add existing test cases from different entity to your test suite. This allows you to group together test cases from different entities

Note: Test Case name needs to be unique across the whole platform. A warning message will show if your Test Case name is not unique.

Create test case

Create test case

When creating a JSON config for a test workflow the source configuration is very simple.

The only sections you need to modify here are the serviceName (this name needs to be unique) and entityFullyQualifiedName (the entity for which we'll be executing tests against) keys.

Once you have defined your source configuration you'll need to define te processor configuration.

The processor type should be set to "orm-test-runner". For accepted test definition names and parameter value names refer to the tests page.

You can keep your YAML config as simple as follows if the table already has tests.

  • forceUpdate: if the test case exists (base on the test case name) for the entity, implements the strategy to follow when running the test (i.e. whether or not to update parameters)
  • testCases: list of test cases to add to the entity referenced. Note that we will execute all the tests present in the Table.
  • name: test case name
  • testDefinitionName: test definition
  • columnName: only applies to column test. The name of the column to run the test against
  • parameterValues: parameter values of the test

The sink and workflowConfig will have the same settings as the ingestion and profiler workflow.

To run the tests from the CLI execute the following command