You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -33,73 +34,67 @@ To set up Data Catalog, you must be the owner or co-owner of an Azure subscripti
33
34
34
35
## Create a data catalog
35
36
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.
37
38
38
39
1. Go to the [Azure portal](https://portal.azure.com) > **Create a resource** and select **Data Catalog**.
39
40
40
-

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.":::
41
42
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**.
43
44
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**.
45
46
46
-

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.":::
47
48
48
49
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**.
49
50
50
-

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.":::
51
52
52
-
4. Go to the **Settings** page.
53
+
1. Go to the **Settings** page.
53
54
54
-

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.":::
55
56
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).
57
58
58
-

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.":::
59
60
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.
61
62
62
-

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.":::
63
64
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.
65
66
66
-

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.":::
67
68
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.
69
70
70
-

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.":::
71
72
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.
73
74
74
-

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.":::
75
76
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.
77
78
78
-

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.":::
79
80
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.
81
82
82
-

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.":::
83
84
84
85
## Find a data catalog in the Azure portal
85
86
86
87
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.
87
88
88
-
2. Select **All services** and then click **Data Catalog**.
89
-
90
-

91
-
92
-
You see the data catalog you created.
93
-
94
-

89
+
1. Select **All services** and then select **Data Catalog**.
95
90
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.":::
97
92
98
-

93
+
You'll see the datacatalog you created in the list. If you don't, check your subscription, resource group, location, and tag filters at the top of the search.
99
94
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.
101
96
102
-

97
+
1. You can view properties of the datacatalog and update them. For example, you can select **Pricing tier** and change the edition.
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.
16
18
17
19
## Register data sources
20
+
18
21
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.
19
22
20
-
To register a data source, do the following:
23
+
To register a data source, follow these steps:
21
24
1. In the Azure Data Catalog portal, start the Data Catalog data source registration tool.
22
25
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.
23
26
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
27
30
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.
28
31
29
32
## Supported data sources
33
+
30
34
For a list of currently supported data sources, see [Data Catalog DSR](data-catalog-dsr.md).
31
35
32
36
## Structural metadata
37
+
33
38
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.
34
39
35
40
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.
36
41
37
42
## Descriptive metadata
43
+
38
44
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.
39
45
40
46
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.
41
47
42
48
## Include previews
49
+
43
50
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.
44
51
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.
46
53
47
54
> [!NOTE]
48
55
> Wide tables with a large number of columns might have fewer than 20 records included in their preview.
49
-
>
50
-
>
51
56
52
57
## Include data profiles
58
+
53
59
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.
54
60
55
61
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
63
69
64
70
> [!NOTE]
65
71
> Text and date columns do not include average or standard deviation statistics in their data profile.
66
-
>
67
-
>
68
72
69
73
## 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.
71
76
72
77
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.
73
78
74
79
## 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.
76
82
77
83
## Next steps
84
+
78
85
For more information about registering data sources, see the [Get Started with Azure Data Catalog](data-catalog-get-started.md) tutorial.
Copy file name to clipboardExpand all lines: articles/data-catalog/index.yml
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -2,10 +2,10 @@
2
2
title: Azure Data Catalog documentation
3
3
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."
4
4
metadata:
5
-
author: jasonwhowell
5
+
author: whhender
6
+
ms.author: whhender
6
7
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."
0 commit comments