Once you've set up a glossary, you can link terms from your glossary to your data assets in Atlan.
Linking glossary terms with your data assets can help you:
- Provide additional context for your assets to other users in your organization.
- Create common definitions once and apply them many times to multiple assets.
- Offer an abstract point for applying tags to be propagated to all linked assets — including their downstream and child assets — if propagation is enabled.
Example
If your data assets include personal information — for example, email addresses — you can link your assets to an Email Address
term to provide context to your users.
- You can define the term
Email Address
once in the glossary. - You can link the term to all the columns where an individual's email address appears.
- You can also tag the term as
PII
— and all of the linked assets will be tagged asPII
.
Link terms to your assets
🚨 Careful! You will first need to create a glossary and add terms to it before you can link terms to your assets.
To link a term to an asset:
From a term
- From the left menu on any screen, click Glossary.
- Under Glossary in the left menu, click the name of your glossary.
- Under your glossary name, click the category in which your term is nested and then click the term you would like to link to your assets.
- In the term profile, next to Overview, click Linked assets.
- Click + Link Assets to get started.
- (Optional) In the sidebar on the right, under the search bar, click an asset type to filter your assets — for example, Column.
- In the sidebar on the right, select the asset(s) to which you would like to link the term.
- At the bottom of the sidebar, click Link asset(s) to confirm your selections.
- (Optional) Under Linked Assets, next to the search bar, click the export icon to export linked assets for terms to spreadsheets.
From an asset
- From the left menu on any screen, click Assets.
- On the Assets page, select the asset to which you would like to link a term.
- Under Terms in the asset sidebar, click the + sign to add a term to your asset.
- In the dialog, expand the glossary menu and then click the term you would like to link to your assets.
- Click Save to confirm your selections.
You can now view linked assets for your glossary term! 🎉
💪 Did you know? You can also set up playbooks to automate the task of updating asset metadata, such as terms and more.
Unlink terms from your assets
To unlink a term from an asset:
From a term
- From the left menu on any screen, click Glossary.
- Under Glossary in the left menu, click the name of your glossary.
- Under your glossary name, click the category in which your term is nested and then click the term you would like to unlink from your assets.
- In the term profile, next to Overview, click Linked assets.
- (Optional) Under Linked Assets, next to the search bar, click the export icon to export linked assets for terms to spreadsheets before unlinking them.
- Under Linked assets, navigate to the asset(s) from which you would like to unlink the term.
- To the right of the asset name, click the three dots and then click Unlink asset.
From an asset
- From the left menu on any screen, click Assets.
- On the Assets page, select the asset from which you would like to unlink a term.
- Under Terms in the asset sidebar, hover over the term, and in the top right of the term popover, click the unlink button to unlink the term from the asset.
Your assets will now be unlinked from the glossary term.