How to create and manage governance domains

Note

The Microsoft Purview Data Catalog is changing its name to Microsoft Purview Unified Catalog. All the features will stay the same. You'll see the name change when the new Microsoft Purview Data Governance experience is generally available in your region. Check the name in your region.

Ownership of data is an important aspect of data governance. However, today data is maintained and supported by IT infrastructure that doesn't always have the full context for how data can and should be used in an organization. Enter governance domains that brings users and data together with a data-use driven structure.

This article covers how to create and manage governance domains in Microsoft Purview. For more information about governance domains in general, see our governance domains concept page.

Prerequisites

Access governance domains

To see governance domains, a user needs data catalog reader role.

  1. In the Microsoft Purview portal, open the data catalog and select the Catalog management drop-down.
  2. Select Governance domains.
  3. Here you'll see a list of all the governance domains in your organization.
  4. You can filter the governance domains by keyword.
  5. Select a governance domain to see its details, roles, aggregate data quality score, health actions, associated data products, glossary terms, OKRs, and critical data.

Screenshot of the governance domains page in the Microsoft Purview portal.

Note

Custom attributes (Preview) allow you to add your own attributes to business concepts to further describe them. Be aware that the current preview experience is evolving. We recommend deleting any existing ones and avoid creating new ones until the new version is released by December 2024.

Roles

To edit the users, groups, or service principals assigned to a role:

  1. In the Microsoft Purview portal, open the data catalog, select Governance domains, and select the governance domain you want to edit the roles in.

  2. Select the + add button next to the role name.

    Screenshot of the governance domains roles page with the edit button highlighted.

  3. Search for users, groups, or service principals to add to the role and select them.

  4. To remove users from the list, select the X next to their name.

  5. Save your changes by selecting Save when you're finished.

    Screenshot of the governance domains roles edit page with the search, x, and save buttons highlighted.

For more information about the roles assigned at the governance domain level, see our permissions documentation.

View your business concepts

Your governance domain has many business concepts associated with it: data products, glossary terms, OKRs, and critical data. You can find and view each of these concepts in your governance domain.

In this example, we'll look at data products:

  1. In the Microsoft Purview portal, open the data catalog and select the Catalog management drop-down.

  2. Select Governance domains.

  3. Select one of your governance domains.

  4. On your governance domain's detail page, scroll down to the Business concepts section. Here you can see your data products, glossary terms, OKRs, and critical data. Select one to view it.

  5. For example, to view your data products, select the Data products card to see all associated data products.

    Screenshot of a governance domain's details page, with the data products card highlighted

To add any of these concepts to your governance domain, see their individual documentation:

Create governance domains

Note

To create a governance domain you need the governance domain creator role.

  1. In the Microsoft Purview portal, open the data catalog and select the Catalog management drop-down.

  2. Select Governance domains.

  3. Select + New Governance domain.

    Screenshot of the governance domains page, with the new governance domain button highlighted.

  4. Give your governance domain a unique name, and description.

  5. Select the governance domain Type: Functional unit, line of business, data domain, regulatory, project.

    Note

    Type is an extra descriptor to indicate your governance domain's purpose. There aren't any behavioral differences between types.

  6. Optionally select an existing domain as a parent domain. Parent/child relationships can be visualized in a tree-like hierarchy.

    Note

    Governance domain hierarchies in the Data Catalog can support as many as 200 domains, including a maximum of five levels of depth.

  7. Select Create.

  8. You'll see your governance domain in the list of domains. Other users won't be able to see this governance domain until its status is set to Published. You must also first publish your domain before you can publish business concepts within like glossary terms or data products.

Tip

For guidance on what governance domains to create in your organization, see our best practices documentation.

Manage governance domains

Note

To edit a governance domain you need the governance domain owner role.

  1. On the governance domain's details page, select Edit.

    Screenshot of a governance domain detail page with the edit button highlighted.

  2. Here you're able to edit name, description, owner, and status.

  3. Select Save to save your changes.

To add data products to a governance domain, see the data product documentation.

Note

In the event of a governance domain becoming uneditable due to owners leaving the organization, Data Governance admins will be able to add new governance domain owners in the Roles tab.

Data estate mappings

You can map your governance domains to collections in your data map to direct your stewards and data product owners to build business concepts from data assets belonging to specific collections. This mapping is meant to be recommended guidance as these Data Governance roles will require data map permissions to access the data assets.

To map your governance domain to a specific data map collection:

  1. In the Microsoft Purview portal, open the data catalog and select the Catalog management drop-down.

  2. Select Governance domains.

  3. Select the governance domain you want to map to a data map collection.

  4. Select the Data estate mappings tab.

  5. Select the drop-down and select the collection you want to associate your governance domain with.

    Note

    You will only be able to see the collections that you have access to in the data map.

  6. Select Save.

Delete governance domains

To delete a governance domain, you will need to unpublish it and delete all business concepts within it, including any sub-domains. You can then select the Delete button and proceed with deleting the governance domain.

Manage domain policies

To manage domain policies, you need data owner or data steward permissions.

  1. On your governance domain's page, select Configure access.
  2. From the policy configuration window, you're able to create and manage your access policies. For more information, see the documentation about managing access policies.

Access classic experiences in the governance domain

You can access classic glossaries, business assets or managed attributes under Classic types.

  1. In the Microsoft Purview portal, open Data Catalog.
  2. Select the Catalog management drop-down.
  3. Select Classic types.
  4. Select Glossaries or Business assets or Asset types or Managed attributes to access your classic experiences.

Next steps