All Products
Search
Document Center

DataWorks:Metadata retrieval

Last Updated:Mar 27, 2026

Data Map is DataWorks's centralized hub for discovering data assets across your organization. It combines a macro-level storage overview with two search modes — keyword search and multi-dimensional filtering — so you can locate tables, fields, and business terms quickly, whether you know exactly what you're looking for or you're exploring.

Limitations

  • AI asset types (datasets, AI models, algorithm tasks, and model services) are visible only to tenants who have created a PAI workspace.

  • Code search is available only on DataWorks Standard Edition and higher.

Access Data Map

Log on to the DataWorks console. In the top navigation bar, select a region. In the left-side navigation pane, choose Data Governance > Data Map, then click Go to Data Map.

Data overview

The data overview gives you a region-wide snapshot of all engine resources — useful for understanding storage trends and identifying high-usage projects or tables before you search.

To open it: on the Home Page of Data Map, click Data Overview next to Collect Metadata.

image

MaxCompute metrics

Metric Description
Total number of projects Total MaxCompute projects in the current region. Near-real-time.
Total number of tables Total MaxCompute tables in the current region. Offline metric with a one-day delay.
Storage Total logical storage of all tables in the region, including temporary files from scheduling tasks and storage not yet released after table deletion. Offline metric with a one-day delay.
Total APIs Total MaxCompute APIs published to API Gateway in the current region.
Storage trend chart Trend graph of total logical storage for MaxCompute projects. Includes temporary files from scheduling tasks and unreleased storage after table deletion. Offline metric with a one-day delay.
Top projects by table storage MaxCompute projects ranked by logical storage size. Offline metric with a one-day delay. Click a project to view its metadata.
Note

Project storage exceeds table storage because it includes resources, the recycle bin, and other system files.

Top tables by occupied storage MaxCompute tables ranked by size, calculated on logical storage (not physical storage). Offline metric with a T+1 day delay. Click a table to view its metadata.
Most frequently viewed tables Tables with the most page views (PV) on their Data Map details pages over the last 30 days. Near-real-time.

Other engine metrics

For non-MaxCompute engines, the overview shows the total number of databases, tables, and clusters.

Find data

Data Map provides two complementary ways to find data assets. Use keyword search when you know what you're looking for. Use the advanced search page when you want to narrow results by engine, owner, environment, or other attributes.

The Home Page also shows Recently Viewed items and the Albums Followed and Albums Managed pages for quick access to frequently used assets.

Global keyword search

  1. On the Data Map home page, find the search bar at the top.

  2. Select a metadata type, then enter keywords — table name, field name, or comment. For example: user, order, or user_info.

  3. Press Enter. The results list all matching data assets. Click any asset to view its details.

Multi-dimensional filtering and browsing

Use the advanced search page to combine filter conditions and narrow your results.

image
  1. In the left navigation pane, click the search icon image to open the advanced search page.

  2. On the left side of the page, apply one or more filter conditions:

    • Type: Select a metadata type — Table, Code, Index, API, Dataset, Workspace, and others.

    • Data Source: When Table is selected, filter by engine — for example, MaxCompute, EMR Hive, or Hologres. > Important: If the number of data sources exceeds the display limit, click More in the upper-right corner to see all available data sources.

    • Filter Conditions: Narrow results by Project, Owner, Environment, Cluster, Data Catalog, Database, and more. Available conditions vary by metadata type.

      • Tag: Filter by tags applied during data governance. Set tags on the My Data > Owned by me page or directly in the metadata details.

      • Category: Filter by business category. Configure business categories at Manage Configurations > Manage Categories. See Category Navigation Configuration for details.

Example: To find all production tables in MaxCompute owned by Zhang San, set Data Source to MaxCompute, Owner to Zhang San, and Environment to Production.

What search doesn't return

Search results exclude assets in the following situations:

  • Hidden tables: Tables in "hidden" state are invisible to all users. Tables in "project-only" state are visible only to members of the current workspace.

  • Unauthorized assets: By default, search covers only the current workspace and authorized projects. If you don't have query permissions for a table — particularly in standard mode workspaces — it won't appear in results. Contact the table owner or an administrator to request access, or confirm that you've been added as a project member.

FAQ

Why can't I find the table I'm looking for?

The most common cause is a metadata synchronization delay. After you attach a MaxCompute or Data Lake Formation (DLF) data source to DataWorks, metadata is collected automatically — but new tables or schema changes can take time to sync. Go to My Data > My Tools > Refresh Table Metadata, then search again.

If the table still doesn't appear, check these:

  • Keywords: Search matches table names, descriptions, and field names. Try a partial keyword or a different term.

  • Visibility: The table may be in "hidden" or "project-only" state. See What search doesn't return above.

  • Permissions: You may lack query permissions for the table. Contact the owner or an administrator.