diff --git a/openmetadata-docs/content/menu.md b/openmetadata-docs/content/menu.md index 8a7c55ed813..a29d18bc227 100644 --- a/openmetadata-docs/content/menu.md +++ b/openmetadata-docs/content/menu.md @@ -453,6 +453,8 @@ site_menu: url: /openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-ui - category: OpenMetadata / Ingestion / Workflows/ Metadata / DBT / Ingest DBT from Workflow Config url: /openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-workflow-config + - category: OpenMetadata / Ingestion / Workflows/ Metadata / DBT / Ingest Owner from DBT + url: /openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-owner - category: OpenMetadata / Ingestion / Workflows / Usage url: /openmetadata/ingestion/workflows/usage diff --git a/openmetadata-docs/content/openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-owner.md b/openmetadata-docs/content/openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-owner.md new file mode 100644 index 00000000000..3d182ba2848 --- /dev/null +++ b/openmetadata-docs/content/openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-owner.md @@ -0,0 +1,59 @@ +--- +title: Ingest Owner from DBT +slug: /openmetadata/ingestion/workflows/metadata/dbt/ingest-dbt-owner +--- + +# Ingest Owner from DBT + +Ingest the model/table owner information from DBT `catalog.json` file into openmetadata tables. + +## Requirements + +### 1. Owner information in catalog.json file +Openmetadata fetches the owner information from the `catalog.json` file. Below is a sample `catalog.json` file node containing owner information under `node_name->metadata->owner`. + +```json +"model.jaffle_shop.customers": { + "metadata": { + "type": "BASE TABLE", + "schema": "dbt_jaffle", + "name": "customers", + "database": "dev", + "comment": null, + "owner": "openmetadata" + }, +} +``` + +### 2. Adding the user to OpenMetadata +The user which will be set as the entity owner should be created in OpenMetadata. + +Following steps shows adding a user to OpenMetadata: +1. Click on the `Users` section from homepage +click-users-page + +2. Click on the `Add Users` button +click-add-user + +3. Enter the details as shown for the user + + + +If the owner's name in `catalog.json` file is `openmetadata`, you need to enter `openmetadata@youremail.com` in the email id section of add users form as shown below. + + + +add-user-dbt + + +## Linking the Owner to the table + +After ruuning the ingestion workflow with DBT you can see the created user getting linked to the table as it's owner as it was specified in the `catalog.json` file. + +linked-user + + + +If a table already has a owner linked to it, owner from the DBT will not update the current owner. + + \ No newline at end of file diff --git a/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/add-user-dbt.png b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/add-user-dbt.png new file mode 100644 index 00000000000..dbaffd7d925 Binary files /dev/null and b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/add-user-dbt.png differ diff --git a/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/click-add-user.png b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/click-add-user.png new file mode 100644 index 00000000000..3b5cdd8b5fd Binary files /dev/null and b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/click-add-user.png differ diff --git a/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/click-users-page.png b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/click-users-page.png new file mode 100644 index 00000000000..7c84e45ed5c Binary files /dev/null and b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/click-users-page.png differ diff --git a/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/linked-user.png b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/linked-user.png new file mode 100644 index 00000000000..1e284f88103 Binary files /dev/null and b/openmetadata-docs/images/openmetadata/ingestion/workflows/metadata/ingest_dbt_owner/linked-user.png differ