All Products
Search
Document Center

DataWorks:MaxCompute table data

Last Updated:Sep 20, 2025

After you create a MaxCompute data source and bind it to the Data Development component in DataWorks, you can work with MaxCompute tables directly in Data Map. In Data Map, you can search for data, preview data, view metadata details, view data lineage, manage tables by category and group, and gain data insights. This topic describes how to view and manage MaxCompute tables in Data Map.

Prerequisites

You must create a MaxCompute data source and bind it to DataWorks Data Development. After you bind the data source, DataWorks automatically collects metadata from the engine. The system performs a one-time collection of all existing metadata and then collects incremental metadata daily. This metadata is then aggregated in Data Map. The system automatically maintains the metadata collector, and no manual management is required.

Note

If you cannot find the target table in Data Map, you can manually sync the table by choosing My Data > My Tools > Refresh Table Metadata.

Go to the Data Map page

Log on to the DataWorks console. In the top navigation bar, select the desired region. In the left-side navigation pane, choose Data Governance > Data Map. On the page that appears, click Go to Data Map.

Search for a table

In the navigation pane on the left, click the image icon to go to the table search page. You can enter a keyword, such as a table name or description, in the search box to find all tables in the data source that contain the keyword. You can also click the Fields category and enter a keyword, such as a field name or description, to search for all fields in the data source that contain the keyword. You can also filter tables by category, project, or database. For more information about how to configure categories, see Configuration management.

You can perform the following shortcut operations on search results:

  • Request permissions: Request table permissions in Security Center and view the request records in Data Map. For more information, see Request and manage table permissions.

  • Add to album: Add the current table to a data album and manage the table on the data album details page. For more information, see Manage tables from a business perspective: Data albums.

  • Add to favorites: Add a table to favorites or remove it from favorites.

  • View lineage: Click to view the lineage between tables and fields. The lineage is parsed from actual data forwarding operations, such as recurring schedules and data synchronization. Lineage generated from manual operations, such as temporary queries, is not included. For more information, see View lineage information.

  • View DDL: Click to view or copy the table creation statement in the Generate DDL Statement dialog box.

View the details of a table

In the search result list, click a table name to go to the table details page.

image.png

Feature

Description

References

Shortcut operations

In the upper part of the page, you can Request Permissions on the table, add the table to a Data Album or View An Album, Add The Table To Favorites, Generate An API in DataService Studio, or write SQL statements on the SQL Query page to query and analyze data.

Table basic information

In the Table Basic Information area, you can view the table's Number Of Views, Number Of Reads, Number Of Favorites, Lifecycle

, Approver, Health Score, Table Owner, and Table Type.

View basic table information

Table model information

View information about the current model table, such as its data warehouse layer, business category, and storage policy.

Click View Model to go to the Smart Data Modeling > Dimensional Modeling page and view the created model table. On the table editing page, you can modify table information, publish the table, view operation logs, or perform data development for the table model.

Note

Model information is displayed only for tables generated by DataWorks Smart Data Modeling.

Overview of dimensional modeling

Table permission information

View your current permissions on the table. You can click Click To View to go to the Table Permission Application page to request permissions.

Request and manage table permissions

Table technical information

View the DDL Last Modified Time, Data Last Modified Time, and Last Viewed Time.

Note

Last Viewed Time:

  • This indicates the last time the table was accessed. Access includes manually executing commands to access the table data and accessing the table data in a recurring schedule scenario.

  • This data is for reference only and may not accurately reflect the actual access time.

  • This data is collected offline and has a T+1 day latency.

-

Details

View the table's Field Information, Partition Information, and Change Records.

View details

Output information

If the table data changes periodically with its corresponding recurring task, you can click Output Information to view the runtime information of the production task. This data is collected offline and has a T+1 day latency.

-

Lineage information

