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
Copy file name to clipboardExpand all lines: articles/data-catalog/register-data-assets-tutorial.md
+17-12Lines changed: 17 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,12 @@ In this tutorial, you use the registration tool to register data assets from the
15
15
16
16
In this tutorial, you learn how to:
17
17
> [!div class="checklist"]
18
-
> * Add data to Azure Data Catalog.
18
+
> * Register data assets
19
+
> * Search data assets
20
+
> * Annotate data assets
21
+
> * Connect to data assets
22
+
> * Manage data assets
23
+
> * Delete data assets
19
24
20
25
## Prerequisites
21
26
@@ -76,7 +81,7 @@ You can now register data assets from the Azure SQL database sample by using Azu
76
81
77
82

78
83
79
-
8. Select **REGISTER**. Azure Data Catalog registers your selected objects. In this exercise, the selected objects from your Azure SQL database sample are registered. The registration tool extracts metadata from the data asset and copies that data into the Azure Data Catalog service. The data remains where it currently stays, and it remains under the control of the administrators and policies of the current system.
84
+
8. Select **REGISTER**. Azure Data Catalog registers your selected objects. In this exercise, the selected objects from your Azure SQL database sample are registered. The registration tool extracts metadata from the data asset and copies that data into the Azure Data Catalog service. The data remains where it currently stays. Data remains under the control of the administrators and policies of the origin system.
80
85
81
86

