> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/fabricate/data-masking/masking-complete/masking-configuration.md).

# Reviewing and adjusting the masking configuration

After it runs the privacy reviews, Fabricate creates the masking workflow.

For a masking workflow, the workflow details include Masking view. Masking view contains the masking configuration, which lists the data columns and how they are treated when you execute the workflow.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2Fz47h1Mb245JCKHZ2QmDn%2FDatabase_MaskingWorkflowInitial.png?alt=media&amp;token=498c4cea-7b91-457d-8a17-0608eb8ae0ba" alt=""><figcaption><p>Masking view for a masking workflow</p></figcaption></figure>

## Information on Masking view

Masking view displays the list of tables and columns in the source database.

For each table, Masking view displays:

* The number of columns that are masked.
* The number of columns that are not masked
* The number of columns that are excluded. A column is only excluded based on a user prompt.

For each column, Masking view initially displays:

* Column name.
* Column treatment. Whether the column is masked, unmasked, or excluded.\
  \
  For masked columns, the treatment displays the strategy used for the masking. This might be the name of a built-in generator, or a custom replacement determined by a prompt to the Data Agent.\
  \
  For columns that are not masked, the treatment is `copied`.\
  \
  For columns that are excluded from the output, the treatment is `excluded`.

Below the table and column list, Masking view displays a summary of the masking for the entire database:

* Number of tables.
* Total number of columns in the tables.
* Number of masked columns.
* Number of excluded columns.
* When the masking configuration was most recently updated.

## Displaying the masking details for columns

To display the masking details for a column, expand the column entry.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2F6LsJnm682dGYbcaD30kY%2FDatabase_MaskingWorkflowColumnDetails.png?alt=media&amp;token=aeb83182-e2cf-4135-bca2-c19ac2980357" alt=""><figcaption><p>Column details on the workflow Masking view</p></figcaption></figure>

To display the masking details for all of the columns, click the expand all icon.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FoCyZygA0oXEZ4ki99N87%2FDatabase_MaskingWorkflowExpandAll.png?alt=media&amp;token=981ecbca-4910-4dc9-88fd-a1d3a51e48db" alt=""><figcaption><p>Expand all icon to expand all of the columns</p></figcaption></figure>

The masking details include:

* A summary of the masking, or the reason why the column is not masked.
* Whether the column treatment was determined by the Data Agent or was set by a user prompt.
* For masked columns, the generator configuration.

## Displaying the configuration history for a column

Within the column masking details, the **History** section contains the history of the masking configuration.

By default the history is collapsed. To display the history, expand the section.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FCWn8YFtBIHGF9xOlPClm%2FDatabase_MaskingWorkflowColumnHistory.png?alt=media&amp;token=4b4e3a82-d579-466c-8000-92a42738bfd0" alt=""><figcaption><p>Column history for a column on the workflow Masking view</p></figcaption></figure>

The history entries are displayed with the most recent update first. Each entry includes the following information:

* How the update was made. Indicates whether the update was applied directly by the Data Agent, resulted from the second opinion review, or was set by a user prompt.
* When the update occurred.
* A summary of the update.

## Filtering Masking view

You can filter the masking configuration based on:

* Table or column name.
* The column treatment.
* Whether the column configuration was determined by the Data Agent or by a user.

### Filtering by table or column name

To filter the displayed columns by the name of the table or column, in the search field, type text from the table or column name.

As you type, Fabricate updates the display to only include the matching tables and columns.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FnAHdBeNk8dvZiRfVl04U%2FDatabase_MaskingWorkflowNameFilter.png?alt=media&amp;token=190ac055-162e-4efc-84f1-1ac7aeb0add2" alt=""><figcaption><p>Filtering the masking configuration by table or column name</p></figcaption></figure>

### Filtering by column masking status

To filter the displayed columns based on the masking status:

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FWEZtwYfj5fFyQRSn6eP2%2FDatabase_MaskingWorkflowConfigFilter.png?alt=media&amp;token=4056b3fc-5be9-479e-b512-c9b25e583e07" alt=""><figcaption><p>Filter panel for the masking configuration</p></figcaption></figure>

1. Click **Filter**.
2. On the filter panel, under **Treatment**, check the checkbox for each treatment to include.

### Filtering by how the treatment was determined

You can filter the the displayed columns based on how the treatment was determined:

1. Click **Filter**.
2. On the filter panel, under **Decided by**, the default option is **Anyone**, which indicates to not filter the columns based on who decided the configuration.
3. To only include columns where the Data Agent automatically decided the configuration, click **Agent**.
4. To only include columns where a user prompted the Data Agent to change the configuration, click **Person**.

## Changing the masking configuration

To make changes to the masking configuration, you prompt the Data Agent.

You can change the configuration for individual columns or for entire tables. You can also adjust the amount of output data to produce either a subset of the original data or a scaled-up set of data.

When you change the masking configuration for a column, Fabricate indicates that a person changed the configuration. Fabricate also if needed updates the workflow code.

Here are some examples of prompts to change the masking configuration:

<table><thead><tr><th valign="top">Configuration change</th><th valign="top">Example prompts</th></tr></thead><tbody><tr><td valign="top">Don't mask a specific column</td><td valign="top"><code>Remove the masking from the name column.</code></td></tr><tr><td valign="top">Select a different masking generator</td><td valign="top"><code>Change the name column to use the scramble generator instead of the person_name generator.</code></td></tr><tr><td valign="top">Add masking to an unchanged column</td><td valign="top"><code>Mask column2 with the null generator.</code></td></tr><tr><td valign="top">Provide configuration instructions for the output values</td><td valign="top"><p><code>Use the constant generator for column1 and set the value to masked.</code></p><p></p><p><code>In the sales_date column, shift half the dates 2 days into the future, and the other half 1 day into the past.</code></p><p></p><p><code>For the name column, make sure that 10% of the names are of French origin, and another 10% are of Spanish origin.</code></p><p></p><p><code>For the address column, 30% of the addresses should be from Canada, and the rest from the United States.</code></p></td></tr><tr><td valign="top">Provide instructions for an entire table</td><td valign="top"><code>Do not include the legacy table in the output.</code></td></tr><tr><td valign="top">Generate masked output that represents a subset of the source data</td><td valign="top"><p><code>Generate output data that only includes source data rows from the transactions table where the shipping address was in New York or California. Include all of the related records for those rows.</code></p><p></p><p><code>Generate output data that includes a random 5% of the source data rows from the transactions table. Include all of the related records for those rows.</code></p></td></tr><tr><td valign="top">Scale up the amount of data</td><td valign="top"><code>Generate output data that adds another 500 transaction records.</code></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tonic.ai/fabricate/data-masking/masking-complete/masking-configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