View the lineage within or between engine nodes. You can also view the lineage between the engine (as a data source) and the generated data API. In addition, MaxCompute supports viewing the complete lineage based on offline synchronization. This data is collected in real time.

Note

To view the complete end-to-end lineage from the API perspective, including the upstream data source and downstream app, see View API details.

View lineage information

Usage notes

You can Edit, View Historical Versions, and View Markdown Syntax. Learn more from the business description of the data.

-

Data health

Data governance

Displays the table's governance health score, the trend of issues to be governed, and the governance items. If the table has issues to be governed, you can quickly handle them.

View data governance details

Data Quality

Displays the details of the data quality monitoring rules configured for the current table and the DQC alert list. You can click Configure Rules on the right to go to the Data Quality page and configure monitoring rules for the table.

Configure rules for a single table

Usage records

Displays the table's usage records from the frequent associations and access statistics dimensions.

  • Frequent Associations: Shows how many people are using the current table data.

  • Access Statistics: Displays the table's usage records using charts, such as the read trend chart, field references in clauses, and top readers.

View table usage records

Data preview

Preview 20 random data records from the current table.

Important
  • You need permissions to preview tables in the production environment. If you do not have permissions, see Request table permissions to apply.

  • If table preview permission is enabled in the workspace's project management configuration, you can preview data here even without applying for table query permissions in Security Center.

  • If you have configured and enabled data masking rules, they will take effect on the data preview page. For more information about how to configure data masking rules, see Create a data masking rule.

  • Data preview is not supported for MaxCompute foreign tables or MaxCompute tables that contain JSON fields.

View data preview

View basic table information

On the table details page, you can view information such as the Number Of Views, Number Of Reads, and Number Of Favorites in the Table Basic Information area on the left.

  • Views: The number of times the table details page was viewed in Data Map over the last 30 days. This data is collected offline and has a T+1 day latency.

  • Reads: The number of tasks that read the MaxCompute table from the production environment in the last 30 days. Task types include SQL, Tunnel Download, Data Integration, and DataService Studio APIs. Only the number of reads for tasks associated with scheduling is counted. Reads from tasks outside of DataWorks are not counted. This data is collected offline and has a T+1 day latency.

  • Favorites: The number of users who added the table to their favorites. This data is collected in real time.

  • Storage: The logical storage size of the table. This data is collected offline and has a T+1 day latency.

  • Health Score: The table's rating in Data Health > Data Governance > Governance Health Score. You can use this score to determine whether the table requires governance.

  • Output Task: The ID of the DataWorks recurring schedule task that writes to the current table. If the table is periodically updated but no task ID is displayed, it may be because the table is written to by a task that is not a DataWorks recurring schedule task. Contact the table owner for details. This data is collected offline and has a T+1 day latency.

    Note

    If you do not have permission to view the code of the output task, contact the administrator of the workspace where the task is located to grant you the required permissions. For more information, see Enable code and log isolation.

View details

