Skip to content

Commit c846255

Browse files
authored
Merge pull request #189763 from whhender/catalog-updates-10
Catalog updates 10
2 parents 3dfac7a + d7d7713 commit c846255

8 files changed

+52
-50
lines changed

articles/data-catalog/data-catalog-get-started.md

Lines changed: 31 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
---
22
title: 'Quickstart: Create an Azure Data Catalog'
33
description: This quickstart describes how to create an Azure Data Catalog using the Azure portal.
4-
author: JasonWHowell
5-
ms.author: jasonh
4+
author: ChandraKavya
5+
ms.author: kchandra
66
ms.service: data-catalog
77
ms.topic: quickstart
8-
ms.date: 05/26/2020
8+
ms.date: 02/25/2022
99
ms.custom: mode-ui
1010
#Customer intent: As a user, I want to access my company's data all in one place so I can easily build reports or presentations from it.
1111
---
12+
1213
# Quickstart: Create an Azure Data Catalog via the Azure portal
1314

1415
[!INCLUDE [Azure Purview redirect](../../includes/data-catalog-use-purview.md)]
@@ -33,73 +34,67 @@ To set up Data Catalog, you must be the owner or co-owner of an Azure subscripti
3334

3435
## Create a data catalog
3536

36-
You can provision only one data catalog per organization (Azure Active Directory domain). Therefore, if the owner or co-owner of an Azure subscription who belongs to this Azure Active Directory domain has already created a catalog, then you can't create a catalog again even if you have multiple Azure subscriptions. To test whether a data catalog has been created by a user in your Azure Active Directory domain, go to the [Azure Data Catalog home page](http://azuredatacatalog.com) and verify whether you see the catalog. If a catalog has already been created for you, skip the following procedure and go to the next section.
37+
You can create only one data catalog per organization (Azure Active Directory domain). Therefore, if the owner or co-owner of an Azure subscription who belongs to this Azure Active Directory domain has already created a catalog, then you can't create a catalog again even if you have multiple Azure subscriptions. To test whether a data catalog has been created by a user in your Azure Active Directory domain, go to the [Azure Data Catalog home page](http://azuredatacatalog.com) and verify whether you see the catalog. If a catalog has already been created for you, skip the following procedure and go to the next section.
3738

