Knowledge Catalog (formerly Dataplex Universal Catalog) lets you automatically ingest and maintain
up-to-date [metadata](https://docs.cloud.google.com/knowledge-catalog/docs/metadata-overview.md.txt) from
[supported Google Cloud data
sources](https://docs.cloud.google.com/knowledge-catalog/docs/metadata-overview#supported-sources). To use
Knowledge Catalog in your Google Cloud project, you must enable the
Dataplex API, Dataproc API, and Dataproc Metastore API.

## Before you begin

- [Create a Google Cloud project](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects.md.txt)
  and [enable billing](https://docs.cloud.google.com/billing/docs/how-to/manage-billing-account.md.txt). Because
  enabling APIs can incur billing, your organization might restrict who can
  enable services.

- To enable and disable the Dataplex API, you need the **Owner**
  (`roles/owner`), **Editor** (`roles/editor`), or **Service Usage Admin**
  (`roles/serviceusage.serviceUsageAdmin`) role. For more information, see
  [Manage access with IAM](https://docs.cloud.google.com/knowledge-catalog/docs/iam-and-access-control.md.txt)
  and [Enabling and disabling services](https://docs.cloud.google.com/service-usage/docs/enable-disable.md.txt).

## Enable Knowledge Catalog

You can use an existing project with Knowledge Catalog or create
a new one. We recommend that you create a new project. If you are using a new Google Cloud project or a project in which the BigQuery API is enabled, the Dataplex API is enabled by default. However, you still need to enable the Dataproc API and Dataproc Metastore API.

To keep resources created by the lake within your project, separate from one another, create a project per lake instance.

To create a project and enable Knowledge Catalog, follow these steps:

1. In the Google Cloud console, [select or create a project](https://console.cloud.google.com/cloud-resource-manager).
2. Make sure that [billing is enabled](https://docs.cloud.google.com/billing/docs/how-to/modify-project.md.txt) for your project.
3.


   Enable the Dataplex, Managed Service for Apache Spark, and Dataproc Metastore APIs, if any are not already enabled.


   **Roles required to enable APIs**


   To enable APIs, you need the `serviceusage.services.enable` permission. If you
   created the project, then you likely already have this permission through the
   Owner role (`roles/owner`). Otherwise, you can get this permission through the
   Service Usage Admin role (`roles/serviceusage.serviceUsageAdmin`).
   [Learn how to grant roles](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).

   [Enable the APIs](https://console.cloud.google.com/apis/enableflow?apiid=dataplex.googleapis.com,dataproc.googleapis.com,metastore.googleapis.com)

   > [!NOTE]
   > **Note:** The Data Lineage API is billed under the Knowledge Catalog Premium Processing SKU. If you also enable the [Data Lineage API](https://docs.cloud.google.com/knowledge-catalog/docs/about-data-lineage.md.txt), it incurs charges separately from the Dataplex API. For more information, see [Knowledge Catalog pricing](https://cloud.google.com/dataplex/pricing).

## Disable Knowledge Catalog

If you use Knowledge Catalog in a project that also uses BigQuery,
be aware of the
[effects on BigQuery behavior](https://docs.cloud.google.com/bigquery/docs/service-dependencies.md.txt)
when you disable Knowledge Catalog.

To avoid additional charges, complete the following steps before you disable
Knowledge Catalog:

1. In the Google Cloud console, delete each lake instance in your project.
   To delete a lake, you must first delete the individual assets and zones. For
   more information, see [`projects.locations.lakes.delete`](https://docs.cloud.google.com/knowledge-catalog/docs/reference/rest/v1/projects.locations.lakes/delete.md.txt).

   > [!NOTE]
   > To avoid charges, delete all Cloud Storage buckets for zones within your
   > lake. You can delete the Cloud Storage buckets before or after disabling
   > the API.
   >
   > Wait until in-progress service operations for deleting lakes complete.
   > Look for an empty list of lake instances on the Knowledge Catalog page.

2. In the Google Cloud console, delete all custom entry groups in your project. Deleting an entry group removes all entries that belong to the entry group. For more information, see [Delete an entry group](https://docs.cloud.google.com/knowledge-catalog/docs/ingest-custom-sources.md.txt#delete-entry-group).

3. Select the project to disable the Dataplex API in.

4. Go to the **Enabled APIs \& services** page.


   [Go to Enabled APIs \& services](https://console.cloud.google.com/apis/dashboard)

   <br />

5. Click **Cloud Dataplex API**.

6. Click **Disable API**. Confirm when prompted.

7. If you also enabled the Data Lineage API, repeat the steps to
   disable it. Disabling the Dataplex API does not disable the
   Data Lineage API or stop its Premium Processing charges. For more
   information, see
   [Turn off data lineage](https://docs.cloud.google.com/knowledge-catalog/docs/use-lineage.md.txt#turn-off-lineage).

## What's next

- Learn how to [search for resources](https://docs.cloud.google.com/knowledge-catalog/docs/search-assets.md.txt).
- Learn how to [measure data quality](https://docs.cloud.google.com/knowledge-catalog/docs/auto-data-quality-overview.md.txt).
- Learn about [metadata in Knowledge Catalog](https://docs.cloud.google.com/knowledge-catalog/docs/metadata-overview.md.txt).
- Follow a quickstart: [Track data lineage for a BigQuery table](https://docs.cloud.google.com/knowledge-catalog/docs/track-lineage-quickstart.md.txt).
- Try [Knowledge Catalog use cases](https://docs.cloud.google.com/knowledge-catalog/docs/use-cases).