Click Details to view the table's Field Information, Partition Information, and Change Records.

  • Field information

    You can view the table's field information. If the table is a partitioned table, you can also view the Partition Field Information.

    Operation

    Description

    Edit

    Click to edit the field's Description, Business Description, Security Level, and Primary Key. Then, Save or Cancel your changes. You can also select multiple fields to set their security level in a batch.

    Note
    • Only a Workspace Administrator or the table owner can edit table fields. To allow another user to edit table fields, grant the user the Workspace Administrator role. For more information, see Manage permissions on global-level modules.

    • The Security Level column is displayed only for tables for which field security levels are individually set.

    • You can set security levels for table fields here only after you enable the field security level feature in the MaxCompute engine. For more information about how to enable the security level feature, see Label-based access control.

    Batch Edit Security Level

    Set security levels for multiple table fields in a batch to improve data security.

    Upload

    Click and drag the local data that you want to upload to the Batch Upload Field Information dialog box.

    Note
    • Only a Workspace Administrator or the table owner can upload data to the target table. To allow another user to upload data, grant the user the Workspace Administrator role. For more information, see Manage permissions on global-level modules.

    • Only .xlsx files (Excel 2007) are supported. You can also Download A Template File.

    • This feature is not supported for model tables generated by smart modeling.

    Download

    Downloads the field information for the current table.

    Generate Select

    After you click this option, you can view or Copy the select statement for the current table in the Generate Select Statement dialog box.

    Generate DDL

    Click to view or Copy the table creation statement in the Generate DDL Statement dialog box.

    Note
    • Field popularity: This metric indicates the number of times the field was used in a join operation on the previous day. This number is converted to a star rating. The highest rating is five stars and the lowest is zero stars.

    • Associated metric: Displays the model metrics associated with the field. To create or update an association, go to the dimensional modeling page. On the editing page for the target table, manage the association between fields and metrics in the field management section. After you publish the model table, the association takes effect.

  • Partition information

    You can view the partition information of the current table, such as the Partition Name, Number Of Records, and Logical Storage Size.

    Note
    • The number of partition records and size are for reference only. Data updates may be delayed. The data on the engine side is the most accurate.

    • For a MaxCompute Transactional table, the Number Of Records cannot be viewed and is fixed at -1. To obtain the number of records, run the SELECT COUNT(*) FROM <table_name> WHERE <partition>; command.

  • Change records

    You can view the change records of the current table, such as the Change Description, Change Type, and Granularity.

    In the upper-left corner of the Change Records tab, you can select a change type from the drop-down list to view the corresponding change records.

View lineage information

Lineage information shows the relationships between tables and between fields. It is derived by parsing the actual data forwarding from operations such as recurring schedules and data synchronization. On the lineage information page, you can view the upstream and downstream of a table or field. You can also view the source of the table's raw data and the destination database to which the table data is forwarded. You can also perform an impact analysis for different lineage levels.

Note
  • The lineage feature is available only in DataWorks Standard Edition and later.

  • Table and field lineage is derived by parsing the actual data forwarding from operations such as recurring schedules. This parsing is performed in real time.

  • Lineage generated from manual operations, such as temporary queries, is not supported.

  • If Data Map cannot display the data lineage generated by executing SQL in a PyODPS node, you can manually set the relevant parameters for DataWorks scheduling in the PyODPS task code. For more information, see Develop a PyODPS 3 task and Develop a PyODPS 2 task.

  • View table lineage

    On the Table Lineage tab, you can view the lineage details of the current table. This includes:

    • You can view the number of upstream and downstream nodes for each node in the current table lineage. Hover over a table or task type to view its basic information, logs, and code.

    • Enter a keyword in the search box of the lineage graph to display all downstream nodes of the current table that contain the keyword. You can also enter @+account_name to display all downstream nodes of the current table that belong to the specified account.

    • Click image.png or image.png in the lineage graph to expand or collapse the corresponding upstream and downstream nodes.

  • View field lineage

    On the Field Lineage tab, you can view the lineage details of the target field. This includes:

    • In the Switch Field area, you can switch the field in the current table to view the corresponding field lineage graph.

    • You can view the number of upstream and downstream nodes for each node in the current field lineage. Hover over a field or task type to view its basic information, logs, and code.

    • Enter a keyword in the search box of the lineage graph to display all downstream nodes of the current field that contain the keyword. You can also enter @+account_name to display all downstream nodes of the current field that belong to the specified account.

    • Click image.png or image.png in the lineage graph to expand or collapse the corresponding upstream and downstream nodes.

  • Impact analysis

    If the table schema or data of the current table changes, all downstream nodes are affected. You can use the Impact Analysis feature to identify which downstream tables exist and predict which tables may be affected by a change. On this page, you can filter by lineage level, task type, and table type to display the downstream tables that meet the specified conditions within the analyzed lineage level. You can also download the analysis results.

    Note

    You can analyze up to 50 levels of table lineage.