3839
1. Go to the [Azure portal](https://portal.azure.com) > **Create a resource** and select **Data Catalog**.
3940

40-
![Azure Data Catalog create button](media/data-catalog-get-started/data-catalog-create.png)
41+
:::image type="content" source="media/data-catalog-get-started/data-catalog-create.png" alt-text="Data catalog resource type with the Create button selected.":::
4142

42-
2. Specify a **name** for the data catalog, the **subscription** you want to use, the **location** for the catalog, and the **pricing tier**. Then select **Create**.
43+
1. Specify a **name** for the data catalog, the **subscription** you want to use, the **location** for the catalog, and the **pricing tier**. Then select **Create**.
4344

44-
3. Go to the [Azure Data Catalog home page](http://azuredatacatalog.com) and click **Publish Data**.
45+
1. Go to the [Azure Data Catalog home page](http://azuredatacatalog.com) and select **Publish Data**.
4546

46-
![Azure Data Catalog--Publish Data button](media/data-catalog-get-started/data-catalog-publish-data.png)
47+
:::image type="content" source="media/data-catalog-get-started/data-catalog-publish-data.png" alt-text="On the data catalog homepage, the Publish Data button is selected.":::
4748

4849
You can also get to the Data Catalog home page from the [Data Catalog service page](https://azure.microsoft.com/services/data-catalog) by selecting **Get started**.
4950

50-
![Azure Data Catalog--marketing landing page](media/data-catalog-get-started/data-catalog-marketing-landing-page.png)
51+
:::image type="content" source="media/data-catalog-get-started/data-catalog-marketing-landing-page.png" alt-text="The data catalog service page, with the blue get started button at the bottom.":::
5152

52-
4. Go to the **Settings** page.
53+
1. Go to the **Settings** page.
5354

54-
![Azure Data Catalog--provision data catalog](media/data-catalog-get-started/data-catalog-create-azure-data-catalog.png)
55+
:::image type="content" source="media/data-catalog-get-started/data-catalog-create-azure-data-catalog.png" alt-text="The data catalog settings page, with several expandable options.":::
5556

56-
5. Expand **Pricing** and verify your Azure Data Catalog **edition** (Free or Standard).
57+
1. Expand **Pricing** and verify your Azure Data Catalog **edition** (Free or Standard).
5758

58-
![Azure Data Catalog--select edition](media/data-catalog-get-started/data-catalog-create-catalog-select-edition.png)
59+
:::image type="content" source="media/data-catalog-get-started/data-catalog-create-catalog-select-edition.png" alt-text="The pricing option expanded with the free edition selected.":::
5960

60-
6. If you choose *Standard* edition as your pricing tier, you can expand **Security Groups** and enable authorizing Active Directory security groups to access Data Catalog and enable automatic adjustment of billing.
61+
1. If you choose *Standard* edition as your pricing tier, you can expand **Security Groups** and enable authorizing Active Directory security groups to access Data Catalog and enable automatic adjustment of billing.
6162

62-
![Azure Data Catalog Security Groups](media/data-catalog-get-started/data-catalog-standard-security-groups.png)
63+
:::image type="content" source="media/data-catalog-get-started/data-catalog-standard-security-groups.png" alt-text="The security groups option expanded with the option to enable authorizing shown.":::
6364

64-
7. Expand **Catalog Users** and click **Add** to add users for the data catalog. You're automatically added to this group.
65+
1. Expand **Catalog Users** and select **Add** to add users for the data catalog. You're automatically added to this group.
6566

66-
![Azure Data Catalog--users](media/data-catalog-get-started/data-catalog-add-catalog-user.png)
67+
:::image type="content" source="media/data-catalog-get-started/data-catalog-add-catalog-user.png" alt-text="Catalog users expanded and the add button highlighted.":::
6768

68-
8. If you choose *Standard* edition as your pricing tier, you can expand **Glossary Administrators** and click **Add** to add glossary administrator users. You're automatically added to this group.
69+
1. If you choose *Standard* edition as your pricing tier, you can expand **Glossary Administrators** and select **Add** to add glossary administrator users. You're automatically added to this group.
6970

70-
![Azure Data Catalog Glossary Administrators](media/data-catalog-get-started/data-catalog-standard-glossary-admin.png)
71+
:::image type="content" source="media/data-catalog-get-started/data-catalog-standard-glossary-admin.png" alt-text="Glossary Administrators expanded and the add button highlighted.":::
7172

72-
9. Expand **Catalog Administrators** and click **Add** to add additional administrators for the data catalog. You're automatically added to this group.
73+
1. Expand **Catalog Administrators** and select **Add** to add other administrators for the data catalog. You're automatically added to this group.
7374

74-
![Azure Data Catalog--administrators](media/data-catalog-get-started/data-catalog-add-catalog-admins.png)
75+
:::image type="content" source="media/data-catalog-get-started/data-catalog-add-catalog-admins.png" alt-text="Catalog Administrators expanded and the add button highlighted.":::
7576

76-
10. Expand **Portal Title** and add additional text that will be displayed in the portal title.
77+
1. Expand **Portal Title** and add extra text that will be displayed in the portal title.
7778

78-
![Azure Data Catalog-Portal Title](media/data-catalog-get-started/data-catalog-portal-title.png)
79+
:::image type="content" source="media/data-catalog-get-started/data-catalog-portal-title.png" alt-text="Portal title expanded, showing the text box where optional text can be added.":::
7980

80-
11. Once you complete the **Settings** page, next navigate to the **Publish** page.
81+
1. Once you complete the **Settings** page, next navigate to the **Publish** page.
8182

82-
![Azure Data Catalog--created](media/data-catalog-get-started/data-catalog-created.png)
83+
:::image type="content" source="media/data-catalog-get-started/data-catalog-created.png" alt-text="Data Catalog home page, with the Publish tab selected in the top menu.":::
8384

8485
## Find a data catalog in the Azure portal
8586

8687
1. On a separate tab in the web browser or in a separate web browser window, go to the [Azure portal](https://portal.azure.com) and sign in with the same account that you used to create the data catalog in the previous step.
8788

88-
2. Select **All services** and then click **Data Catalog**.
89-
90-
![Azure Data Catalog--browse Azure](media/data-catalog-get-started/data-catalog-browse-azure-portal.png)
91-
92-
You see the data catalog you created.
93-
94-
![Azure Data Catalog--view catalog in list](media/data-catalog-get-started/data-catalog-azure-portal-show-catalog.png)
89+
1. Select **All services** and then select **Data Catalog**.
9590

96-
3. Click the catalog that you created. You see the **Data Catalog** blade in the portal.
91+
:::image type="content" source="media/data-catalog-get-started/data-catalog-browse-azure-portal.png" alt-text="The left Azure portal menu is open, with 'all services' selected. In the services menu, Data Catalog is selected.":::
9792

98-
![Azure Data Catalog--blade in portal](media/data-catalog-get-started/data-catalog-blade-azure-portal.png)
93+
You'll see the data catalog you created in the list. If you don't, check your subscription, resource group, location, and tag filters at the top of the search.
9994

100-
4. You can view properties of the data catalog and update them. For example, click **Pricing tier** and change the edition.
95+
1. Select the catalog that you created. You'll see the **Data Catalog** page in the portal, showing details for your Data Catalog.
10196

102-
![Azure Data Catalog--pricing tier](media/data-catalog-get-started/data-catalog-change-pricing-tier.png)
97+
1. You can view properties of the data catalog and update them. For example, you can select **Pricing tier** and change the edition.
10398

10499
## Next steps
105100

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,26 @@
11
---
22
title: Register data sources in Azure Data Catalog
33
description: This article highlights how to register data sources in Azure Data Catalog, including the metadata fields extracted during registration.
4-
author: JasonWHowell
5-
ms.author: jasonh
4+
author: ChandraKavya
5+
ms.author: kchandra
66
ms.service: data-catalog
77
ms.topic: how-to
8-
ms.date: 08/01/2019
8+
ms.date: 02/25/2022
99
---
10+
1011
# Register data sources in Azure Data Catalog
1112

1213
[!INCLUDE [Azure Purview redirect](../../includes/data-catalog-use-purview.md)]
1314

1415
## Introduction
16+
1517
Azure Data Catalog is a fully managed cloud service that serves as a system of registration and discovery for enterprise data sources. In other words, Data Catalog helps people discover, understand, and use data sources, and it helps organizations get more value from their existing data. The first step to making a data source discoverable via Data Catalog is to register that data source.
1618

1719
## Register data sources
20+
1821
Registration is the process of extracting metadata from the data source and copying that data to the Data Catalog service. The data remains where it currently resides, and it remains under the control of the administrators and policies of the current system.
1922

20-
To register a data source, do the following:
23+
To register a data source, follow these steps:
2124
1. In the Azure Data Catalog portal, start the Data Catalog data source registration tool.
2225
2. Sign in with your work or school account with the same Azure Active Directory credentials that you use to sign in to the portal.
2326
3. Select the data source you want to register.
@@ -27,29 +30,32 @@ For more step-by-step details, see the [Get Started with Azure Data Catalog](dat
2730
After you've registered the data source, the catalog tracks its location and indexes its metadata. Users can search, browse, and discover the data source, and then use its location to connect to it by using the application or tool of their choice.
2831

2932
## Supported data sources
33+
3034
For a list of currently supported data sources, see [Data Catalog DSR](data-catalog-dsr.md).
3135

3236
## Structural metadata
37+
3338
When you register a data source, the registration tool extracts information about the structure of the objects you select. This information is referred to as structural metadata.
3439

3540
For all objects, this structural metadata includes the object’s location, so that users who discover the data can use that information to connect to the object in the client tools of their choice. Other structural metadata includes object name and type, and attribute/column name and data type.
3641

3742
## Descriptive metadata
43+
3844
In addition to the core structural metadata that's extracted from the data source, the data source registration tool extracts descriptive metadata. For SQL Server Analysis Services and SQL Server Reporting Services, this metadata is taken from the Description properties exposed by these services. For SQL Server, values provided using the ms\_description extended property is extracted. For Oracle Database, the data-source registration tool extracts the COMMENTS column from the ALL\_TAB\_COMMENTS view.
3945

4046
In addition to the descriptive metadata that's extracted from the data source, users can enter descriptive metadata by using the data source registration tool. Users can add tags, and they can identify experts for the objects being registered. All this descriptive metadata is copied to the Data Catalog service along with the structural metadata.
4147

4248
## Include previews
49+
4350
By default, only metadata is extracted from data sources and copied to the Data Catalog service, but understanding a data source is often made easier when you can view a sample of the data it contains.
4451

45-
By using the Data Catalog data-source registration tool, you can include a snapshot preview of the data in each table and view that is registered. If you choose to include previews during registration, the registration tool includes up to 20 records from each table and view. This snapshot is then copied to the catalog along with the structural and descriptive metadata.
52+
You can include a snapshot preview of the data in each table and view that is registered, using the Data Catalog data-source registration tool. If you choose to include previews during registration, the registration tool includes up to 20 records from each table and view. This snapshot is then copied to the catalog along with the structural and descriptive metadata.
4653

4754
> [!NOTE]
4855
> Wide tables with a large number of columns might have fewer than 20 records included in their preview.
49-
>
50-
>
5156
5257
## Include data profiles
58+
5359
Just as including previews can provide valuable context for users who search for data sources in Data Catalog, including a data profile can make it easier to understand discovered data sources.
5460

5561
By using the Data Catalog data-source registration tool, you can include a data profile for each table and view that is registered. If you choose to include a data profile during registration, the registration tool includes aggregate statistics about the data in each table and view, including:
@@ -63,16 +69,17 @@ These statistics are then copied to the catalog along with the structural and de
6369

6470
> [!NOTE]
6571
> Text and date columns do not include average or standard deviation statistics in their data profile.
66-
>
67-
>
6872
6973
## Update registrations
70-
Registering a data source makes it discoverable in Data Catalog when you use the metadata and optional preview extracted during registration. If the data source needs to be updated in the catalog (for example, if the schema of an object has changed, tables originally excluded should be included, or you want to update the data that's included in the previews), the data source registration tool can be re-run.
74+
75+
Registering a data source makes it discoverable in Data Catalog when you use the metadata and optional preview extracted during registration. If the data source needs to be updated in the catalog (for example, if the schema of an object has changed, tables originally excluded should be included, or you want to update the data that's included in the previews), the data source registration tool can be rerun.
7176

7277
Re-registering an already-registered data source performs a merge “upsert” operation: existing objects are updated, and new objects are created. Any metadata provided by users through the Data Catalog portal are retained.
7378

7479
## Summary
75-
Because it copies structural and descriptive metadata from a data source to the catalog service, registering the data source in Data Catalog makes the data easier to discover and understand. After you have registered the data source, you can annotate, manage, and discover it by using the Data Catalog portal.
80+
81+
Because it copies structural and descriptive metadata from a data source to the catalog service, registering the data source in Data Catalog makes the data easier to discover and understand. After you've registered the data source, you can annotate, manage, and discover it by using the Data Catalog portal.
7682

7783
## Next steps
84+
7885
For more information about registering data sources, see the [Get Started with Azure Data Catalog](data-catalog-get-started.md) tutorial.

articles/data-catalog/index.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
title: Azure Data Catalog documentation
33
summary: "Learn how to set up a data catalog so your organization can find, understand, and consume data sources. Tutorials, REST API reference, and other documentation show you how to plan and set up your data repository where data consumers can discover available data sources and gain knowledge contributed by subject matter experts."
44
metadata:
5-
author: jasonwhowell
5+
author: whhender
6+
ms.author: whhender
67
description: "Learn how to set up a data catalog where your organization can find, understand, and consume data sources. Tutorials, API reference, and other documentation."
7-
ms.author: jasonh
8-
ms.date: 08/30/2019
8+
ms.date: 02/25/2022
99
ms.service: data-catalog
1010
ms.topic: landing-page
1111

-11 KB
Loading
-3.39 KB
Loading

0 commit comments

Comments
 (0)