82
87
@@ -96,9 +101,9 @@ Searching is designed to be both intuitive and powerful. By default, search term
96
101
97
102
Filtering is designed to complement searching. You can select specific characteristics such as experts, data source type, object type, and tags to view matching data assets and to constrain search results to matching assets.
98
103
99
-
By using a combination of searching and filtering, you can quickly navigate the data sources that are registered with Azure Data Catalog to discover the data assets you need.
104
+
By using a combination of searching and filtering, you can quickly navigate the data sources that are registered with Azure Data Catalog.
100
105
101
-
In this exercise, you use the Azure Data Catalog portal to discover data assets you registered in the previous exercise. See [Data Catalog Search syntax reference](https://msdn.microsoft.com/library/azure/mt267594.aspx) for details about search syntax.
106
+
In this exercise, you use the Azure Data Catalog portal to discover data assets you registered in the previous exercise. See [Data Catalog Search syntax reference](/rest/api/datacatalog/#search-syntax-reference) for details about search syntax.
102
107
103
108
Following are a few examples for discovering data assets in the catalog.
104
109
@@ -112,7 +117,7 @@ Basic search helps you search a catalog by using one or more search terms. Resul
112
117
113
118

114
119
115
-
3. Confirm that you see all four tables and the database in the results. You can switch between **grid view** and **list view** by selecting buttons on the toolbar as shown in the following image. Notice that the search keyword is highlighted in the search results because the **Highlight** option is **ON**. You can also specify the number of **results per page** in search results.
120
+
3. Confirm that you see all four tables and the database in the results. You can switch between **grid view** and **list view** by selecting buttons on the toolbar, as shown in the following image. Notice that the search keyword is highlighted in the search results because the **Highlight** option is **ON**. You can also specify the number of **results per page** in search results.
116
121
117
122

118
123
@@ -133,7 +138,7 @@ Property scoping helps you discover data assets where the search term is matched
133
138
134
139
1. Clear the **Table** filter under **Object Type** in **Filters**.
135
140
136
-
2. In the search box, enter `tags:product` and press **ENTER**. See [Data Catalog Search syntax reference](https://msdn.microsoft.com/library/azure/mt267594.aspx) for all the properties you can use for searching the data catalog.
141
+
2. In the search box, enter `tags:product` and press **ENTER**. See [Data Catalog Search syntax reference](/rest/api/datacatalog/#search-syntax-reference) for all the properties you can use for searching the data catalog.
137
142
138
143
3. Confirm that you see the tables and the database in the results.
139
144
@@ -173,11 +178,11 @@ With comparison operators, you can use comparisons other than equality for prope
173
178
174
179

175
180
176
-
See [How to discover data assets](data-catalog-how-to-discover.md) for detailed information about discovering data assets and [Data Catalog Search syntax reference](https://msdn.microsoft.com/library/azure/mt267594.aspx) for searchsyntax.
181
+
See [How to discover data assets](data-catalog-how-to-discover.md) for detailed information about discovering data assets. For more information on search syntax, see [Data Catalog Search syntax reference](/rest/api/datacatalog/#search-syntax-reference).
177
182
178
183
## Annotate data assets
179
184
180
-
In this exercise, you use the Azure Data Catalog portal to annotate (add information such as descriptions, tags, or experts) data assets you have previously registered in the catalog. The annotations supplement and enhance the structural metadata extracted from the data source during registration and make the data assets much easier to discover and understand.
185
+
In this exercise, you use the Azure Data Catalog portal to annotate (add information such as descriptions, tags, or experts) existing data assets in the catalog. The annotations supplement the structural metadata extracted from the data source during registration. Annotation makes the data assets much easier to discover and understand.
181
186
182
187
In this exercise, you annotate a single data asset (ProductPhoto). You add a friendly name and description to the ProductPhoto data asset.
183
188
@@ -189,7 +194,7 @@ In this exercise, you annotate a single data asset (ProductPhoto). You add a fri
189
194
190
195

191
196
192
-
The **Description** helps others discover and understand why and how to use the selected data asset. You can also add more tags and view columns. Now you can try searching and filtering to discover data assets by using the descriptive metadata you’ve added to the catalog.
197
+
The **Description** helps others discover and understand why and how to use the selected data asset. You can also add more tags and view columns. You can search and filter data sources by using the descriptive metadata you’ve added to the catalog.
193
198
194
199
You can also do the following steps on this page:
195
200
@@ -209,7 +214,7 @@ You can also add an annotation to multiple data assets. For example, you can sel
209
214
210
215

211
216
212
-
Azure Data Catalog supports a crowd-sourcing approach to annotations. Any Data Catalog user can add tags (user or glossary), descriptions, and other metadata, so that any user with a perspective on a data asset and its use can have that perspective captured and available to other users.
217
+
Azure Data Catalog supports a crowd-sourcing approach to annotations. Any Data Catalog user can add tags (user or glossary), descriptions, and other metadata. By doing so, users add perspective on a data asset and its use, and share that perspective with other users.
213
218
214
219
See [How to annotate data assets](data-catalog-how-to-annotate.md) for detailed information about annotating data assets.
215
220
@@ -252,13 +257,13 @@ In this exercise, you connected to data assets discovered by using Azure Data Ca
252
257
253
258

254
259
255
-
Select **View Connection Strings** to view and copy ADF.NET, ODBC, and OLEDB connection strings to the clipboard for use in your application.
260
+
Select **View Connection Strings** to view and copy ADO.NET, ODBC, and OLEDB connection strings to the clipboard for use in your application.
256
261
257
262
## Manage data assets
258
263
259
264
In this step, you see how to set up security for your data assets. Data Catalog doesn't give users access to the data itself. The owner of the data source controls data access.
260
265
261
-
You can use Data Catalog to discover data sources and to view the metadata related to the sources registered in the catalog. There may be situations, however, where data sources should only be visible to specific users or to members of specific groups. For these scenarios, you can use Data Catalog to take ownership of registered data assets within the catalog, and to then control the visibility of the assets you own.
266
+
You can use Data Catalog to discover data sources and to view the metadata related to the sources registered in the catalog. There may be situations, however, where data sources should only be visible to specific users or to members of specific groups. For these scenarios, you can use Data Catalog to take ownership of registered data assets, and control the visibility of the assets you own.
262
267
263
268
> [!NOTE]
264
269
> The management capabilities described in this exercise are available only in the Standard Edition of Azure Data Catalog, not in the Free Edition.
0 commit comments