Skip to content

Commit f8e6840

Browse files
committed
Image format and alt text
1 parent c9577a3 commit f8e6840

File tree

3 files changed

+17
-12
lines changed

3 files changed

+17
-12
lines changed

articles/purview/tutorial-custom-types.md

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ For example:
6262

6363
* **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.
6464

65-
![Base Model](./media/tutorial-custom-types/base-model-diagram.png)
65+
:::image type="content" source="./media/tutorial-custom-types/base-model-diagram.png" alt-text="Diagram showing the relationships between system types." border="false":::
6666

6767
## 2 - Example of a *Type* definition, explained
6868

@@ -132,15 +132,15 @@ Based on the JSON type definition above, let us look at some properties:
132132
133133
This field is particularly useful when browsing assets *by source type* in Purview:
134134

135-
![Browse Assets](./media/tutorial-custom-types/browse-assets.png)
135+
:::image type="content" source="./media/tutorial-custom-types/browse-assets.png" alt-text="Screenshot of the portal showing the path from Data Catalog to Browse to By source type and the asset highlighted.":::
136136

137137
* **SuperTypes** describes the *"parent"* types you want to "*inherit*" from.
138138

139139
* **schemaElementsAttributes** from **options** influences what appears in the **Schema** tab of your asset in Purview.
140140

141141
Below you can see an example of how the **Schema** tab looks like for an asset of type Azure SQL Table:
142142

143-
![Schema tab](./media/tutorial-custom-types/schema-tab.png)
143+
:::image type="content" source="./media/tutorial-custom-types/schema-tab.png" alt-text="Screenshot of the schema tab for an Azure SQL Table asset.":::
144144

145145
In our JSON above, we can see that **schemaElementsAttributes** points to the relationship attribute called **columns**, which can be seen in the **relationshipAttributeDefs** array:
146146

@@ -223,10 +223,12 @@ Below you can see a simplified JSON result:
223223
As we understood above, the information that shows up in the Schema tab of an Azure SQL Table comes from the Azure SQL Column themselves.
224224

225225
Selecting one column item, we would see the following:
226-
![Azure SQL Column](./media/tutorial-custom-types/azure-sql-column.png)
226+
227+
:::image type="content" source="./media/tutorial-custom-types/azure-sql-column.png" alt-text="Screenshot of the addressID column page with the properties tab open and the data type highlighted.":::
227228

228229
The question is, how did Purview select the *data_tye* property from the column and showed it in the Schema tab of the table?
229-
![Schema Tab Data Type](./media/tutorial-custom-types/schema-tab-data-type.png)
230+
231+
:::image type="content" source="./media/tutorial-custom-types/schema-tab-data-type.png" alt-text="Screenshot of the Azure SQL Table page with the schema page open.":::
230232

231233
You can get the type definition of an Azure SQL Column by making a `GET` request to the [endpoint](/rest/api/purview/catalogdataplane/types/get-type-definition-by-name):
232234

@@ -492,35 +494,38 @@ with the follwoing body:
492494
3. Select *By source type*.
493495
4. Select *Sample-Custom-Types*.
494496

495-
![Custom Types Objects](./media/tutorial-custom-types/custom-types-objects.png)
497+
:::image type="content" source="./media/tutorial-custom-types/custom-types-objects.png" alt-text="Screenshot showing the path from the Data Catalog to Browse assets with the filter narrowed to Sample-Custom-Types.":::
496498

497499
* Select the *First_parent_object*:
498500

499-
![First Parent Object](./media/tutorial-custom-types/first_parent_object.png)
501+
:::image type="content" source="./media/tutorial-custom-types/first-parent-object.png" alt-text="Screenshot of the First_parent_object page.":::
500502

501503
* Select the *Properties* tab:
502504

503-
![Children](./media/tutorial-custom-types/children.png)
505+
:::image type="content" source="./media/tutorial-custom-types/children.png" alt-text="Screenshot of the properties tab with the related assets highlighted, showing one child asset.":::
506+
504507
You can see the *First_child_object* being linked there.
505508

506509
* Select the *First_child_object*:
507-
![Child](./media/tutorial-custom-types/first_child_object.png)
510+
511+
:::image type="content" source="./media/tutorial-custom-types/first-child-object.png" alt-text="Screenshot of the First_child_object page, showing the overview tab.":::
508512

509513
* Select the *Properties* tab:
510-
![Parent](./media/tutorial-custom-types/parent.png)
514+
515+
:::image type="content" source="./media/tutorial-custom-types/parent.png" alt-text="Screenshot of the properties page, showing the related assets with a single parent asset.":::
511516

512517
You can see the Parent object being linked there.
513518

514519
Similarly, you can select the *Related* tab and will see the relationship between the two objects:
515520

516-
![Relationship](./media/tutorial-custom-types/relationship.png)
521+
:::image type="content" source="./media/tutorial-custom-types/relationship.png" alt-text="Screenshot of the Related tab, showing the relationship between the child and parent.":::
517522

518523
You can create multiple children by following the step 6.2 and 6.3 again.
519524

520525
>[!NOTE]
521526
>The *qualifiedName* is unique per asset, therefore, the second child should be called differently, such as: *custom//custom_type_child:Second_child_object*
522527
523-
![Two children](./media/tutorial-custom-types/two_children.png)
528+
:::image type="content" source="./media/tutorial-custom-types/two_children.png" alt-text="Screenshot of the First_parent_object, showing the two child assets highlighted.":::
524529

525530
>[!TIP]
526531
> If you delete the *First_parent_object* you will notice that the children will also be removed, due to the *COMPOSITION* relationship that we chose in the definition.

0 commit comments

Comments
 (0)