> For the complete documentation index, see [llms.txt](https://docs.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.collibra.com/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-dataset-rules.md).

# Working with Dataset Rules

The Dataset Rules page lists all previously saved rules for a given dataset and provides an overview of their details, such as the definitions of SQL conditions, rule types, and whether or not rules pass validation checks. You can also take several quick actions from this page, such as accessing the Rule Workbench or deleting a rule from a dataset. The ability to manage rules from a single page can shorten the amount of time you spend assessing what is needed to meet your business requirements.

![a list of dataset rules](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-318ba11d480626a23f105c6cc6e954111883286d%2Fdq-dataset-rules-tab.png?alt=media)

## Opening Dataset Rules

The following steps show you how to open the list of applicable rules on your dataset.

1. Click the <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-66811829c5ae1400306b9eda1af44b03784aeb64%2Fwrench-icon.png?alt=media" alt="Rules wrench icon" data-size="line"> in the sidebar menu, then click **Rule Builder**.\ <i class="fa-chevrons-right">:chevrons-right:</i> The Dataset Rules page opens.
2. On the Dataset Rules page, enter the name of your dataset in the **Search for a Dataset** searchbar, then select it.\ <i class="fa-chevrons-right">:chevrons-right:</i> The Dataset Rules page displays any existing rules on your dataset.

## Viewing rule details

When one or more rules are available on the selected dataset, the table on the Dataset Rules page contains the following detailed information.

<table><thead><tr><th width="152">Column</th><th>Description</th></tr></thead><tbody><tr><td><strong>Rule Name</strong></td><td><p>The name of the rule.</p><p>Hover your cursor over the rule name and click <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-fa5db85d1fedb24e596acef061a9d093ca3ea006%2Fedit-large%402x.png?alt=media" alt="" data-size="line"> to edit the rule.</p></td></tr><tr><td><strong>Rule Query</strong></td><td>The SQL condition of the rule.</td></tr><tr><td><strong>Type</strong></td><td>The <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-types.md">type</a> of rule.</td></tr><tr><td><strong>Column</strong></td><td>The primary column that the rule queries.</td></tr><tr><td><strong>Repo</strong></td><td>The data class or template from which the rule is created. This only applies to custom rules, such as Data Type, Data Class, and Template.</td></tr><tr><td><strong>Valid</strong></td><td><p>Shows whether the rule passes rule validation.</p><p><img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-a6340a1957ecb4427cccc1145778c729c9f2b4b3%2Fvalid-rule-icon.png?alt=media" alt="valid rule icon" data-size="line"> shows that the rule passes validation.</p><p><img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-80058c0de58daefb58fb42e6c3d0b2b1c6628ba6%2Finvalid-rule-icon.png?alt=media" alt="invalid rule icon" data-size="line"> shows that the rule does not pass validation.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If you see <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-80058c0de58daefb58fb42e6c3d0b2b1c6628ba6%2Finvalid-rule-icon.png?alt=media" alt="invalid rule icon" data-size="line">, you can click it to view more details about why the rule does not pass validation.</p></div></td></tr><tr><td><strong>Active</strong></td><td><p>Shows whether the rule is active for future runs of the dataset. Click the icon to change the active status of the rule.</p><p><img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-a6340a1957ecb4427cccc1145778c729c9f2b4b3%2Fvalid-rule-icon.png?alt=media" alt="valid rule icon" data-size="line"> shows that the rule is active.</p><p><img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-2f51b744ffa11cd654927b30e2b507eacd7e7205%2Finactive-rule-icon.png?alt=media" alt="inactive rule icon" data-size="line"> shows that the rule is inactive.</p></td></tr><tr><td><strong>Scoring Type</strong></td><td>Shows whether the rule uses absolute- or percentage-based scoring. For more information about scoring types, go to <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/create-a-data-quality-rule.md">Create a data quality rule</a> and <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/understanding-the-rules-score.md">Understanding the rules score</a>.</td></tr><tr><td><strong>Tolerance</strong></td><td>Specifies the tolerance threshold as a percentage. For more information, go to <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/understanding-the-rules-score.md">Understanding the rules score</a>.</td></tr><tr><td><strong>Points</strong></td><td><p>The number of points that Collibra DQ deducts from the data quality score when data breaches the conditions of the rule. You can set this value on the Rule Details modal of the Rule Workbench. For more information, go to <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/understanding-the-rules-score.md">Understanding the rules score</a>.</p><p>If you do not customize this value, then Collibra DQ uses the default value of 1.</p></td></tr><tr><td><strong>%</strong></td><td><p>The ratio of the total number of breaking records over the total number of rows. For more information, go to <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/understanding-the-rules-score.md">Understanding the rules score</a>.</p><p>If you do not customize this value on the Rule Details modal, then Collibra DQ uses the default value of 1.</p></td></tr><tr><td><strong>Category</strong></td><td>The data category that you optionally define on the Workbench.</td></tr><tr><td><strong>Dimension</strong></td><td><p>The DQ Dimension that you optionally assign to the rule on the Workbench.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Tagging rules with custom dimensions in the Metastore is not supported.</p></div></td></tr><tr><td><strong>Timeout Limit</strong></td><td><p>The number of minutes that any active rule can take to process before it times out and the tool automatically cancels the job. This limit is useful for keeping problematic rules from consuming too many resources.</p><p>The maximum timeout limit is determined by the greatest Timeout Limit value of any active rule displayed on the table under the Rules tab.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p>If there are 3 active rules associated with a dataset, where Rule 1 has a timeout limit of 20 minutes, Rule 2 has a limit of 30 minutes, and Rule 3 has a limit of 60 minutes, then the dataset has 60 minutes per rule to process. If Rule 3 is inactive, the maximum timeout limit for the dataset is 30 minutes, because Rule 2 has the next highest maximum limit of any active rule.</p></div></div><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>You can increase this value for an individual rule from Rule Details on the Rule Workbench.</p></div></td></tr><tr><td><strong>Actions</strong></td><td><p>Click <strong>Actions</strong> to edit, delete, rename, and view the history of the rule.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><ul><li>After a rule is renamed, its new name is automatically reflected across all relevant pages in Data Quality &#x26; Observability (self-hosted).</li><li>Updated rule names cannot match the name of an existing rule and must contain only alphanumeric characters without spaces.</li><li>When you rename a rule from the Dataset Rules page and an <a href="/data-quality-self-hosted/integrations/about-collibra-dq-integrations.md">API integration</a> with Collibra Platform is enabled, the rule reuses the Collibra Platform asset IDs associated with the previous rule name when its metadata is integrated.</li></ul></div><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p>When you rename a rule, all associated rule output records and rule break records on the Findings page, as well as exports stored in the Metastore, are renamed. To retain the history with the original rule name, create a new rule and deactivate the original one.</p></div><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>If the Save option is disabled while editing a rule, you must populate the <strong>DQ Dimension</strong> field in the <a href="/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/create-a-data-quality-rule.md">Rule Details modal</a>.</p></div></td></tr></tbody></table>

## Adding new rules

Click **Add Rule** to [create new rules](/data-quality-self-hosted/core-concepts/dq-rules/rule-builder/working-with-the-rule-workbench/create-a-data-quality-rule.md) to run against your dataset.
