Skip to content

Commit 58f88ff

Browse files
authored
Update tutorial-custom-types.md
Add info about lineage, removed Microsoft Purview Custom Types tool reference, added info about what Asset is.
1 parent 529048c commit 58f88ff

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

articles/purview/tutorial-custom-types.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,15 @@ For this tutorial you'll need:
3939
>* [Create custom type definitions](#create-definitions)
4040
>* [Initialize assets of custom types](#initialize-assets-of-custom-types)
4141
42-
## What is a *Type* in Microsoft Purview
42+
## What is an *asset* and *type* in Microsoft Purview
43+
An *asset* is a metadata element that describes a digital or physical resource. The digital or physical resources that are expected to be cataloged as assets include:
4344

44-
Microsoft Purview relies on the [Type System](https://atlas.apache.org/2.0.0/TypeSystem.html) from Apache Atlas. All metadata objects (assets) managed by Microsoft Purview (out of the box or through custom types) are modeled using type definitions. Understanding the Type System is fundamental to create new custom types in Microsoft Purview.
45+
* Data sources such as databases, files, and data feed.
46+
* Analytical models and processes.
47+
* Bussiness policies and terms.
48+
* Infrastructure like the server.
49+
50+
Microsoft Purview provides users a flexible *type system* to expand the definition of the asset to include new kinds of resources as they become relevant. Microsoft Purview relies on the [Type System](https://atlas.apache.org/2.0.0/TypeSystem.html) from Apache Atlas. All metadata objects (assets) managed by Microsoft Purview are modeled using type definitions. Understanding the Type System is fundamental to create new custom types in Microsoft Purview.
4551

4652
Essentially, a *Type* can be seen as a *Class* from Object Oriented Programming (OOP):
4753

@@ -55,8 +61,6 @@ You can see all type definitions in your Microsoft Purview account by sending a
5561
GET https://{{ENDPOINT}}/catalog/api/atlas/v2/types/typedefs
5662
```
5763

58-
Alternatively, you can use the [Microsoft Purview Custom Types Tool](https://github.com/microsoft/Purview-Custom-Types-Tool-Solution-Accelerator) to visualize all the type definitions.
59-
6064
Apache Atlas has few pre-defined system types that are commonly used as supertypes.
6165

6266
For example:
@@ -67,6 +71,8 @@ For example:
6771

6872
* **DataSet**: This type extends Referenceable and Asset. Conceptually, it can be used to represent a type that stores data. Types that extend DataSet can be expected to have a Schema. For example, a SQL table.
6973

74+
* **Lineage**: Lineage information helps one understand the origin of data and the transformations it may have gone through before arriving in a file or table. Lineage is calculated through *DataSet* and *Process*: DataSets (input of process) impact some other DataSets (output of process) through Process.
75+
7076
:::image type="content" source="./media/tutorial-custom-types/base-model-diagram.png" alt-text="Diagram showing the relationships between system types." border="false":::
7177

7278
## Example of a *Type* definition

0 commit comments

Comments
 (0)