View table usage records

You can view the table's Usage Records from the Frequent Associations and Access Statistics dimensions.

  • Frequent Associations: Shows the number of users who are using the current table data.

    Note

    This counts the number of times the table was used as a join condition in the last 30 days. This data is collected offline and has a T+1 day latency.

  • Access Statistics: Displays the table's usage records in charts.

    • Read Trend Chart: The line chart shows the number of reads per day, distinguishing between reads from the development and production environments. The number of field associations is related to the number of task executions and the number of times the field appears in the code. This data is collected offline and has a T+1 day latency.

      For example, if a field appears once in a task and the task is executed twice, the count is two. If a field appears twice in the code, a single task run results in a field count of two.

    • Field References In Clauses: Shows statistics on the number of times a field is used in SQL clauses, such as `where`, `select`, `join`, and `groupBy`. This data is collected offline and has a T+1 day latency.

    • Top Readers: Shows statistics on the users who read the table in SQL in the last 30 days. This includes access by tenant accounts used for scheduling and individual accounts. The read operations include using fields in `where`, `select`, `join`, and `group by` clauses. This data is collected offline and has a T+1 day latency.

View data governance details

You can view data governance details to quickly see the table's governance health score, the trend of issues that require governance, and the specific governance items. You can also quickly resolve the issues that require governance.

  • Health Score: A quantitative assessment of the table's assets in five health domains: storage, computing, development, quality, and security. The health score reflects the effectiveness of governance. A higher score indicates better governance.

  • Trend Of Issues To Be Governed: Shows the historical trend of the number of issues that require governance, which helps you better understand the table's governance history.

  • Governance Items: Shows the current list of issues that require governance. You can click an issue name in the Governance Item column or the button in the Actions column to go to Data Asset Governance > Overview > Governance Items to handle governance items.

View data preview

In data preview, you can view the details of the selected table and 20 random data records. You can also preview and analyze the table in a workbook or using SQL queries.

  • Preview in Workbook: On the data preview page, click the Preview In Workbook button. You are redirected to DataAnalysis > Workbook. A new workbook is automatically created to display the selected table's data.

  • Data Analysis: On the data preview page, click the Data Analysis button. You are redirected to DataAnalysis > SQL Query. An SQL query and analysis file is automatically created and populated with the SQL query statement for the selected table.

    After you query the current table, you can perform data insight on the query results and generate items such as a workbook or .

Request and manage table permissions

You can use DataWorks Security Center to request query and operation permissions for MaxCompute tables and view the request records in Data Map.

  • Request table permissions

    1. Go to the table details page and click Request Permission.

      image.png

      Note

      If the table is hidden, the Request Permission button is not displayed.

    2. By default, you are redirected to the Permission Application page in the new Security Center. For more information, see MaxCompute data access control.

  • Manage table permissions

    1. In the navigation pane on the left of the Data Map page, click My Data.

    2. In the navigation pane on the left, click Permission Management.

      On the Permission Management page, you can Request Function And Resource Permissions and view items on the Pending My Approval, My Requests, and Processed By Me tabs. You can set a Permission Validity Period. If the permission duration that you requested is exceeded, the system automatically revokes the permission. For more information, see View and manage permissions.

Manage MaxCompute tables

Use data albums to manage tables

You can add the current table to a data album and manage the table on the data album details page. You can also view the data albums to which the current table has been added. For more information, see Manage tables from a business perspective: Data albums.

Configure category navigation to manage tables

In the navigation pane on the left of the Data Map page, click Configuration Management > Category Management Configuration to configure category navigation for managing MaxCompute tables. For more information, see Configuration management.

References

  • If your workspace has not participated in the public preview of Data Studio (New), you can go to an ODPS SQL node to view table data.

  • If your workspace has participated in the public preview of Data Studio (New), you can go to a MaxCompute SQL node to view table data.