Sitemap

Apache ATLAS || Part-6

5 min readApr 21, 2025

--

If you landed at this page directly, it is recommended to go through this link first.

Press enter or click to view image in full size

Conceptual Time

Question → What is Glossary in Apache-ATLAS ?

Answer → It basically associates the business meaning to the Entities in the ATLAS.

Question → Show, what is Glossary in general sense ?

In the General Sense: “Glossary” → A glossary is a list of terms and their definitions — like a dictionary, but usually specific to a domain. For example:

Press enter or click to view image in full size

A glossary helps people across teams, projects, and companies understand the same meaning for business terms. It avoids confusion and ensures consistency. See this is how, a sample glossary looks like :-

Press enter or click to view image in full size

In Apache Atlas: “Glossary” → A Glossary in Atlas is a formal way to capture and manage business vocabulary in your Data Catalog. It lets you define:

  • Terms (example: Customer, Order, Revenue)
  • Categories (grouping of terms)
  • Relationships (link terms to data assets like Tables, Columns, Files).

Example in Atlas:

Press enter or click to view image in full size

Demo Time

Glossary

Step #1.) We create the Glossary with the name as “User” from the ATLAS-UI :-

Press enter or click to view image in full size

This is how it looks like, after it is created :-

Press enter or click to view image in full size

Category

Step #2.) Inside the Glossary, we can now create the Category.

Press enter or click to view image in full size

We wanted to create a Category named “Customer” inside this particular Glossary :-

Press enter or click to view image in full size

Let’s create another Category named “Seller” inside this same Glossary named “User” :-

Press enter or click to view image in full size

Step #3.) Inside a particular Category, we can also create the sub-categories too, but we shall not create any sub-category for now.

Press enter or click to view image in full size

Step #4.) Let’s now create another Glossary as well with name as : “Sales” :-

Press enter or click to view image in full size

Term

Step #5.) Now, we can also create the Terms, inside a particular Glossary :-

Press enter or click to view image in full size

Step #6.) We create a Term named as “CustomerName” :-

Press enter or click to view image in full size

After the Term is successfully created, here is how it looks like :-

Press enter or click to view image in full size

Assigning Category to the Term

Step #7.) We can now associate the category (Customer) to the term (CustomerName) as well :-

Press enter or click to view image in full size

After the category is being associated to the Term, here is how it looks like :-

Press enter or click to view image in full size

Adding Classification to the Term

Step #8.) We can also associate the Classification (CustomerPII) to the term (CustomerName) as well. Note below that, we have chosen the type of classification as “Propagate” which means that, this classification shall be propagated.

Press enter or click to view image in full size

After the classification is being attached to the Term, here is how it looks like :-

Press enter or click to view image in full size

Let’s also associate one more Classification (“Dimension”) to this Term (“CustomerName”) but this would not be propagated :-

Press enter or click to view image in full size

After this specific classification is being attached to this Term, here is how it looks like :-

Press enter or click to view image in full size

Adding Terms to the Entities

Step #9.) We shall now associate the Term to the existing Entities in our system.

  • Here, the “name” is one entity (i.e. Instance i.e. Object) of the Type: Column, that exists in our system.
  • We shall associate the Term to this Column.
Press enter or click to view image in full size

So far, we have only one Term named “CustomerName” and let’s associate this term to the afore-shown entity.

Press enter or click to view image in full size

Once this term (CustomerName) is assigned successfully to this Entity (name) :-

  • Below is how the view of the entity looks like.
  • Also note that, this entity have also got a propagated-classification with name as “CustomerPII”. Visit to Step #8 where we associated the classification (CustomerPII) with the Term (CustomerName).
Press enter or click to view image in full size

Ease of Search for this Entity

Step #10.) Now that, the classification (CustomerPII) exists with this entity (name), therefore it is quite easy to search from the ATLAS-UI.

Press enter or click to view image in full size

Additional Term

Step #11.) Now, let’s create a new additional Term, this time, inside the “Sales” Glossary :-

Press enter or click to view image in full size

Step #12.) We create a Term named as “salesPrice” :-

Press enter or click to view image in full size

After the Term is successfully created, here is how it looks like :-

Press enter or click to view image in full size

That’s all about the glossary in this blog that we wanted to show. If you liked reading it, please do clap on it.

--

--

aditya goel
aditya goel

Written by aditya goel

Software Engineer for Big Data distributed systems